System.Xml.XmlConvert – třída

Tento článek obsahuje doplňující poznámky k referenční dokumentaci pro toto rozhraní API.

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	Popis
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).