Freigeben über


XmlConvert.DecodeName-Methode

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

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Shared Function DecodeName ( _
    name As String _
) As String
'Usage
Dim name As String
Dim returnValue As String

returnValue = XmlConvert.DecodeName(name)
public static string DecodeName (
    string name
)
public:
static String^ DecodeName (
    String^ name
)
public static String DecodeName (
    String name
)
public static function DecodeName (
    name : String
) : String

Parameter

  • name
    Der umzuwandelnde Name.

Rückgabewert

Der decodierte Name.

Hinweise

Die Namen werden nach folgenden Regeln decodiert:

  • Namen werden von links nach rechts decodiert.

  • Jede nicht decodierte Sequenz _x HHHH_ (wobei HHHH für gültigen vierstelligen UCS-2-Hexadezimalcode steht) wird in das entsprechende Unicode 2.1-Zeichen umgewandelt (bzw. in Unicode 3.0-Zeichen, sofern von der Anwendung unterstützt).

  • Kurzformen werden nicht erkannt. Diese werden ohne Übersetzung übergeben. Beispielsweise wird _x20_ oder __ nicht decodiert.

Hinweis

Die tatsächliche Codierung eines Zeichens ist anwendungsspezifisch. Order_x0020_Details wird z. B. zu Order Details. Sogar Escapezeichen, die in XML-Namen ungültig sind, werden erkannt und decodiert.

Beispiel

Im folgenden Beispiel werden Namen codiert und decodiert.

Imports System
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
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));

  }
}
#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 ) );
}
import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        // 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));
    } //main 
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlConvert-Klasse
XmlConvert-Member
System.Xml-Namespace