XmlConvert.EncodeLocalName(String) Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
netstandard.dll

Convertit le nom en nom local XML valide.

public:
 static System::String ^ EncodeLocalName(System::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

String

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 passé cette méthode le nom non valide a :b, elle retourne a_x003a_b, qui est un nom local valide.

Si name c’est null le cas ou System.String.Empty, la méthode retourne la même valeur.

S’applique à

Voir aussi