Uri.EscapeUriString(String) Método

Definição

Namespace:
System
Assemblies:
System.dll, System.Runtime.dll
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs

Cuidado

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

Cuidado

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

Converte uma cadeia de caracteres de URI em sua representação de escape.

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

Parâmetros

stringToEscape
String

A cadeia de caracteres que terá um escape.

Retornos

String

A representação escapada de stringToEscape.

Atributos
ObsoleteAttribute

Exceções

ArgumentNullException

stringToEscape é null.

UriFormatException

somente .NET Framework: o comprimento de stringToEscape excede 32766 caracteres.

Comentários

Use o EscapeUriString método para preparar uma cadeia de caracteres de URI sem escape para ser um parâmetro para o Uri construtor.

Por padrão, o EscapeUriString método converte todos os caracteres, exceto rfc 2396 caracteres sem reservas, em sua representação hexadecimal. Se a análise de IRIs (International Resource Identifiers) ou IDN (Internationalized Domain Name) estiver habilitada, o EscapeUriString método converterá todos os caracteres, exceto os caracteres rfc 3986 sem reservas, em sua representação hexadecimal. Todos os caracteres Unicode são convertidos no formato UTF-8 antes de serem escapados.

Esse método pressupõe que stringToEscape não tenha sequências de escape.

Por padrão, a cadeia de caracteres é escapada de acordo com o RFC 2396. Se a análise de IRIs (International Resource Identifiers) ou IDN (Internationalized Domain Name) estiver habilitada, a cadeia de caracteres será escapada de acordo com RFC 3986 e RFC 3987. Consulte estes RFCs para obter uma definição de caracteres reservados e não reservados.

Para obter mais informações sobre o suporte a IRI, consulte a seção Comentários da Uri classe.

Aplica-se a