Freigeben über


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

Definition

Codiert einen Headernamen und einen 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 Name des zu codierenden HTTP-Headers.

headerValue
String

Der Wert des zu codierenden HTTP-Headers.

encodedHeaderName
String

Enthält nach dem Beenden dieser Methode den codierten Namen, der für einen HTTP-Header verwendet werden soll. Dieser Parameter wird nicht initialisiert übergeben.

encodedHeaderValue
String

Enthält nach dem Beenden dieser Methode den codierten Wert, der für einen HTTP-Header verwendet werden soll. Dieser Parameter wird nicht initialisiert übergeben.

Hinweise

Die HeaderNameValueEncode -Methode nimmt Eingabe Zeichenfolgen aus den headerName headerValue Parametern und an und codiert Sie. Die codierten Werte werden als out-Parameter zurückgegeben.

Die HeaderNameValueEncode -Methode verwendet die folgende Logik, um Header Namen und-Werte zu codieren:

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

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

  • Das ASCII-Zeichen 127 wird als codiert %7F .

  • Alle anderen Zeichen sind nicht codiert.

    Hinweis

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

Die Standard Implementierung der- HeaderNameValueEncode Methode gibt den Wert von headerValue in zurück, encodedHeaderValue Wenn headerValue ist null oder eine leere Zeichenfolge ist. Entsprechend gibt die Standard Implementierung den Wert von in zurück, headerName encodedHeaderName Wenn headerName ist null oder eine leere Zeichenfolge ist.

Gilt für