XmlConvert XmlConvert XmlConvert XmlConvert Class

Definition

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.Encodes and decodes XML names, and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. Bei der Konvertierung von Datentypen sind die zurückgegebenen Werte vom Gebietsschema unabhängig.When converting data types, the values returned are locale-independent.

public ref class XmlConvert
public class XmlConvert
type XmlConvert = class
Public Class XmlConvert
Vererbung
XmlConvertXmlConvertXmlConvertXmlConvert

Hinweise

Die XmlConvert -Klasse ist funktionell gleichwertig Convert mit der-Klasse, unterstützt jedoch XML-Standards.The XmlConvert class is functionally equivalent to the Convert class, but it supports XML standards. Das Typsystem basiert auf dem XSD-Schematyp (XML Schema Definition Language), und die zurückgegebenen Werte sind stets vom Gebietsschema unabhängig.The type system is based on the XML Schema definition language (XSD) schema type, and the values returned are always locale-independent.

Codierung und DecodierungEncoding and decoding

Element-und Attributnamen oder ID-Werte sind auf einen Bereich von XML-Zeichen gemäß der W3C- Empfehlung für XML 1,0beschränkt.Element and attribute names or ID values are limited to a range of XML characters according to the W3C XML 1.0 recommendation. Wenn Namen ungültige Zeichen enthalten, können Sie die EncodeName - DecodeName Methode und die-Methode in dieser Klasse verwenden, um Sie in gültige XML-Namen zu übersetzen.When names contain invalid characters, you can use the EncodeName and DecodeName methods in this class to translate them into valid XML names.

Wenn Sie z. b. die Spaltenüberschrift "Order Detail" in einer-Datenbank verwenden möchten, lässt die Datenbank den Leerraum zwischen den beiden Wörtern zu.For example, if you want to use the column heading "Order Detail" in a database, the database allows the space between the two words. In XML wird das Leerzeichen zwischen "Order" und "Detail" jedoch als ungültiges XML-Zeichen betrachtet.However, in XML, the space between "Order" and "Detail" is considered an invalid XML character. Sie müssen es in eine hexadezimale Codierung mit Escapezeichen umwandeln und Sie später decodieren.You have to convert it into an escaped hexadecimal encoding and decode it later.

Sie können die EncodeName -Methode mit der XmlWriter -Klasse verwenden, um sicherzustellen, dass die geschriebenen Namen gültige XML-Namen sind.You can use the EncodeName method with the XmlWriter class to ensure the names being written are valid XML names. Der folgende C# Code konvertiert den Namen "Order Detail" in einen gültigen XML-Namen und schreibt das <Order_0x0020_Detail>My order</Order_0x0020_Detail>-Element.The following C# code converts the name "Order Detail" into a valid XML name and writes the 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 durch.The following XmlConvert methods perform encoding and decoding.

MethodeMethod BeschreibungDescription
EncodeName Nimmt einen Namen an und gibt den codierten Namen zusammen mit jedem ungültigen Zeichen zurück, das durch eine Escapezeichenfolge ersetzt wird.Takes a name and returns the encoded name along with any invalid character that is replaced by an escape string. Diese Methode ermöglicht Doppelpunkte an jeder beliebigen Position, d. h., der Name ist nach der W3C- Empfehlung "Namespaces in XML 1,0" möglicherweise trotzdem ungültig.This method allows colons in any position, which means that the name may still be invalid according to the W3C Namespaces in XML 1.0 recommendation.
EncodeNmToken Nimmt einen Namen an und gibt den codierten Namen zurück.Takes a name and returns the encoded name.
EncodeLocalName Identisch mit mit der Ausnahme, dass Sie auch den Doppelpunkt codiert und sicherstellt, dass der Name LocalName als Teil eines mit einem Namespace qualifizierten Namens verwendet werden kann. EncodeNameSame as EncodeName except that it also encodes the colon character, guaranteeing that the name can be used as the LocalName part of a namespace-qualified name.
DecodeName Kehrt die Transformation für alle Codierungsmethoden um.Reverses the transformation for all the encoding methods.

Namens ValidierungName validation

Die XmlConvert -Klasse enthält zwei Methoden, die die Zeichen in einem Element-oder Attributnamen überprüfen und sicherstellen, dass der Name den Regeln entspricht, die von der W3C- Empfehlung zu XML 1,0festgelegt werden:The XmlConvert class contains two methods that check the characters in an element or attribute name and verify that the name conforms to the rules set by the W3C XML 1.0 recommendation:

  • VerifyNameüberprüft die Zeichen und überprüft, ob der Name gültig ist.VerifyName checks the characters and verifies that the name is valid. Die Methode gibt den Namen zurück, wenn Sie gültig ist, und löst eine Ausnahme aus, wenn dies nicht der Fall ist.The method returns the name if it's valid, and throws an exception if it isn't.

  • VerifyNCNameführt die gleiche Validierung aus, akzeptiert jedoch nicht qualifizierte Namen.VerifyNCName performs the same validation, but accepts non-qualified names.

