Uri.EscapeUriString(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Achtung
Uri.EscapeUriString can corrupt the Uri string in some cases. Consider using Uri.EscapeDataString for query string components.
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);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);[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);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[<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 -> stringPublic Shared Function EscapeUriString (stringToEscape As String) As StringParameter
- stringToEscape
- String
Die Zeichenfolge, die mit Escapezeichen versehen werden soll.
Gibt zurück
Die Darstellung von stringToEscape mit Escapezeichen.
- Attribute
Ausnahmen
stringToEscape ist null.
Die Länge von stringToEscape überschreitet 32766 Zeichen.
Note: In <a href="https://learn.microsoft.com/previous-versions/br230232(v=vs.110)">.NET for Windows Store apps</a> or the <a href="https://learn.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.
