SocketsHttpHandler.RequestHeaderEncodingSelector Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um retorno de chamada que seleciona os valores de Encoding cabeçalho de solicitação para codificar.
public:
property System::Net::Http::HeaderEncodingSelector<System::Net::Http::HttpRequestMessage ^> ^ RequestHeaderEncodingSelector { System::Net::Http::HeaderEncodingSelector<System::Net::Http::HttpRequestMessage ^> ^ get(); void set(System::Net::Http::HeaderEncodingSelector<System::Net::Http::HttpRequestMessage ^> ^ value); };
public System.Net.Http.HeaderEncodingSelector<System.Net.Http.HttpRequestMessage>? RequestHeaderEncodingSelector { get; set; }
member this.RequestHeaderEncodingSelector : System.Net.Http.HeaderEncodingSelector<System.Net.Http.HttpRequestMessage> with get, set
Public Property RequestHeaderEncodingSelector As HeaderEncodingSelector(Of HttpRequestMessage)
Valor da propriedade
O retorno de chamada do seletor de codificação de cabeçalho que seleciona o Encoding valor para codificar o valor do nome do cabeçalho de solicitação especificado ou null para indicar o comportamento padrão.
Exceções
Uma operação já foi iniciada na instância atual.
A instância atual foi descartada.
Comentários
Ao especificar uma codificação, geralmente é esperado que você use um dos seguintes esquemas de codificação: ASCII, Latin1ou UTF8. Outros esquemas de codificação podem ser suscetíveis a solicitar ataques de contrabando.
Cuidado
Os esquemas de codificação de vários bytes corrigidos em particular (por exemplo, Unicode ou UTF32) nunca devem ser usados, pois sua representação binária provavelmente será mal interpretada e quebrará o protocolo. Por exemplo, parte pode ✊ ser interpretada como uma nova linha (\n) que encerra o valor do cabeçalho.
Quando você especifica uma codificação, é sua responsabilidade garantir que os valores sejam representáveis por meio da codificação e que o servidor concorde com a codificação usada. Caso contrário, os valores ficarão corrompidos. Por exemplo, como qualquer conjunto de bytes é considerado uma sequência latin1 válida, um servidor que responde com valores de cabeçalho codificados em UTF-8 pode ver suas respostas silenciosamente corrompidas.