Uri.EscapeUriString(String) Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cuidado

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

Cuidado

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

Converte uma cadeia de caracteres de URI para 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.", 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 -> string

Public Shared Function EscapeUriString (stringToEscape As String) As String

Parâmetros

stringToEscape: String

A cadeia de caracteres a ser escapada.

Retornos

String

A representação de escape de stringToEscape.

Atributos: ObsoleteAttribute

Exceções

ArgumentNullException

stringToEscape é null.

UriFormatException

O tamanho de stringToEscape excede 32766 caracteres.

Observação: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, pegue a exceção de classe base, FormatExceptionem vez disso.

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 caracteres RFC 2396 sem reservas, em sua representação hexadecimal. Se a análise de IRIs (Identificadores de Recursos Internacionais) ou IDN (Nome de Domínio Internacionalizado) 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 (Identificadores de Recursos Internacionais) ou IDN (Nome de Domínio Internacionalizado) estiver habilitada, a cadeia de caracteres será escapada de acordo com RFC 3986 e RFC 3987. Consulte essas RFCs para obter uma definição de caracteres reservados e sem reservas.

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

Aplica-se a