HttpUtility.UrlPathEncode - Méthode (String, Boolean)

Article
05/05/2016

Code la partie du chemin d'accès spécifié d'une URL pour la transmission HTTP.

Espace de noms : Microsoft.SharePoint.Client.Utilities
Assembly : Microsoft.SharePoint.Client (dans Microsoft.SharePoint.Client.dll)

Syntaxe

'Déclaration
Public Shared Function UrlPathEncode ( _
    urlToEncode As String, _
    allowHashParameter As Boolean _
) As String
'Utilisation
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
)

Paramètres

urlToEncode
Type : System.String

Chaîne qui contient le chemin d'accès.

allowHashParameter
Type : System.Boolean

true pour spécifier que l'opération de décodage peut inclure un paramètre hachage ; dans le cas contraire, false.

Valeur renvoyée

Type : System.String
L'URL encodée ; vide si urlToEncode est vide ou null si urlToEncode est null.

Remarques

Cette méthode est un emballage sur la méthode UrlPathEncode(String, Boolean, Boolean) avec le paramètre encodeUnicodeCharacters défini sur false.

Cette méthode code les caractères qui ne peuvent pas être utilisés dans une URL avec les caractères suivants : contrôler les caractères (0 à 31) ; ' '; '"'; ' %'; « & lt; » ' & gt ; ''\''; « & » ; et caractères supérieurs à 0x7F jusqu'à la première '?' caractère.

Si allowHashParameter est vrai, elle s'arrête au premier caractère « # ». N'utilisez cette méthode lorsque vous établissez l'URL. N'utilisez pas cette méthode sur une URL complète, par exemple une URL entrée par l'utilisateur. Vous devez toujours appeler HtmlUrlAttributeEncode. Le caractère « # » est le marqueur pour un signet dans une URL, afin qu'il ne peut pas être codé. Toutefois, le caractère « # » est également un caractère valide dans le nom du fichier, afin qu'il doit être codée ; dans le cas contraire, le navigateur s'il erreur pour un signet. Il est impossible de déterminer si le « # » est destiné à un signet ou utilisé dans un nom de fichier, afin que allowHashParameter est introduit pour permettre à l'appelant de spécifier s'il faut encoder le « # » ou not.separately si vous souhaitez utiliser la valeur de l'attribut URL d'un attribut href ou src . Appeler la méthode HtmlEncode si vous voulez utiliser l'URL dans d'autres types d'attributs ou entre des balises HTML.

Le caractère « # » est le marqueur pour un signet dans une URL, afin qu'il ne peut pas être codé. Toutefois, le caractère « # » est également un caractère valide dans le nom du fichier, afin qu'il doit être codée ; dans le cas contraire, le navigateur s'il erreur pour un signet. Il est impossible de déterminer si le « # » est destiné à un signet ou utilisé dans un nom de fichier, afin que allowHashParameter est introduit pour permettre à l'appelant de spécifier s'il faut encoder le « # » ou non.

Voir aussi

Référence

HttpUtility classe

HttpUtility - Membres

UrlPathEncode - Surcharge

Microsoft.SharePoint.Client.Utilities - Espace de noms

Partager via