XmlConvert Klasse

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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.

public ref class XmlConvert abstract sealed

public ref class XmlConvert

public static class XmlConvert

public class XmlConvert

type XmlConvert = class

Public Class XmlConvert

Vererbung

Object

XmlConvert

Hinweise

Die XmlConvert -Klasse entspricht funktional der Convert -Klasse, unterstützt aber XML-Standards. Das Typsystem basiert auf dem XSD-Schematyp (XML Schema Definition Language), und die zurückgegebenen Werte sind stets vom Gebietsschema unabhängig.

Codierung und Decodierung

Element- und Attributnamen oder ID-Werte sind gemäß der W3C XML 1.0-Empfehlung auf einen Bereich von XML-Zeichen beschränkt. Wenn Namen ungültige Zeichen enthalten, können Sie die EncodeName Methoden und DecodeName in dieser Klasse verwenden, um sie in gültige XML-Namen zu übersetzen.

Wenn Sie beispielsweise die Spaltenüberschrift "Order Detail" in einer Datenbank verwenden möchten, lässt die Datenbank den Abstand zwischen den beiden Wörtern zu. In XML gilt das Leerzeichen zwischen "Order" und "Detail" jedoch als ungültiges XML-Zeichen. Sie müssen es in eine Hexadezimalcodierung mit Escapezeichen konvertieren und später decodieren.

Sie können die EncodeName -Methode mit der XmlWriter -Klasse verwenden, um sicherzustellen, dass die geschriebenen Namen gültige XML-Namen sind. 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");

Die folgenden XmlConvert Methoden führen die Codierung und Decodierung aus.

Methode	BESCHREIBUNG
EncodeName	Nimmt einen Namen an und gibt den codierten Namen zusammen mit allen ungültigen Zeichen zurück, die durch eine Escapezeichenfolge ersetzt werden. Diese Methode lässt Doppelpunkte an jeder Position zu, was bedeutet, dass der Name gemäß der W3C-Namespaces-Empfehlung in XML 1.0 weiterhin ungültig sein kann.
EncodeNmToken	Nimmt einen Namen an und gibt den codierten Namen zurück.
EncodeLocalName	Dasselbe gilt für EncodeName das Codieren des Doppelpunkts, sodass sichergestellt wird, dass der Name als LocalName Teil eines namespacequalifizierten Namens verwendet werden kann.
DecodeName	Kehrt die Transformation für alle Codierungsmethoden um.

Namensüberprüfung

Die XmlConvert -Klasse enthält zwei Methoden, die die Zeichen in einem Element- oder Attributnamen überprüfen und überprüfen, ob der Name den Regeln entspricht, die von der W3C XML 1.0-Empfehlung festgelegt werden:

• VerifyName überprüft die Zeichen und überprüft, ob der Name gültig ist. Die Methode gibt den Namen zurück, wenn er gültig ist, und löst eine Ausnahme aus, wenn dies nicht der Fall ist.

• VerifyNCName führt die gleiche Überprüfung aus, akzeptiert jedoch nicht qualifizierte Namen.

Enthält XmlConvert zusätzliche Methoden zum Überprüfen von Token, Leerzeichen, öffentlichen IDs und anderen Zeichenfolgen.

Datentypkonvertierung

XmlConvert stellt außerdem Methoden bereit, mit denen Sie Daten aus einer Zeichenfolge in einen stark typisierten Datentyp konvertieren können. Beispielsweise konvertiert die ToDateTime -Methode eine Zeichenfolge in ihre DateTime Entsprechung. Dies ist nützlich, da die meisten Methoden in der XmlReader -Klasse Daten als Zeichenfolge zurückgeben. Nachdem die Daten gelesen wurden, können sie vor der Verwendung in den richtigen Datentyp konvertiert werden. Die ToString Überladungen stellen den komplementären Vorgang bereit, indem stark typisierte Daten in Zeichenfolgen konvertiert werden. Dies ist z. B. nützlich, wenn Sie die Daten zu Textfeldern auf einer Webseite hinzufügen möchten. Gebietsschemaeinstellungen werden bei der Datenkonvertierung nicht berücksichtigt. Die Datentypen basieren auf den XSD-Datentypen (XML Schema).

Konstruktoren

XmlConvert()

Initialisiert eine neue Instanz der XmlConvert-Klasse.

Methoden

