XmlConvert-Klasse (System.Xml)

Alle reduzieren

Inhalt anzeigen: Englisch mit deutscher Übersetzung

.NET Framework Class Library

XmlConvert Class

Encodes and decodes XML names and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. When converting data types the values returned are locale independent.

Inheritance Hierarchy

System..::.Object
System.Xml..::.XmlConvert

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

Syntax

Visual Basic

Public Class XmlConvert

public class XmlConvert

Visual C++

public ref class XmlConvert

type XmlConvert =  class end

The XmlConvert type exposes the following members.

Constructors

	Name	Description
	XmlConvert	Initializes a new instance of the XmlConvert class.

Top

Methods

	Name	Description
	DecodeName	Decodes a name. This method does the reverse of the EncodeName and EncodeLocalName methods.
	EncodeLocalName	Converts the name to a valid XML local name.
	EncodeName	Converts the name to a valid XML name.
	EncodeNmToken	Verifies the name is valid according to the XML specification.
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	FromBinHexString	Obsolete. Converts a BinHex-encoded string to a byte array.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	IsNCNameChar	Checks whether the passed-in character is a valid non-colon character type.
	IsPublicIdChar	Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise nullNothingnullptra null reference (Nothing in Visual Basic).
	IsStartNCNameChar	Checks if the passed-in character is a valid Start Name Character type.
	IsWhitespaceChar	Checks if the passed-in character is a valid XML whitespace character.
	IsXmlChar	Checks if the passed-in character is a valid XML character.
	IsXmlSurrogatePair	Checks if the passed-in surrogate pair of characters is a valid XML character.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToBinHexString	Obsolete. Converts a byte array to a BinHex-encoded string.
	ToBoolean	Converts the String to a Boolean equivalent.
	ToByte	Converts the String to a Byte equivalent.
	ToChar	Converts the String to a Char equivalent.
	ToDateTime(String)	Obsolete. Converts the String to a DateTime equivalent.
	ToDateTime(String, String)	Converts the String to a DateTime equivalent.
	ToDateTime(String, array<String>[]()[])	Converts the String to a DateTime equivalent.
	ToDateTime(String, XmlDateTimeSerializationMode)	Converts the String to a DateTime using the XmlDateTimeSerializationMode specified
	ToDateTimeOffset(String)	Converts the supplied String to a DateTimeOffset equivalent.
	ToDateTimeOffset(String, String)	Converts the supplied String to a DateTimeOffset equivalent.
	ToDateTimeOffset(String, array<String>[]()[])	Converts the supplied String to a DateTimeOffset equivalent.
	ToDecimal	Converts the String to a Decimal equivalent.
	ToDouble	Converts the String to a Double equivalent.
	ToGuid	Converts the String to a Guid equivalent.
	ToInt16	Converts the String to a Int16 equivalent.
	ToInt32	Converts the String to a Int32 equivalent.
	ToInt64	Converts the String to a Int64 equivalent.
	ToSByte	Converts the String to a SByte equivalent.
	ToSingle	Converts the String to a Single equivalent.
	ToString()()()	Returns a string that represents the current object. (Inherited from Object.)
	ToString(Boolean)	Converts the Boolean to a String.
	ToString(Byte)	Converts the Byte to a String.
	ToString(Char)	Converts the Char to a String.
	ToString(DateTime)	Obsolete. Converts the DateTime to a String.
	ToString(DateTimeOffset)	Converts the supplied DateTimeOffset to a String.
	ToString(Decimal)	Converts the Decimal to a String.
	ToString(Double)	Converts the Double to a String.
	ToString(Guid)	Converts the Guid to a String.
	ToString(Int16)	Converts the Int16 to a String.
	ToString(Int32)	Converts the Int32 to a String.
	ToString(Int64)	Converts the Int64 to a String.
	ToString(SByte)	Converts the SByte to a String.
	ToString(Single)	Converts the Single to a String.
	ToString(TimeSpan)	Converts the TimeSpan to a String.
	ToString(UInt16)	Converts the UInt16 to a String.
	ToString(UInt32)	Converts the UInt32 to a String.
	ToString(UInt64)	Converts the UInt64 to a String.
	ToString(DateTime, String)	Converts the DateTime to a String.
	ToString(DateTime, XmlDateTimeSerializationMode)	Converts the DateTime to a String using the XmlDateTimeSerializationMode specified.
	ToString(DateTimeOffset, String)	Converts the supplied DateTimeOffset to a String in the specified format.
	ToTimeSpan	Converts the String to a TimeSpan equivalent.
	ToUInt16	Converts the String to a UInt16 equivalent.
	ToUInt32	Converts the String to a UInt32 equivalent.
	ToUInt64	Converts the String to a UInt64 equivalent.
	VerifyName	Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.
	VerifyNCName	Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. An NCName is a name that cannot contain a colon.
	VerifyNMTOKEN	Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation
	VerifyPublicId	Returns the passed in string instance if all the characters in the string argument are valid public id characters.
	VerifyTOKEN	Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.
	VerifyWhitespace	Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters.
	VerifyXmlChars	Returns the passed-in string if all the characters and surrogate pair characters in the string argument are valid XML characters, otherwise nullNothingnullptra null reference (Nothing in Visual Basic).

