XmlConvert.DecodeName(String) Método

Definição

Decifra um nome. Este método faz o oposto dos EncodeName(String) métodos and EncodeLocalName(String) .

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

Parâmetros

name
String

O nome a transformar.

Devoluções

O nome decifrado.

Exemplos

O exemplo seguinte 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

Observações

Os nomes são decodificados usando as seguintes regras:

  • Os nomes são decifrados da esquerda para a direita.

  • Qualquer sequência _xHHHH_ (onde HHHH representa um código UCS-2 hexadecimal válido de quatro dígitos) que não tenha sido decodificada é transformada no correspondente carácter Unicode 2.1 (Unicode 3.0 se suportado pela aplicação).

  • Não são reconhecidas formas curtas. São transmitidos sem tradução. Por exemplo, _x20_ ou __ não são decodificados.

Note

A codificação real do carácter é específica da aplicação. Por exemplo, Order_x0020_Details torna-se Detalhes da Ordem. Mesmo caracteres escapados que são inválidos em nomes XML serão reconhecidos e decodificados.

Aplica-se a