HttpUtility.UrlPathEncode método (String, 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 _
) As String
'Uso
Dim urlToEncode As String
Dim allowHashParameter As Boolean
Dim returnValue As String

returnValue = HttpUtility.UrlPathEncode(urlToEncode, _
    allowHashParameter)

public static string UrlPathEncode(
    string urlToEncode,
    bool allowHashParameter
)

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.

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 no método UrlPathEncode(String, Boolean, Boolean) com o parâmetro encodeUnicodeCharacters definido como false.

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