Partager via


XmlConvert.EncodeLocalName(String) Méthode

Définition

Convertit le nom en un nom local XML valide.

public:
 static System::String ^ EncodeLocalName(System::String ^ name);
public static string EncodeLocalName(string name);
public static string? EncodeLocalName(string? name);
static member EncodeLocalName : string -> string
Public Shared Function EncodeLocalName (name As String) As String

Paramètres

name
String

Nom à encoder.

Retours

Nom encodé.

Exemples

L’exemple suivant encode et décode les noms.

using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {

     // Encode and decode a name with spaces.
     string name1 = XmlConvert.EncodeName("Order Detail");
     Console.WriteLine("Encoded name: " + name1);
     Console.WriteLine("Decoded name: " + XmlConvert.DecodeName(name1));

     // Encode and decode a local name.
     string name2 = XmlConvert.EncodeLocalName("a:book");
     Console.WriteLine("Encoded local name: " + name2);
     Console.WriteLine("Decoded local name: " + XmlConvert.DecodeName(name2));
  }
}
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

     ' Encode and decode a name with spaces.
     Dim name1 as string = XmlConvert.EncodeName("Order Detail")
     Console.WriteLine("Encoded name: " + name1)
     Console.WriteLine("Decoded name: " + XmlConvert.DecodeName(name1))

     ' Encode and decode a local name.
     Dim name2 as string= XmlConvert.EncodeLocalName("a:book")
     Console.WriteLine("Encoded local name: " + name2)
     Console.WriteLine("Decoded local name: " + XmlConvert.DecodeName(name2))

  end sub
end class

Remarques

Cette méthode est similaire à la EncodeName méthode, sauf qu’elle encode le caractère deux-points, ce qui garantit que le nom peut être utilisé comme partie de nom local d’un nom qualifié d’espace de noms.

Par exemple, si vous avez transmis à cette méthode le nom non valide a:b, elle retourne a_x003a_b, qui est un nom local valide.

Si name a la valeur null ou System.String.Empty, la méthode retourne la même valeur.

S’applique à

Voir aussi