Compartir a través de


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

Codifica la parte de la ruta de acceso de una dirección URL para la transmisión HTTP.

Espacio de nombres:  Microsoft.SharePoint.Client.Utilities
Ensamblado:  Microsoft.SharePoint.Client (en Microsoft.SharePoint.Client.dll)

Sintaxis

'Declaración
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

    Una cadena que contiene la ruta de acceso.

  • allowHashParameter
    Tipo: System.Boolean

    true para especificar que la operación de descifrado puede incluir un parámetro hash; en caso contrario, false.

  • encodeUnicodeCharacters
    Tipo: System.Boolean

    true para codificar caracteres Unicode; en caso contrario, false.

Valor devuelto

Tipo: System.String
La dirección URL codificada; vacío si urlToEncode está vacío y null si urlToEncode es nulo.

Comentarios

Este método es un contenedor en un método interno para devolver una dirección URL codificada como una cadena.

Este método codifica caracteres que no pueden usarse en una dirección URL con los siguientes caracteres: controlar caracteres (0 a 31); ' '; '"'; ' %'; ' & lt;' "& gt;" \''; ' &'; y caracteres mayores que 0x7F hasta la primera '?' carácter.

Si allowHashParameter es true, se detiene en el primer carácter '#'. Solo puede usar este método al construir la dirección URL. No use este método en una dirección URL completa, como la dirección URL escrita por el usuario. Necesitará llamar HtmlUrlAttributeEncode. El carácter '#' es el marcador de posición de un marcador en una dirección URL, por lo que no se puede codificar. Sin embargo, el carácter '#' también es un carácter válido en el nombre de archivo, por lo que debe ser codificar; en caso contrario, el explorador confunden un marcador. Es posible determinar si '#' está pensada como un marcador o utilizar en un nombre de archivo, por lo que se introduce allowHashParameter para permitir que el llamador especifique si desea codificar la '#' o not.separately si desea usar el valor del atributo de dirección URL para un atributo src o de referencia . Llame al método de HtmlEncode si desea usar la dirección URL en otros tipos de atributos o entre etiquetas HTML.

El carácter '#' es el marcador de posición de un marcador en una dirección URL, por lo que no se puede codificar.  Sin embargo, el carácter '#' también es un carácter válido en el nombre de archivo, por lo que debe ser codificar; en caso contrario, el explorador confunden un marcador. Es posible determinar si '#' está pensada como un marcador o utilizar en un nombre de archivo, por lo que se introduce allowHashParameter para permitir que el llamador especifique si desea codificar '#' o no.

Vea también

Referencia

clase HttpUtility

Miembros HttpUtility

Sobrecarga UrlPathEncode

Espacio de nombres Microsoft.SharePoint.Client.Utilities