Språk

Uri.EscapeUriString(String) Metod

Definition

Namnområde:
System
Sammansättningar:
System.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll
Källa:
UriExt.cs
Källa:
UriExt.cs
Källa:
UriExt.cs
Källa:
UriExt.cs
Källa:
UriExt.cs

Varning

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

Varning

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

Konverterar en URI-sträng till dess undantagna representation.

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

Parametrar

stringToEscape
String

Strängen som ska fly.

Returer

String

Den förrymda representationen av stringToEscape.

Attribut
ObsoleteAttribute

Undantag

ArgumentNullException

stringToEscape är null.

UriFormatException

endast .NET Framework: Längden på stringToEscape överskrider 32766 tecken.

Kommentarer

EscapeUriString Använd metoden för att förbereda en URI-sträng som inte kapslades för att vara en parameter till Uri konstruktorn.

Som standard EscapeUriString konverterar metoden alla tecken, utom RFC 2396 oreserverade tecken, till deras hexadecimala representation. Om parsning av internationella resursidentifierare (IRI) eller internationaliserat domännamn (IDN) är aktiverat EscapeUriString konverterar metoden alla tecken, förutom RFC 3986 oreserverade tecken, till deras hexadecimala representation. Alla Unicode-tecken konverteras till UTF-8-format innan de tas bort.

Den här metoden förutsätter att stringToEscape det inte finns några escape-sekvenser i den.

Som standard är strängen undantagen enligt RFC 2396. Om international resource identifiers (IRIs) eller Internationalized Domain Name (IDN) parsning är aktiverad, är strängen undantagen enligt RFC 3986 och RFC 3987. Se dessa RFC:er för en definition av reserverade och oreserverade tecken.

Mer information om IRI-stöd finns i avsnittet Anmärkningar för Uri klassen.

Gäller för