HttpEncoder.HeaderNameValueEncode(String, String, String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitProtected 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
%NNoù les caractères représentent desNvaleurs 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.