Der XmlConvert enthält zusätzliche Methoden, die Token, Leerzeichen, öffentliche IDs und andere Zeichen folgen überprüfen.The XmlConvert contains additional methods that validate tokens, white-space characters, public IDs, and other strings.

Datentyp KonvertierungData type conversion

XmlConvertstellt auch Methoden bereit, die es Ihnen ermöglichen, Daten aus einer Zeichenfolge in einen stark typisierten Datentyp zu konvertieren.XmlConvert also provides methods that enable you to convert data from a string to a strongly typed data type. Beispielsweise konvertiert die ToDateTime -Methode eine Zeichenfolge in DateTime die-Entsprechung.For example, the ToDateTime method converts a string to its DateTime equivalent. Dies ist hilfreich, da die meisten Methoden XmlReader in der-Klasse Daten als Zeichenfolge zurückgeben.This is useful because most methods in the XmlReader class return data as a string. Nachdem die Daten gelesen wurden, können Sie in den richtigen Datentyp konvertiert werden, bevor Sie verwendet werden.After the data is read, it can be converted to the proper data type before being used. Die ToString -über Ladungen stellen den ergänzenden Vorgang bereit, indem stark typisierte Daten in Zeichen folgen umgerechnet werden.The ToString overloads provide the complementary operation by converting strongly typed data to strings. Dies ist beispielsweise hilfreich, wenn Sie die Daten zu Textfeldern auf einer Webseite hinzufügen möchten.For example, this is useful when you want to add the data to text boxes on a webpage. Gebiets Schema Einstellungen werden bei der Datenkonvertierung nicht berücksichtigt.Locale settings are not taken into account during data conversion. Die Datentypen basieren auf den XML-Schema-Datentypen (XSD).The data types are based on the XML Schema (XSD) data types.

Konstruktoren

XmlConvert() XmlConvert() XmlConvert() XmlConvert()

Initialisiert eine neue Instanz der XmlConvert-Klasse.Initializes a new instance of the XmlConvert class.

Methoden

DecodeName(String) DecodeName(String) DecodeName(String) DecodeName(String)

Decodiert einen Namen.Decodes a name. Diese Methode ist die Umkehrung der EncodeName(String)-Methode und der EncodeLocalName(String)-Methode.This method does the reverse of the EncodeName(String) and EncodeLocalName(String) methods.

EncodeLocalName(String) EncodeLocalName(String) EncodeLocalName(String) EncodeLocalName(String)

Konvertiert den Namen in einen gültigen lokalen XML-Namen.Converts the name to a valid XML local name.

EncodeName(String) EncodeName(String) EncodeName(String) EncodeName(String)

Konvertiert den Namen in einen gültigen XML-Namen.Converts the name to a valid XML name.

EncodeNmToken(String) EncodeNmToken(String) EncodeNmToken(String) EncodeNmToken(String)

Überprüft, ob der Name entsprechend der XML-Spezifikation gültig ist.Verifies the name is valid according to the XML specification.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsNCNameChar(Char) IsNCNameChar(Char) IsNCNameChar(Char) IsNCNameChar(Char)

Überprüft, ob das übergebene Zeichen ein gültiger Nicht-Doppelpunkt-Zeichentyp ist.Checks whether the passed-in character is a valid non-colon character type.

IsPublicIdChar(Char) IsPublicIdChar(Char) IsPublicIdChar(Char) 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.Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise null.

IsStartNCNameChar(Char) IsStartNCNameChar(Char) IsStartNCNameChar(Char) IsStartNCNameChar(Char)

Überprüft, ob das übergebene Zeichen ein gültiger Startnamenszeichen-Typ ist.Checks if the passed-in character is a valid Start Name Character type.

IsWhitespaceChar(Char) IsWhitespaceChar(Char) IsWhitespaceChar(Char) IsWhitespaceChar(Char)

Überprüft, ob das übergebene Zeichen ein gültiges XML-Leerraumzeichen ist.Checks if the passed-in character is a valid XML whitespace character.

IsXmlChar(Char) IsXmlChar(Char) IsXmlChar(Char) IsXmlChar(Char)

Überprüft, ob das übergebene Zeichen ein gültiges XML-Zeichen ist.Checks if the passed-in character is a valid XML character.

IsXmlSurrogatePair(Char, Char) IsXmlSurrogatePair(Char, Char) IsXmlSurrogatePair(Char, Char) IsXmlSurrogatePair(Char, Char)

Überprüft, ob das übergebene Ersatzzeichenpaar ein gültiges XML-Zeichen ist.Checks if the passed-in surrogate pair of characters is a valid XML character.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToBoolean(String) ToBoolean(String) ToBoolean(String) ToBoolean(String)

