HttpEncoder.HeaderNameValueEncode(String, String, String, String) Méthode

Définition

Espace de noms:

System.Web.Util

Assemblys:

System.Web.dll, System.Web.Services.dll

Encode un nom et une valeur d'en-tête dans une chaîne qui peut être utilisée comme en-tête HTTP.

protected public:
 virtual void HeaderNameValueEncode(System::String ^ headerName, System::String ^ headerValue, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderName, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderValue);

protected internal virtual void HeaderNameValueEncode(string headerName, string headerValue, out string encodedHeaderName, out string encodedHeaderValue);

abstract member HeaderNameValueEncode : string * string * string * string -> unit
override this.HeaderNameValueEncode : string * string * string * string -> unit

Protected Friend Overridable Sub HeaderNameValueEncode (headerName As String, headerValue As String, ByRef encodedHeaderName As String, ByRef encodedHeaderValue As String)

Paramètres

headerName

String

Nom d'en-tête HTTP à encoder.

headerValue

String

Valeur d'en-tête HTTP à encoder.

encodedHeaderName

String

Lorsque cette méthode est retournée, contient le nom encodé à utiliser pour un en-tête HTTP. Ce paramètre est passé sans être initialisé.

encodedHeaderValue

String

Lorsque cette méthode est retournée, contient la valeur encodée à utiliser pour un en-tête HTTP. Ce paramètre est passé sans être initialisé.

Remarques

La HeaderNameValueEncode méthode prend les chaînes d’entrée des headerName paramètres et et headerValue les encode. Les valeurs encodées sont retournées en tant que paramètres sortants.

La HeaderNameValueEncode méthode utilise la logique suivante pour encoder des noms d’en-tête et des valeurs :

• Tous les caractères dont la valeur Unicode est inférieure au caractère ASCII 32, à l’exception du caractère ASCII 9, sont codés en URL dans un format de %NN où les caractères représentent des N valeurs hexadécimales.

• Le caractère ASCII 9 (caractère de tabulation horizontal) n’est pas encodé en URL.

• Le caractère ASCII 127 est encodé en tant que %7F.

• Tous les autres caractères ne sont pas encodés.

  Notes

  Bien que cette méthode puisse être utilisée pour les valeurs Unicode, elle est généralement utilisée pour les valeurs de la plage ASCII.

L’implémentation par défaut de la HeaderNameValueEncode méthode retourne la valeur de headerValue dans encodedHeaderValue si headerValue est null ou est une chaîne vide. De même, l’implémentation par défaut retourne la valeur de headerName dans encodedHeaderName si headerName est null ou est une chaîne vide.