Agregar encabezados HttpClient genera una FormatException con algunos valores

A su pregunta "por qué es necesario todo esto (análisis y validación)", la respuesta es: está definido en el estándar HTTP.

En HTTP/1.1 y RFC2617, el valor de un encabezado de autenticación (como WWW-Authenticate y Authorization) tiene dos partes: una parte de esquema y una parte de parámetro.

Para la autenticación básica HTTP, el esquema es "Básico", y el parámetro puede ser algo así como "QWxhZGRpbjpvcGVuIHNlc2FtZQ==" , por lo que la cabecera entera se convierte en:

Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Es por eso que su "clave=XXX" no pasa la validación, porque carece de una parte de scheme.

Sorteé esta excepción (mi FormatException causada por comas en el valor) configurando el encabezado Authorization de la siguiente manera:

var authenticationHeaderValue = new AuthenticationHeaderValue("some scheme", "some value");
client.DefaultRequestHeaders.Authorization = authenticationHeaderValue;

He estado pasando por algunas preguntas esta mañana mientras se trata de una API externa que no sigue la especificación HTTP al pie de la letra.

Como parte de mi publicación, quieren los Content-Type y Content-Disposition, que no se pueden agregar al objeto HttpClient. Para agregar esas cabeceras, necesita crear un HttpRequestMessage. Allí, necesita agregar las cabeceras a la propiedad Content.

private HttpRequestMessage GetPostMessage(string uri, string contentType,
                                          string fileName, Stream content)
{    
    var request = new HttpRequestMessage
    {
        Content = new StreamContent(content),
        RequestUri = new Uri(uri),
        Method = HttpMethod.Post
    };

    // contentType = "video/mp4"
    request.Content.Headers.ContentType = new MediaTypeHeaderValue(contentType);

    //Need TryAddWithoutValidation because of the equals sign in the value.
    request.Content
           .Headers
           .TryAddWithoutValidation("Content-Disposition",
                                    $"attachment; filename=\"{Path.GetFileName(fileName)}\"");

    // If there is no equals sign in your content disposition, this will work:
    // request.Content.Headers.ContentDisposition = 
    //    new ContentDispositionHeaderValue($"attachment; \"{Path.GetFileName(fileName)}\"");

    return request;
}

En mi caso estoy generando valores de cadena ETags a partir de un campo SQL byte [] RowVersion. Así que necesito agregar wrap el generado. es decir, AAAAAAAAF5s = cadena dentro de " de la siguiente manera...

        var eTag = department.RowVersion.ToETagString();

        httpClient.DefaultRequestHeaders.Add(Microsoft.Net.Http.Headers.HeaderNames.IfMatch, $"\"{eTag}\"")


    public class DepartmentForHandleDto
    {
        public string Name { get; set; }
        public string GroupName { get; set; }
        public byte[] RowVersion { get; set; }
    }

    public static class ByteArrayExtensions
    {
        public static string ToETagString(this byte[] byteArray)
        {
            return Convert.ToBase64String(byteArray != null && byteArray.Length > 0 ? byteArray : new byte[8]);                    
        }
    }