Konvertiert den String in ein Boolean-Äquivalent.Converts the String to a Boolean equivalent.

ToByte(String) ToByte(String) ToByte(String) ToByte(String)

Konvertiert den String in ein Byte-Äquivalent.Converts the String to a Byte equivalent.

ToChar(String) ToChar(String) ToChar(String) ToChar(String)

Konvertiert den String in ein Char-Äquivalent.Converts the String to a Char equivalent.

ToDateTime(String) ToDateTime(String) ToDateTime(String) ToDateTime(String)

Konvertiert den String in ein DateTime-Äquivalent.Converts the String to a DateTime equivalent.

ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String) ToDateTime(String, String)

Konvertiert den String in ein DateTime-Äquivalent.Converts the String to a DateTime equivalent.

ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[]) ToDateTime(String, String[])

Konvertiert den String in ein DateTime-Äquivalent.Converts the String to a DateTime equivalent.

ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode) ToDateTime(String, XmlDateTimeSerializationMode)

Konvertiert den String mithilfe von XmlDateTimeSerializationMode in eine DateTime-Struktur.Converts the String to a DateTime using the XmlDateTimeSerializationMode specified

ToDateTimeOffset(String) ToDateTimeOffset(String) ToDateTimeOffset(String) ToDateTimeOffset(String)

Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String) ToDateTimeOffset(String, String) ToDateTimeOffset(String, String) ToDateTimeOffset(String, String)

Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.Converts the supplied String to a DateTimeOffset equivalent.

ToDateTimeOffset(String, String[]) ToDateTimeOffset(String, String[]) ToDateTimeOffset(String, String[]) ToDateTimeOffset(String, String[])

Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.Converts the supplied String to a DateTimeOffset equivalent.

ToDecimal(String) ToDecimal(String) ToDecimal(String) ToDecimal(String)

Konvertiert den String in ein Decimal-Äquivalent.Converts the String to a Decimal equivalent.

ToDouble(String) ToDouble(String) ToDouble(String) ToDouble(String)

Konvertiert den String in ein Double-Äquivalent.Converts the String to a Double equivalent.

ToGuid(String) ToGuid(String) ToGuid(String) ToGuid(String)

Konvertiert den String in ein Guid-Äquivalent.Converts the String to a Guid equivalent.

ToInt16(String) ToInt16(String) ToInt16(String) ToInt16(String)

Konvertiert den String in ein Int16-Äquivalent.Converts the String to a Int16 equivalent.

ToInt32(String) ToInt32(String) ToInt32(String) ToInt32(String)

Konvertiert den String in ein Int32-Äquivalent.Converts the String to a Int32 equivalent.

ToInt64(String) ToInt64(String) ToInt64(String) ToInt64(String)

Konvertiert den String in ein Int64-Äquivalent.Converts the String to a Int64 equivalent.

ToSByte(String) ToSByte(String) ToSByte(String) ToSByte(String)

Konvertiert den String in ein SByte-Äquivalent.Converts the String to a SByte equivalent.

ToSingle(String) ToSingle(String) ToSingle(String) ToSingle(String)

Konvertiert den String in ein Single-Äquivalent.Converts the String to a Single equivalent.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
ToString(Boolean) ToString(Boolean) ToString(Boolean) ToString(Boolean)

Konvertiert das Boolean-Element in eine String.Converts the Boolean to a String.

ToString(Byte) ToString(Byte) ToString(Byte) ToString(Byte)

Konvertiert das Byte-Element in eine String.Converts the Byte to a String.

ToString(Char) ToString(Char) ToString(Char) ToString(Char)

Konvertiert das Char-Element in eine String.Converts the Char to a String.

ToString(DateTime) ToString(DateTime) ToString(DateTime) ToString(DateTime)

Konvertiert das DateTime-Element in eine String.Converts the DateTime to a String.

ToString(DateTime, String) ToString(DateTime, String) ToString(DateTime, String) ToString(DateTime, String)

Konvertiert das DateTime-Element in eine String.Converts the DateTime to a String.

ToString(DateTime, XmlDateTimeSerializationMode) ToString(DateTime, XmlDateTimeSerializationMode) ToString(DateTime, XmlDateTimeSerializationMode) ToString(DateTime, XmlDateTimeSerializationMode)

Konvertiert die DateTime-Struktur mithilfe von XmlDateTimeSerializationMode in eine String.Converts the DateTime to a String using the XmlDateTimeSerializationMode specified.

ToString(DateTimeOffset) ToString(DateTimeOffset) ToString(DateTimeOffset) ToString(DateTimeOffset)

Konvertiert den angegebenen DateTimeOffset in einen String.Converts the supplied DateTimeOffset to a String.

