XmlConvert.DecodeName(String) Methode

Definition

Decodiert einen Namen. Diese Methode ist die Umkehrung der EncodeName(String)-Methode und der EncodeLocalName(String)-Methode.

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

Parameter

name
String

Der umzuwandelnde Name.

Gibt zurück

Der decodierte Name.

Beispiele

Im folgenden Beispiel werden Namen codiert und decodiert.

#using <System.dll>
#using <System.XML.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Encode and decode a name with spaces.
   String^ name1 = XmlConvert::EncodeName( "Order Detail" );
   Console::WriteLine( "Encoded name: {0}", name1 );
   Console::WriteLine( "Decoded name: {0}", XmlConvert::DecodeName( name1 ) );
   
   // Encode and decode a local name.
   String^ name2 = XmlConvert::EncodeLocalName( "a:book" );
   Console::WriteLine( "Encoded local name: {0}", name2 );
   Console::WriteLine( "Decoded local name: {0}", XmlConvert::DecodeName( name2 ) );
}
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

Hinweise

Die Namen werden mit den folgenden Regeln decodiert:

  • Namen werden von links nach rechts decodiert.

  • Jede Sequenz _xHHHH_ (wobei HHHH für einen gültigen, vierstelligen hexadezimalen UCS-2-Code steht), der nicht decodiert wurde, wird in das entsprechende Unicode 2.1-Zeichen (Unicode 3.0, sofern von der Anwendung unterstützt) transformiert.

  • Es werden keine Shortforms erkannt. Sie werden ohne Übersetzung weitergegeben. Beispielsweise werden _x20_ oder __ nicht decodiert.

Hinweis

Die tatsächliche Codierung des Zeichens ist anwendungsspezifisch. Beispielsweise wird Order_x0020_Details zu Bestelldetails. Selbst mit Escapezeichen versehene Zeichen, die in XML-Namen ungültig sind, werden erkannt und decodiert.

Gilt für: