Uri.EscapeUriString(String) Método

Definição

Espaço de Nomes:
System
Assemblagens:
System.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll
Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs

Atenção

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

Atenção

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

Converte uma cadeia de URI para a sua representação escapada.

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

O fio para escapar.

Devoluções

String

A representação escapada de stringToEscape.

Atributos
ObsoleteAttribute

Exceções

ArgumentNullException

stringToEscape é null.

UriFormatException

.NET Apenas Framework: O comprimento de stringToEscape excede 32766 caracteres.

Observações

Use o EscapeUriString método para preparar uma cadeia de URI não escapada para ser um parâmetro para o Uri construtor.

Por defeito, o EscapeUriString método converte todos os caracteres, exceto os caracteres não reservados RFC 2396, para a sua representação hexadecimal. Se a análise sintática de Identificadores Internacionais de Recursos (IRIs) ou de Nomes de Domínio Internacionalizados (IDN) estiver ativada, o EscapeUriString método converte todos os caracteres, exceto os caracteres não reservados do RFC 3986, para a sua representação hexadecimal. Todos os caracteres Unicode são convertidos para o formato UTF-8 antes de serem escapados.

Este método assume que stringToEscape não tem sequências de escape.

Por defeito, a cadeia é escapada de acordo com o RFC 2396. Se a análise dos Identificadores Internacionais de Recursos (IRIs) ou do Nome de Domínio Internacionalizado (IDN) estiver ativada, a cadeia é escapada de acordo com o RFC 3986 e o RFC 3987. Consulte estes RFCs para uma definição de caracteres reservados e não reservados.

Para mais informações sobre o apoio ao IRI, consulte a secção de Observações da Uri disciplina.

Aplica-se a