Top

Remarks

Element and attribute names or ID values are limited to a range of XML characters according to the Extensible Markup Language (XML) 1.0 spec (Fourth Edition) recommendation. When names contain invalid characters, the EncodeName and DecodeName methods are used to translate them into valid XML names.

Many languages and applications such as Microsoft SQL Server and Microsoft Word, allow Unicode characters in their names, which are not valid in XML names. For example, if 'Order Detail' were a column heading in a database, the database allows the space between the words Order and Detail. However, in XML, the space between Order and Detail is considered an invalid XML character. Thus, the space, the invalid character, needs to be converted into an escaped hexadecimal encoding and can be decoded later.

The EncodeName method can be used with the XmlWriter class to ensure the names being written are valid XML names. 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");

XmlConvert also provides methods that enable you to convert from a string to a .NET Framework data type and vice-versa. Locale settings are not taken into account during data conversion. The data types are based on the XML Schema (XSD) data types.

Note
In the .NET Framework version 2.0, the XmlReader, XmlWriter, and XPathNavigator classes include new methods that can handle typed data. These new methods handle the string to .NET Framework data type conversion for you.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

System.Xml Namespace

.NET Framework-Klassenbibliothek

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.

Vererbungshierarchie

System..::.Object
System.Xml..::.XmlConvert

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

Syntax

Visual Basic

Public Class XmlConvert

public class XmlConvert

Visual C++

public ref class XmlConvert

type XmlConvert =  class end

