XmlConvert Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Kóduje a dekóduje názvy XML a poskytuje metody pro převod mezi běžnými typy modulu runtime jazyka a typy XSD (XML Schema Definition Language Language). Při převodu datových typů jsou vrácené hodnoty nezávislé na národním prostředí.
public ref class XmlConvert abstract sealedpublic ref class XmlConvertpublic static class XmlConvertpublic class XmlConverttype XmlConvert = classPublic Class XmlConvert- Dědičnost
-
XmlConvert
Poznámky
Třída XmlConvert je funkčně ekvivalentní Convert třídě, ale podporuje standardy XML. Systém typů je založený na typu schématu XSD (XML Schema Definition Language) a vrácené hodnoty jsou vždy nezávislé na národním prostředí.
Kódování a dekódování
Názvy elementů a atributů nebo hodnoty ID jsou omezeny na rozsah znaků XML podle doporučení W3C XML 1.0. Pokud názvy obsahují neplatné znaky, můžete je použít EncodeName a DecodeName metody v této třídě k jejich překladu do platných názvů XML.
Pokud například chcete v databázi použít záhlaví sloupce Podrobnosti objednávky, databáze umožňuje mezeru mezi těmito dvěma slovy. V jazyce XML je však mezera mezi "Order" a "Detail" považována za neplatný znak XML. Musíte ho převést na escape šestnáctkové kódování a později ho dekódovat.
Metodu EncodeName s XmlWriter třídou můžete použít k zajištění, aby názvy, které se zapisují, byly platné názvy XML. Následující kód jazyka C# převede název Order Detail na platný název XML a zapíše element <Order_0x0020_Detail>My order</Order_0x0020_Detail>.
writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");
Následující XmlConvert metody provádějí kódování a dekódování.
| Metoda | Description |
|---|---|
| EncodeName | Vezme název a vrátí zakódovaný název spolu s kterýmkoli neplatným znakem, který je nahrazen únikovým řetězcem. Tato metoda umožňuje dvojtečky v libovolné pozici, což znamená, že název může být stále neplatný podle doporučení W3C pro obor názvů v XML 1.0. |
| EncodeNmToken | Bere jméno a vrátí zakódované jméno. |
| EncodeLocalName | Stejně jako EncodeName, ale zároveň kóduje také dvojtečku, čímž zaručuje, že název lze použít jako součást názvu kvalifikovaného ve jmenném prostoru LocalName. |
| DecodeName | Obrátí transformaci pro všechny metody kódování. |
Validace názvu
Třída XmlConvert obsahuje dvě metody, které kontrolují znaky v názvu elementu nebo atributu a ověřují, že název odpovídá pravidlům nastaveným doporučením W3C XML 1.0:
- VerifyName zkontroluje znaky a ověří, zda je název platný. Metoda vrátí název, pokud je platný, a vyvolá výjimku, pokud není.
- VerifyNCName provádí stejné ověření, ale přijímá nekvalifikované názvy.
XmlConvert obsahuje další metody, které ověřují tokeny, prázdné znaky, veřejné identifikátory a další řetězce.
Převod datového typu
XmlConvert poskytuje také metody, které umožňují převést data z řetězce na datový typ silného typu. Například ToDateTime metoda převede řetězec na jeho DateTime ekvivalent. To je užitečné, protože většina metod ve XmlReader třídě vrací data jako řetězec. Po přečtení dat je možné je před použití převést na správný datový typ. Přetížení ToString poskytují doplňkovou operaci převodem silně typovaných dat na řetězce. To je užitečné například v případě, že chcete data přidat do textových polí na webové stránce. Nastavení národního prostředí se při převodu dat nezapočítávají. Datové typy jsou založené na datových typech schématu XML (XSD).
Konstruktory
| Name | Description |
|---|---|
| XmlConvert() |
Inicializuje novou instanci XmlConvert třídy. |
Metody
| Name | Description |
|---|---|
| DecodeName(String) |
Dekóduje název. Tato metoda provede opak metod EncodeName(String) a EncodeLocalName(String) metod. |
| EncodeLocalName(String) |
Převede název na platný místní název XML. |
| EncodeName(String) |
Převede název na platný název XML. |
| EncodeNmToken(String) |
Ověří platnost názvu podle specifikace XML. |
| IsNCNameChar(Char) |
Zkontroluje, jestli je předaný znak platným jiným než dvojtečkam typu. |
| IsPublicIdChar(Char) |
Vrátí předanou instanci znaku, pokud je znak v argumentu platným znakem veřejného ID, jinak |
| IsStartNCNameChar(Char) |
Zkontroluje, jestli je předaný znak platným typem znaku počátečního názvu. |
| IsWhitespaceChar(Char) |
Zkontroluje, jestli je předaný znak platným znakem prázdného znaku XML. |
| IsXmlChar(Char) |
Zkontroluje, jestli je předaný znak platným znakem XML. |
| IsXmlSurrogatePair(Char, Char) |
Zkontroluje, jestli předaný náhradní pár znaků je platným znakem XML. |
| ToBoolean(String) | |
| ToByte(String) | |
| ToChar(String) | |
| ToDateTime(String, String) | |
| ToDateTime(String, String[]) | |
| ToDateTime(String, XmlDateTimeSerializationMode) |
Převede na String zadanou metodu DateTimeXmlDateTimeSerializationMode. |
| ToDateTime(String) |
Zastaralé.
Zastaralé.
|
| ToDateTimeOffset(String, String) |
Převede zadaný StringDateTimeOffset na ekvivalent. |
| ToDateTimeOffset(String, String[]) |
Převede zadaný StringDateTimeOffset na ekvivalent. |
| ToDateTimeOffset(String) |
Převede zadaný StringDateTimeOffset na ekvivalent. |
| 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) |
Převede na DateTime zadanou metodu StringXmlDateTimeSerializationMode. |
| ToString(DateTime) |
Zastaralé.
Zastaralé.
|
| ToString(DateTimeOffset, String) |
Převede zadaný DateTimeOffset formát na zadaný String formát. |
| ToString(DateTimeOffset) |
Převede zadané DateTimeOffset na .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) |
Ověřuje, že název je platný název podle doporučení jazyka W3C Extended Markup Language. |
| VerifyNCName(String) |
Ověřuje, že název je platný |
| VerifyNMTOKEN(String) |
Ověřuje, že řetězec je platným NMTOKEN podle části schématu W3C XML 2: Doporučení datových typů. |
| VerifyPublicId(String) |
Vrátí předanou instanci řetězce, pokud všechny znaky v řetězcovém argumentu jsou platné znaky veřejného ID. |
| VerifyTOKEN(String) |
Ověřuje, že řetězec je platný token podle části schématu W3C XML 2: Doporučení datových typů. |
| VerifyWhitespace(String) |
Vrátí předanou instanci řetězce, pokud jsou všechny znaky v argumentu řetězce platné prázdné znaky. |
| VerifyXmlChars(String) |
Vrátí předaný řetězec, pokud jsou všechny znaky a náhradní párové znaky v řetězcovém argumentu platné znaky XML, jinak |