ToString(DateTimeOffset, String) ToString(DateTimeOffset, String) ToString(DateTimeOffset, String) ToString(DateTimeOffset, String)

Konvertiert den angegebenen DateTimeOffset in einen String im angegebenen Format.Converts the supplied DateTimeOffset to a String in the specified format.

ToString(Decimal) ToString(Decimal) ToString(Decimal) ToString(Decimal)

Konvertiert das Decimal-Element in eine String.Converts the Decimal to a String.

ToString(Double) ToString(Double) ToString(Double) ToString(Double)

Konvertiert das Double-Element in eine String.Converts the Double to a String.

ToString(Guid) ToString(Guid) ToString(Guid) ToString(Guid)

Konvertiert das Guid-Element in eine String.Converts the Guid to a String.

ToString(Int16) ToString(Int16) ToString(Int16) ToString(Int16)

Konvertiert das Int16-Element in eine String.Converts the Int16 to a String.

ToString(Int32) ToString(Int32) ToString(Int32) ToString(Int32)

Konvertiert das Int32-Element in eine String.Converts the Int32 to a String.

ToString(Int64) ToString(Int64) ToString(Int64) ToString(Int64)

Konvertiert das Int64-Element in eine String.Converts the Int64 to a String.

ToString(SByte) ToString(SByte) ToString(SByte) ToString(SByte)

Konvertiert das SByte-Element in eine String.Converts the SByte to a String.

ToString(Single) ToString(Single) ToString(Single) ToString(Single)

Konvertiert das Single-Element in eine String.Converts the Single to a String.

ToString(TimeSpan) ToString(TimeSpan) ToString(TimeSpan) ToString(TimeSpan)

Konvertiert das TimeSpan-Element in eine String.Converts the TimeSpan to a String.

ToString(UInt16) ToString(UInt16) ToString(UInt16) ToString(UInt16)

Konvertiert das UInt16-Element in eine String.Converts the UInt16 to a String.

ToString(UInt32) ToString(UInt32) ToString(UInt32) ToString(UInt32)

Konvertiert das UInt32-Element in eine String.Converts the UInt32 to a String.

ToString(UInt64) ToString(UInt64) ToString(UInt64) ToString(UInt64)

Konvertiert das UInt64-Element in eine String.Converts the UInt64 to a String.

ToTimeSpan(String) ToTimeSpan(String) ToTimeSpan(String) ToTimeSpan(String)

Konvertiert den String in ein TimeSpan-Äquivalent.Converts the String to a TimeSpan equivalent.

ToUInt16(String) ToUInt16(String) ToUInt16(String) ToUInt16(String)

Konvertiert den String in ein UInt16-Äquivalent.Converts the String to a UInt16 equivalent.

ToUInt32(String) ToUInt32(String) ToUInt32(String) ToUInt32(String)

Konvertiert den String in ein UInt32-Äquivalent.Converts the String to a UInt32 equivalent.

ToUInt64(String) ToUInt64(String) ToUInt64(String) ToUInt64(String)

Konvertiert den String in ein UInt64-Äquivalent.Converts the String to a UInt64 equivalent.

VerifyName(String) VerifyName(String) VerifyName(String) VerifyName(String)

Überprüft, ob der Name ein gültiger Name gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist.Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.

VerifyNCName(String) VerifyNCName(String) VerifyNCName(String) VerifyNCName(String)

Überprüft, ob der Name ein gültiger NCName gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist.Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. Ein NCName darf keinen Doppelpunkt enthalten.An NCName is a name that cannot contain a colon.

VerifyNMTOKEN(String) VerifyNMTOKEN(String) VerifyNMTOKEN(String) VerifyNMTOKEN(String)

Überprüft, ob die Zeichenfolge ein gültiges NMTOKEN gemäß der Empfehlung in W3C XML Schema, Teil 2: „Datentypempfehlung“ ist.Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation

VerifyPublicId(String) VerifyPublicId(String) VerifyPublicId(String) VerifyPublicId(String)

Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Zeichen für eine öffentliche ID sind.Returns the passed in string instance if all the characters in the string argument are valid public id characters.

VerifyTOKEN(String) VerifyTOKEN(String) VerifyTOKEN(String) VerifyTOKEN(String)

Überprüft, ob die Zeichenfolge ein gültiges Token gemäß der Empfehlung in W3C XML Schema, Teil 2: „Datentypempfehlung“ ist.Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.

VerifyWhitespace(String) VerifyWhitespace(String) VerifyWhitespace(String) VerifyWhitespace(String)

Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Leerraumzeichen sind.Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.

VerifyXmlChars(String) VerifyXmlChars(String) VerifyXmlChars(String) 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.Returns the passed-in string if all the characters and surrogate pair characters in the string argument are valid XML characters, otherwise an XmlException is thrown with information on the first invalid character encountered.

Gilt für: