XmlConvert Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Codiert und decodiert XML-Namen und stellt Methoden zum Konvertieren zwischen gängigen Sprachlaufzeittypen und XSD-Typen (XML Schema Definition Language) bereit. Beim Konvertieren von Datentypen sind die zurückgegebenen Werte gebietsschemaunabhängig.
public ref class XmlConvert abstract sealedpublic ref class XmlConvertpublic static class XmlConvertpublic class XmlConverttype XmlConvert = classPublic Class XmlConvert- Vererbung
-
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 entsprechend 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- und DecodeName-Methoden in dieser Klasse verwenden, um sie in gültige XML-Namen zu übersetzen.
Wenn Sie beispielsweise die Spaltenüberschrift "Bestelldetails" in einer Datenbank verwenden möchten, ermöglicht die Datenbank den Abstand zwischen den beiden Wörtern. In XML gilt der Abstand 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 Methode mit der EncodeNameXmlWriter 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 Codierung und Decodierung aus.
| Methode | Description |
|---|---|
| EncodeName | Nimmt einen Namen und gibt den kodierten Namen zusammen mit allen ungültigen Zeichen zurück, die durch eine Escapezeichenfolge ersetzt werden. Diese Methode ermöglicht Doppelpunkte an einer beliebigen Position, was bedeutet, dass der Name nach der Empfehlung für W3C-Namespaces in XML 1.0 möglicherweise noch ungültig ist. |
| EncodeNmToken | Nimmt einen Namen und gibt den kodierten Namen zurück. |
| EncodeLocalName | Identisch mit EncodeName der Ausnahme, dass es auch das Doppelpunktzeichen codiert, wobei 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 wurden:
- 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 er nicht gültig ist.
- VerifyNCName führt dieselbe Überprüfung aus, akzeptiert aber nicht qualifizierte Namen.
Die XmlConvert enthält zusätzliche Methoden, mit denen Token, Leerzeichen, öffentliche IDs und andere Zeichenfolgen überprüft werden.
Datentypkonvertierung
XmlConvert Stellt außerdem Methoden bereit, mit denen Sie Daten aus einer Zeichenfolge in einen stark typierten Datentyp konvertieren können. Die Methode ToDateTime konvertiert z. B. eine Zeichenfolge in das DateTime-Äquivalent. Dies ist nützlich, da die meisten Methoden in der XmlReader Klasse Daten als Zeichenfolge zurückgeben. Nachdem die Daten gelesen wurden, kann sie vor der Verwendung in den richtigen Datentyp konvertiert werden. Die ToString-Überladungen stellen den ergänzenden Vorgang bereit, indem stark typisierte Daten in Zeichenfolgen konvertiert werden. Dies ist beispielsweise hilfreich, wenn Sie die Daten textfeldern auf einer Webseite hinzufügen möchten. Lokaleinstellungen werden während der Datenkonvertierung nicht berücksichtigt. Die Datentypen basieren auf den XML-Schema-Datentypen (XSD).
Konstruktoren
| Name | Beschreibung |
|---|---|
| XmlConvert() |
Initialisiert eine neue Instanz der XmlConvert-Klasse. |
Methoden
| Name | Beschreibung |
|---|---|
| DecodeName(String) |
Decodiert einen Namen. Diese Methode führt die Umgekehrtkeit der EncodeName(String) Methoden durch EncodeLocalName(String) . |
| 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 gemäß 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 öffentliches ID-Zeichen ist, andernfalls |
| IsStartNCNameChar(Char) |
Überprüft, ob das übergebene Zeichen ein gültiger Startname-Zeichentyp ist. |
| IsWhitespaceChar(Char) |
Überprüft, ob das übergebene Zeichen ein gültiges XML-Leerzeichen ist. |
| IsXmlChar(Char) |
Überprüft, ob das übergebene Zeichen ein gültiges XML-Zeichen ist. |
| IsXmlSurrogatePair(Char, Char) |
Überprüft, ob das übergebene Ersatzpaar ein gültiges XML-Zeichen ist. |
| ToBoolean(String) | |
| ToByte(String) | |
| ToChar(String) | |
| ToDateTime(String, String) | |
| ToDateTime(String, String[]) | |
| ToDateTime(String, XmlDateTimeSerializationMode) |
Wandelt die String Konvertierung in eine DateTime mit dem XmlDateTimeSerializationMode angegebenen Wert um. |
| ToDateTime(String) |
Veraltet.
Veraltet.
|
| ToDateTimeOffset(String, String) |
Wandelt den bereitgestellten String Wert in ein DateTimeOffset Äquivalent um. |
| ToDateTimeOffset(String, String[]) |
Wandelt den bereitgestellten String Wert in ein DateTimeOffset Äquivalent um. |
| ToDateTimeOffset(String) |
Wandelt den bereitgestellten String Wert in ein DateTimeOffset Äquivalent um. |
| ToDecimal(String) | |
| ToDouble(String) | |
| ToGuid(String) | |
| ToInt16(String) | |
| ToInt32(String) | |
| ToInt64(String) | |
| ToSByte(String) | |
| ToSingle(String) | |
| ToString(Boolean) | |
| ToString(Byte) | |
| ToString(Char) | |
| ToString(DateTime, String) | |
| ToString(DateTime, XmlDateTimeSerializationMode) |
Wandelt die DateTime Konvertierung in eine String mit dem XmlDateTimeSerializationMode angegebenen Wert um. |
| ToString(DateTime) |
Veraltet.
Veraltet.
|
| ToString(DateTimeOffset, String) |
Konvertiert das angegebene DateTimeOffset Format in ein String angegebenes Format. |
| ToString(DateTimeOffset) |
Konvertiert die bereitgestellte DateTimeOffset In ein String. |
| ToString(Decimal) | |
| ToString(Double) | |
| ToString(Guid) | |
| ToString(Int16) | |
| ToString(Int32) | |
| ToString(Int64) | |
| ToString(SByte) | |
| ToString(Single) | |
| ToString(TimeSpan) | |
| ToString(UInt16) | |
| ToString(UInt32) | |
| ToString(UInt64) | |
| ToTimeSpan(String) | |
| ToUInt16(String) | |
| ToUInt32(String) | |
| ToUInt64(String) | |
| VerifyName(String) |
Überprüft, ob der Name ein gültiger Name gemäß der Empfehlung für die erweiterte W3C-Markupsprache ist. |
| VerifyNCName(String) |
Überprüft, ob der Name gemäß der Empfehlung für die erweiterte W3C-Markupsprache gültig |
| VerifyNMTOKEN(String) |
Überprüft, ob es sich bei der Zeichenfolge um ein gültiges NMTOKEN gemäß der W3C-XML-Schemakomponente2 handelt: Empfehlung für Datentypen. |
| VerifyPublicId(String) |
Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige öffentliche ID-Zeichen sind. |
| VerifyTOKEN(String) |
Überprüft, ob es sich bei der Zeichenfolge um ein gültiges Token gemäß der W3C-XML-Schemakomponente2 handelt: Empfehlung für Datentypen. |
| VerifyWhitespace(String) |
Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Leerzeichen sind. |
| VerifyXmlChars(String) |
Gibt die übergebene Zeichenfolge zurück, wenn alle Zeichen und Ersatzpaarzeichen im Zeichenfolgenargument gültige XML-Zeichen sind, andernfalls wird ein |
