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

Article
05/05/2016

Code la partie du chemin d'accès spécifié d'une URL pour la transmission HTTP et l'ajoute au flux de sortie spécifié.

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

Syntaxe

'Déclaration
Public Shared Sub UrlPathEncode ( _
    urlToEncode As String, _
    allowHashParameter As Boolean, _
    encodeUnicodeCharacters As Boolean, _
    output As TextWriter _
)
'Utilisation
Dim urlToEncode As String
Dim allowHashParameter As Boolean
Dim encodeUnicodeCharacters As Boolean
Dim output As TextWriter

HttpUtility.UrlPathEncode(urlToEncode, _
    allowHashParameter, encodeUnicodeCharacters, _
    output)

public static void UrlPathEncode(
    string urlToEncode,
    bool allowHashParameter,
    bool encodeUnicodeCharacters,
    TextWriter output
)

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.

encodeUnicodeCharacters
Type : System.Boolean

true à coder des caractères Unicode ; dans le cas contraire, false.

output
Type : System.IO.TextWriter

Un objet TextWriter qui représente le flux de sortie à laquelle ajouter le chemin d'accès encodé. L'URL encodée ; vide si urlToEncode est vide ou null si urlToEncode est null.

Remarques

Cette méthode est un emballage sur une méthode interne pour renvoyer une URL codée sous forme de chaîne.

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