Der XmlConvert-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	XmlConvert	Initialisiert eine neue Instanz der XmlConvert-Klasse.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	DecodeName	Decodiert einen Namen. Diese Methode ist die Umkehrung der EncodeName-Methode und der EncodeLocalName-Methode.
	EncodeLocalName	Konvertiert den Namen in einen gültigen lokalen XML-Namen.
	EncodeName	Konvertiert den Namen in einen gültigen XML-Namen.
	EncodeNmToken	Überprüft, ob der Name entsprechend der XML-Spezifikation gültig ist.
	Equals(Object)	Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
	FromBinHexString	Veraltet. Konvertiert eine BinHex-codierte Zeichenfolge in ein Bytearray.
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	IsNCNameChar	Überprüft, ob das übergebene Zeichen ein gültiger Nicht-Doppelpunkt-Zeichentyp ist.
	IsPublicIdChar	Gibt die übergebene Zeicheninstanz zurück, wenn das Zeichen im Argument ein gültiges Zeichen für eine öffentliche ID ist, andernfalls nullNothingnullptrNULL-Verweis (Nothing in Visual Basic).
	IsStartNCNameChar	Überprüft, ob das übergebene Zeichen ein gültiger Startnamenszeichentyp ist.
	IsWhitespaceChar	Überprüft, ob das übergebene Zeichen ein gültiges XML-Leerzeichen ist.
	IsXmlChar	Überprüft, ob das übergebene Zeichen ein gültiges XML-Zeichen ist.
	IsXmlSurrogatePair	Überprüft, ob das übergebene Ersatzzeichenpaar ein gültiges XML-Zeichen ist.
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	ToBinHexString	Veraltet. Konvertiert ein Bytearray in eine BinHex-codierte Zeichenfolge.
	ToBoolean	Konvertiert die String in ein Boolean-Äquivalent.
	ToByte	Konvertiert die String in ein Byte-Äquivalent.
	ToChar	Konvertiert die String in ein Char-Äquivalent.
	ToDateTime(String)	Veraltet. Konvertiert die String in ein DateTime-Äquivalent.
	ToDateTime(String, String)	Konvertiert die String in ein DateTime-Äquivalent.
	ToDateTime(String, array<String>[]()[])	Konvertiert die String in ein DateTime-Äquivalent.
	ToDateTime(String, XmlDateTimeSerializationMode)	Konvertiert die String mithilfe von XmlDateTimeSerializationMode in eine DateTime-Struktur.
	ToDateTimeOffset(String)	Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.
	ToDateTimeOffset(String, String)	Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.
	ToDateTimeOffset(String, array<String>[]()[])	Konvertiert den angegebenen String in ein DateTimeOffset-Äquivalent.
	ToDecimal	Konvertiert den String in ein Decimal-Äquivalent.
	ToDouble	Konvertiert die String in ein Double-Äquivalent.
	ToGuid	Konvertiert die String in ein Guid-Äquivalent.
	ToInt16	Konvertiert die String in ein Int16-Äquivalent.
	ToInt32	Konvertiert die String in ein Int32-Äquivalent.
	ToInt64	Konvertiert die String in ein Int64-Äquivalent.
	ToSByte	Konvertiert die String in ein SByte-Äquivalent.
	ToSingle	Konvertiert die String in ein Single-Äquivalent.
	ToString()()()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
	ToString(Boolean)	Konvertiert Boolean in eine String.
	ToString(Byte)	Konvertiert Byte in eine String.
	ToString(Char)	Konvertiert Char in eine String.
	ToString(DateTime)	Veraltet. Konvertiert DateTime in eine String.
	ToString(DateTimeOffset)	Konvertiert den angegebenen DateTimeOffset in einen String.
	ToString(Decimal)	Konvertiert Decimal in eine String.
	ToString(Double)	Konvertiert Double in eine String.
	ToString(Guid)	Konvertiert Guid in eine String.
	ToString(Int16)	Konvertiert Int16 in eine String.
	ToString(Int32)	Konvertiert Int32 in eine String.
	ToString(Int64)	Konvertiert Int64 in eine String.
	ToString(SByte)	Konvertiert SByte in eine String.
	ToString(Single)	Konvertiert Single in eine String.
	ToString(TimeSpan)	Konvertiert TimeSpan in eine String.
	ToString(UInt16)	Konvertiert UInt16 in eine String.
	ToString(UInt32)	Konvertiert UInt32 in eine String.
	ToString(UInt64)	Konvertiert UInt64 in eine String.
	ToString(DateTime, String)	Konvertiert DateTime in eine String.
	ToString(DateTime, XmlDateTimeSerializationMode)	Konvertiert die DateTime-Struktur mithilfe von XmlDateTimeSerializationMode in eine String.
	ToString(DateTimeOffset, String)	Konvertiert den angegebenen DateTimeOffset im angegebenen Format in einen String.
	ToTimeSpan	Konvertiert den String in ein TimeSpan-Äquivalent.
	ToUInt16	Konvertiert die String in ein UInt16-Äquivalent.
	ToUInt32	Konvertiert die String in ein UInt32-Äquivalent.
	ToUInt64	Konvertiert die String in ein UInt64-Äquivalent.
	VerifyName	Überprüft, ob der Name ein gültiger Name gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist.
	VerifyNCName	Überprüft, ob der Name ein gültiger NCName gemäß der W3C-Empfehlung für XML (Extended Markup Language) ist. Ein NCName kann keinen Doppelpunkt enthalten.
	VerifyNMTOKEN	Überprüft, ob die Zeichenfolge ein gültiges NMTOKEN gemäß der Empfehlung in W3C XML Schema Part2: Datatypes ist.
	VerifyPublicId	Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Zeichen für eine öffentliche ID sind.
	VerifyTOKEN	Überprüft, ob die Zeichenfolge ein gültiges Token gemäß der Empfehlung in W3C XML Schema Part2: Datatypes ist.
	VerifyWhitespace	Gibt die übergebene Zeichenfolgeninstanz zurück, wenn alle Zeichen im Zeichenfolgenargument gültige Leerzeichen sind.
	VerifyXmlChars	Gibt die übergebene Zeichenfolge zurück, wenn alle Zeichen und Ersatzzeichenpaare im Zeichenfolgenargument gültige XML-Zeichen sind, andernfalls nullNothingnullptrNULL-Verweis (Nothing in Visual Basic).

Zum Seitenanfang

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 (Fourth Edition) entspricht. 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.

Versionsinformationen

.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Unterstützt in:

Plattformen

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Xml-Namespace