Uri.EscapeUriString(String) Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Quelle:

UriExt.cs

Achtung

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

Konvertiert eine URI-Zeichenfolge in eine Darstellung mit Escapezeichen.

public:
 static System::String ^ EscapeUriString(System::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 instead.", 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 versehen werden soll.

Gibt zurück

String

Die Darstellung von stringToEscape mit Escapezeichen.

Attribute

ObsoleteAttribute

Ausnahmen

ArgumentNullException

stringToEscape ist null.

UriFormatException

Die Länge von stringToEscape überschreitet 32766 Zeichen.

    Note: In <a href="https://docs.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://docs.microsoft.com/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library">Portable Class Library</a>, catch the base class exception, <xref data-throw-if-not-resolved="true" uid="System.FormatException"></xref>, instead.

Hinweise

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

Standardmäßig konvertiert die EscapeUriString Methode alle Zeichen mit Ausnahme von RFC 2396 ohne Vorbehalte in ihre hexadezimale Darstellung. Wenn die Analyse von internationalen Ressourcenbezeichnern (IRIs) oder internationalisierten Domänennamen (Internationalized Domain Name, IDN) aktiviert ist, konvertiert die EscapeUriString Methode alle Zeichen mit Ausnahme von nicht reservierten RFC 3986-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 enthalten sind.

Standardmäßig wird die Zeichenfolge gemäß RFC 2396 mit Escapezeichen versehen. Wenn die Analyse internationaler Ressourcenbezeichner (IrIs) oder internationalisierter Domänennamen (Internationalized Domain Name, IDN) aktiviert ist, wird die Zeichenfolge gemäß RFC 3986 und RFC 3987 mit Escapezeichen versehen. Eine Definition von reservierten und nicht reservierten Zeichen finden Sie in diesen RFCs.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt Hinweise für die Uri Klasse.