DecodeName(String)	Decodiert einen Namen. Diese Methode ist die Umkehrung der EncodeName(String)-Methode und der EncodeLocalName(String)-Methode.
EncodeLocalName(String)	Konvertiert den Namen in einen gültigen lokalen XML-Namen.
EncodeName(String)	Konvertiert den Namen in einen gültigen XML-Namen.
EncodeNmToken(String)	Überprüft, ob der Name entsprechend der XML-Spezifikation gültig ist.
IsNCNameChar(Char)	Überprüft, ob das übergebene Zeichen ein gültiger Nicht-Doppelpunkt-Zeichentyp ist.
IsPublicIdChar(Char)	Gibt die übergebene Zeicheninstanz zurück, wenn das Zeichen im Argument ein gültiges Zeichen für eine öffentliche ID ist, andernfalls null.
IsStartNCNameChar(Char)	Überprüft, ob das übergebene Zeichen ein gültiger Startnamenszeichen-Typ ist.
IsWhitespaceChar(Char)	Überprüft, ob das übergebene Zeichen ein gültiges XML-Leerraumzeichen ist.
IsXmlChar(Char)	Überprüft, ob das übergebene Zeichen ein gültiges XML-Zeichen ist.
IsXmlSurrogatePair(Char, Char)	Überprüft, ob das übergebene Ersatzzeichenpaar ein gültiges XML-Zeichen ist.
ToBoolean(String)	Konvertiert den String in ein Boolean-Äquivalent.
ToByte(String)	Konvertiert den String in ein Byte-Äquivalent.
ToChar(String)	Konvertiert den String in ein Char-Äquivalent.
ToDateTime(String)	Veraltet. Veraltet. Konvertiert den String in ein DateTime-Äquivalent.
ToDateTime(String, String)	Konvertiert den String in ein DateTime-Äquivalent.
ToDateTime(String, String[])	Konvertiert den String in ein DateTime-Äquivalent.
ToDateTime(String, XmlDateTimeSerializationMode)	Konvertiert die String-Struktur mithilfe von XmlDateTimeSerializationMode in eine DateTime.
ToDateTimeOffset(String)	Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.
ToDateTimeOffset(String, String)	Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.
ToDateTimeOffset(String, String[])	Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.
ToDecimal(String)	Konvertiert den String in ein Decimal-Äquivalent.
ToDouble(String)	Konvertiert den String in ein Double-Äquivalent.
ToGuid(String)	Konvertiert den String in ein Guid-Äquivalent.
ToInt16(String)	Konvertiert den String in ein Int16-Äquivalent.
ToInt32(String)	Konvertiert den String in ein Int32-Äquivalent.
ToInt64(String)	Konvertiert den String in ein Int64-Äquivalent.
ToSByte(String)	Konvertiert den String in ein SByte-Äquivalent.
ToSingle(String)	Konvertiert den String in ein Single-Äquivalent.
ToString(Boolean)	Konvertiert das Boolean-Element in eine String.
ToString(Byte)	Konvertiert das Byte-Element in eine String.
ToString(Char)	Konvertiert das Char-Element in eine String.
ToString(DateTime)	Veraltet. Veraltet. Konvertiert das DateTime-Element in eine String.
ToString(DateTime, String)	Konvertiert das DateTime-Element in eine String.
ToString(DateTime, XmlDateTimeSerializationMode)	Konvertiert die DateTime-Struktur mithilfe von XmlDateTimeSerializationMode in eine String.
ToString(DateTimeOffset)	Konvertiert den angegebenen DateTimeOffset in einen String.
ToString(DateTimeOffset, String)	Konvertiert den angegebenen DateTimeOffset in einen String im angegebenen Format.
ToString(Decimal)	Konvertiert das Decimal-Element in eine String.
ToString(Double)	Konvertiert das Double-Element in eine String.
ToString(Guid)	Konvertiert das Guid-Element in eine String.
ToString(Int16)	Konvertiert das Int16-Element in eine String.
ToString(Int32)	Konvertiert das Int32-Element in eine String.
ToString(Int64)	Konvertiert das Int64-Element in eine String.
ToString(SByte)	Konvertiert das SByte-Element in eine String.
ToString(Single)	Konvertiert das Single-Element in eine String.
ToString(TimeSpan)	Konvertiert das TimeSpan-Element in eine String.
ToString(UInt16)	Konvertiert das UInt16-Element in eine String.
ToString(UInt32)	Konvertiert das UInt32-Element in eine String.
ToString(UInt64)	Konvertiert das UInt64-Element in eine String.
ToTimeSpan(String)	Konvertiert den String in ein TimeSpan-Äquivalent.
ToUInt16(String)	Konvertiert den String in ein UInt16-Äquivalent.
ToUInt32(String)	Konvertiert den String in ein UInt32-Äquivalent.
ToUInt64(String)	Konvertiert den String in ein UInt64-Äquivalent.
VerifyName(String)	Überprüft, ob der Name ein gültiger Name gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist.
VerifyNCName(String)	Überprüft, ob der Name ein gültiger NCName gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist. Ein NCName darf keinen Doppelpunkt enthalten.
VerifyNMTOKEN(String)	Überprüft, ob die Zeichenfolge ein gültiges NMTOKEN gemäß der Empfehlung in W3C XML Schema, Teil 2: „Datentypempfehlung“ ist.
VerifyPublicId(String)	Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Zeichen für eine öffentliche ID sind.
VerifyTOKEN(String)	Überprüft, ob die Zeichenfolge ein gültiges Token gemäß der Empfehlung in W3C XML Schema Teil 2: „Datentypen“ ist.
VerifyWhitespace(String)	Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Leerraumzeichen sind.
VerifyXmlChars(String)	Gibt die übergebene Zeichenfolge zurück, wenn alle Zeichen und Ersatzzeichenpaare im Zeichenfolgenargument gültige XML-Zeichen sind, andernfalls wird eine XmlException mit Informationen zum ersten ungültigen Zeichen ausgelöst.