HttpEncoder.HeaderNameValueEncode(String, String, String, String) Methode

Definition

Namespace:
System.Web.Util
Assemblys:
System.Web.dll, System.Web.Services.dll

Codiert einen Headernamen und -wert in eine Zeichenfolge, die als HTTP-Header verwendet werden kann.

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)

Parameter

headerName
String

Der zu codierenden HTTP-Headername.

headerValue
String

Der zu codierenden HTTP-Headerwert.

encodedHeaderName
String

Wenn diese Methode zurückgegeben wird, enthält sie den codierten Namen, der für einen HTTP-Header verwendet werden soll. Dieser Parameter wird nicht initialisiert übergeben.

encodedHeaderValue
String

Wenn diese Methode zurückgegeben wird, enthält sie den codierten Wert, der für einen HTTP-Header verwendet werden soll. Dieser Parameter wird nicht initialisiert übergeben.

Hinweise

Die HeaderNameValueEncode Methode verwendet Eingabezeichenfolgen aus den headerName parametern und headerValue codiert sie. Die codierten Werte werden als Ausgabeparameter zurückgegeben.

Die HeaderNameValueEncode Methode verwendet die folgende Logik, um Headernamen und Werte zu codieren:

  • Alle Zeichen, deren Unicode-Wert kleiner als ASCII-Zeichen 32 ist, außer ASCII-Zeichen 9, sind URL-codiert in einem Format, %NN in dem die N Zeichen hexadezimale Werte darstellen.

  • ASCII-Zeichen 9 (das horizontale Tabstoppzeichen) ist nicht URL-codiert.

  • ASCII-Zeichen 127 ist codiert als %7F.

  • Alle anderen Zeichen sind nicht codiert.

    Note

    Obwohl diese Methode für Unicode-Werte verwendet werden kann, wird sie in der Regel für Werte im ASCII-Bereich verwendet.

Die Standardimplementierung der HeaderNameValueEncode Methode gibt den Wert von headerValue in encodedHeaderValue if headerValue is null or is an empty string zurück. Entsprechend gibt die Standardimplementierung den Wert von headerName "in encodedHeaderName " zurück, wenn headerName es null sich um eine leere Zeichenfolge handelt oder ist.

Gilt für: