XmlConvert-Klasse
Codiert und decodiert XML-Namen und stellt Methoden für das Konvertieren zwischen Typen der Common Language Runtime und XSD-Typen (XML Schema Definition) bereit. Bei der Konvertierung von Datentypen sind die zurückgegebenen Werte vom Gebietsschema unabhängig.
Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)
Syntax
'Declaration
Public Class XmlConvert
'Usage
Dim instance As XmlConvert
public class XmlConvert
public ref class XmlConvert
public class XmlConvert
public class XmlConvert
Hinweise
Element- und Attributnamen oder ID-Werte sind auf einen Bereich von XML-Zeichen beschränkt, der der W3C-Empfehlung Extensible Markup Language (XML) 1.0 (Second Edition) entspricht. Sie finden die Empfehlung unter www.w3.org/TR/2000/REC-xml-20001006.html (nur auf Englisch verfügbar). Wenn Namen ungültige Zeichen enthalten, werden diese mithilfe der EncodeName-Methode und der DecodeName-Methode in gültige XML-Namen übersetzt.
Bei vielen Sprachen und Anwendungen wie Microsoft SQL Server und Microsoft Word sind Unicode-Zeichen in Namen zulässig, die in XML-Namen ungültig sind. Beispielsweise wäre bei einer Spaltenüberschrift "Order Detail" in einer Datenbank das Leerzeichen zwischen den Worten "Order" und "Detail" zugelassen. In XML gilt jedoch das Leerzeichen zwischen "Order" und "Detail" als unzulässiges XML-Zeichen. Das ungültige Leerzeichen muss daher in hexadezimal codierte Escapezeichen konvertiert werden und kann später decodiert werden.
Bei Verwendung der EncodeName-Methode zusammen mit der XmlWriter-Klasse ist gewährleistet, dass gültige XML-Namen geschrieben werden. Der folgende C#-Code konvertiert den Namen "Order Detail" in einen gültigen XML-Namen und schreibt das Element <Order_0x0020_Detail>My order</Order_0x0020_Detail>.
writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
XmlConvert stellt außerdem Methoden für das Konvertieren einer Zeichenfolge in einen .NET Framework-Datentyp und umgekehrt bereit. Gebietsschemaeinstellungen werden bei der Datenkonvertierung nicht berücksichtigt. Die Datentypen beruhen auf XSD-Datentypen (XML Schema Definition).
Hinweis
In .NET Framework, Version 2.0, beinhalten die Klassen XmlReader, XmlWriter und XPathNavigator neue Methoden, die typisierte Daten behandeln können. Diese neuen Methoden behandeln die Konvertierung der Zeichenfolge in einen .NET Framework-Datentyp.
Vererbungshierarchie
System.Object
System.Xml.XmlConvert
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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