HttpUtility.UrlPathEncode método (String, Boolean, Boolean)

Artigo
05/11/2016

Codifica a parte do caminho especificado de URL de transmissão HTTP.

Namespace: Microsoft.SharePoint.Client.Utilities
Assembly: Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)

Sintaxe

'Declaração
Public Shared Function UrlPathEncode ( _
    urlToEncode As String, _
    allowHashParameter As Boolean, _
    encodeUnicodeCharacters As Boolean _
) As String
'Uso
Dim urlToEncode As String
Dim allowHashParameter As Boolean
Dim encodeUnicodeCharacters As Boolean
Dim returnValue As String

returnValue = HttpUtility.UrlPathEncode(urlToEncode, _
    allowHashParameter, encodeUnicodeCharacters)

public static string UrlPathEncode(
    string urlToEncode,
    bool allowHashParameter,
    bool encodeUnicodeCharacters
)

Parâmetros

urlToEncode
Tipo: System.String

Uma cadeia de caracteres que contém o caminho.

allowHashParameter
Tipo: System.Boolean

true para especificar que a operação de decodificar pode incluir um parâmetro de hash; Caso contrário, false.

encodeUnicodeCharacters
Tipo: System.Boolean

true para codificar caracteres Unicode; Caso contrário, false.

Valor retornado

Tipo: System.String
A URL codificada; vazio se urlToEncode for vazio e nulo se urlToEncode é nulo.

Comentários

Esse método é uma embalagem em um método interno para retornar uma URL codificada como uma cadeia de caracteres.

Este método codifica caracteres que não podem ser usados em uma URL com os seguintes caracteres: controlar caracteres (0 a 31); ' '; '"'; ' %'; ' & lt;' ' & gt; ' \''; ' &'; e caracteres maiores que 0x7F até o primeiro '?' caractere.

Se allowHashParameter for verdadeiro, parar no primeiro caractere '#'. Use somente este método quando você constrói a URL. Não use esse método em uma URL completa, como uma URL digitada pelo usuário. Você ainda precisa chamar HtmlUrlAttributeEncode. O caractere '#' é o marcador para um indicador em uma URL, portanto, ela não pode ser codificada. No entanto, o caractere '#' também é um caractere válido no nome do arquivo, para que ela deve ser codificada; Caso contrário, o navegador irá confunda com um indicador. É impossível determinar se o '#' é serve como um indicador ou utilizados em um nome de arquivo para allowHashParameter é introduzido para permitir que o chamador Especifique se deseja codificar a '#' ou not.separately se você quiser usar o valor de atributo de URL para um atributo href ou src . Chame o método de HtmlEncode se você quiser usar a URL em outros tipos de atributos ou entre marcas HTML.

O caractere '#' é o marcador para um indicador em uma URL, portanto, ela não pode ser codificada. No entanto, o caractere '#' também é um caractere válido no nome do arquivo, para que ela deve ser codificada; Caso contrário, o navegador irá confunda com um indicador. É impossível determinar se o '#' é serve como um indicador ou utilizados em um nome de arquivo para allowHashParameter é introduzido para permitir que o chamador Especifique se deseja codificar o '#' ou não.

Ver também

Referência

HttpUtility classe

HttpUtility membros

UrlPathEncode em sobrecarga

Microsoft.SharePoint.Client.Utilities namespace

Compartilhar via