XmlConvert.EncodeLocalName(String) Método

Definição

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlConvert.cs

Converte o nome em um nome XML local válido.

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

Parâmetros

name

String

O nome a ser codificado.

Retornos

String

O texto codificado.

Exemplos

O exemplo a seguir codifica e decodifica nomes.

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

Comentários

Esse método é semelhante ao EncodeName método, exceto pelo fato de codificar o caractere de dois-pontos, o que garante que o nome possa ser usado como a parte de nome local de um nome qualificado de namespace.

Por exemplo, se você passou a esse método o nome inválido a:b, ele retornará a_x003a_b, que é um nome local válido.

Se name for null ou System.String.Empty, o método retornará o mesmo valor.

Confira também

• EncodeName(String)
• DecodeName(String)