Uri.EscapeUriString(String) Methode

Definition

Namespace:
System
Assemblys:
System.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
UriExt.cs
Quelle:
UriExt.cs
Quelle:
UriExt.cs
Quelle:
UriExt.cs
Quelle:
UriExt.cs

Achtung

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.

Achtung

Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.

Konvertiert eine URI-Zeichenfolge in die Escapedarstellung.

public:
 static System::String ^ EscapeUriString(System::String ^ stringToEscape);
public static string EscapeUriString(string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString(string stringToEscape);
[System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static string EscapeUriString(string stringToEscape);
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components instead.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
[<System.Obsolete("Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.", DiagnosticId="SYSLIB0013", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member EscapeUriString : string -> string
Public Shared Function EscapeUriString (stringToEscape As String) As String

Parameter

stringToEscape
String

Die Zeichenfolge, die mit Escapezeichen verwendet werden soll.

Gibt zurück

String

Die Escapedarstellung von stringToEscape.

Attribute
ObsoleteAttribute

Ausnahmen

ArgumentNullException

stringToEscape ist null.

UriFormatException

nur .NET Framework: Die Länge von stringToEscape überschreitet 32766 Zeichen.

Hinweise

Verwenden Sie die EscapeUriString Methode, um eine nicht gescapete URI-Zeichenfolge als Parameter für den Uri Konstruktor vorzubereiten.

Standardmäßig konvertiert die EscapeUriString Methode alle Zeichen außer RFC 2396 nicht reservierten Zeichen in ihre hexadezimale Darstellung. Wenn die Analyse von INTERNATIONAL Resource Identifiers (IRIs) oder Internationalized Domain Name (IDN) aktiviert ist, konvertiert die EscapeUriString Methode alle Zeichen, mit Ausnahme von RFC 3986 nicht reservierten Zeichen, in ihre hexadezimale Darstellung. Alle Unicode-Zeichen werden vor dem Escapezeichen in das UTF-8-Format konvertiert.

Bei dieser Methode wird davon ausgegangen, dass stringToEscape keine Escapesequenzen darin vorhanden sind.

Standardmäßig wird die Zeichenfolge gemäß RFC 2396 escaped. Wenn die Analyse von International Resource Identifiers (IRIs) oder Internationalized Domain Name (IDN) aktiviert ist, wird die Zeichenfolge gemäß RFC 3986 und RFC 3987 escaped. Eine Definition reservierter und nicht reservierter Zeichen finden Sie in diesen RFCs.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" für den Uri Kurs.

Gilt für: