XmlConvert Osztály

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlConvert.cs

Kódolja és dekódolja az XML-neveket, és metódusokat biztosít a közös nyelvi futtatókörnyezet-típusok és az XML-sémadefiníciós nyelv (XSD) típusai közötti konvertáláshoz. Adattípusok konvertálásakor a visszaadott értékek területi beállításoktól függetlenek.

public ref class XmlConvert

public class XmlConvert

type XmlConvert = class

Public Class XmlConvert

Öröklődés

Object

XmlConvert

Megjegyzések

Az XmlConvert osztály funkcionálisan egyenértékű az osztálysal, de támogatja az Convert XML-szabványokat. A típusrendszer az XML-sémadefiníciós nyelv (XSD) sématípusán alapul, és a visszaadott értékek területi beállításoktól függetlenek.

Kódolás és dekódolás

Az elem- és attribútumnevek vagy azonosítóértékek a W3C XML 1.0-javaslatnak megfelelően XML-karakterek tartományára korlátozódnak. Ha a nevek érvénytelen karaktereket tartalmaznak, az ebben az EncodeNameDecodeName osztályban található metódusokkal érvényes XML-nevekké fordíthatja őket.

Ha például az "Order Detail" oszlopfejlécet szeretné használni egy adatbázisban, az adatbázis lehetővé teszi a két szó közötti térközt. Az XML-ben azonban az "Order" és a "Detail" közötti térköz érvénytelen XML-karakternek minősül. Át kell alakítania escape-olt hexadecimális kódolássá, és később dekódolnia kell.

A metódust az EncodeNameXmlWriter osztály használatával is használhatja annak ellenőrzésére, hogy az írott nevek érvényes XML-nevek-e. A következő C#-kód az "Order Detail" nevet egy érvényes XML-névvé alakítja, és megírja az elemet <Order_0x0020_Detail>My order</Order_0x0020_Detail>.

writer.WriteElementString(XmlConvert.EncodeName("Order Detail"),"My order");

Az alábbi XmlConvert metódusok kódolást és dekódolást végeznek.

Módszer	Description
EncodeName	Megkap egy nevet, és visszaadja a kódolt nevet az érvénytelen karakterekkel együtt, amelyeket escape szekvenciára cseréltek. Ez a módszer lehetővé teszi a kettőspontokat bármely pozícióban, ami azt jelenti, hogy a név még mindig érvénytelen lehet a W3C ajánlása szerint a névterek számára az XML 1.0-ban.
EncodeNmToken	Nevet vesz fel, és visszaadja a kódolt nevet.
EncodeLocalName	Ugyanaz, mint a EncodeName, azzal a különbséggel, hogy a kettőspont karaktert is kódolja, garantálva, hogy a név névtérrel minősített név részeként használható legyen LocalName.
DecodeName	Megfordítja az átalakítást az összes kódolási módszer esetében.

Névérvényesítés

Az XmlConvert osztály két metódust tartalmaz, amelyek ellenőrzik egy elem vagy attribútum nevének karaktereit, és ellenőrzik, hogy a név megfelel-e a W3C XML 1.0-javaslat által meghatározott szabályoknak:

• VerifyName ellenőrzi a karaktereket, és ellenőrzi, hogy a név érvényes-e. A metódus visszaadja a nevet, ha érvényes, és kivételt ad, ha nem.
• VerifyNCName Ugyanezt az ellenőrzést hajtja végre, de nem minősített neveket fogad el.

Ez XmlConvert további metódusokat tartalmaz, amelyek érvényesítik a tokeneket, a szóköz karaktereket, a nyilvános azonosítókat és más sztringeket.

Adattípus-átalakítás

XmlConvert olyan módszereket is biztosít, amelyek lehetővé teszik, hogy az adatokat sztringből erősen típusos adattípussá alakítsa át. Például a ToDateTime metódus egy sztringet annak DateTime megfelelőjévé alakít át. Ez azért hasznos, mert az osztály legtöbb metódusa sztringként adja vissza az XmlReader adatokat. Az adatok olvasása után használat előtt a megfelelő adattípussá alakítható át. A ToString túlterhelések az erősen gépelt adatok karakterláncokká alakításával biztosítják a kiegészítő műveletet. Ez például akkor hasznos, ha egy weblap szövegmezőibe szeretné felvenni az adatokat. A területi beállításokat nem veszi figyelembe az adatkonvertálás során. Az adattípusok az XML-séma (XSD) adattípusán alapulnak.

Konstruktorok

Name	Description
XmlConvert()	Inicializálja a XmlConvert osztály új példányát.

Metódusok

Name	Description
DecodeName(String)	Név dekódolása. Ez a metódus az és EncodeName(String) a metódusok fordítottját hajtja EncodeLocalName(String) végre.
EncodeLocalName(String)	A nevet érvényes XML-helyi névvé alakítja át.
EncodeName(String)	A nevet érvényes XML-névvé alakítja.
EncodeNmToken(String)	Ellenőrzi, hogy a név az XML-specifikációnak megfelelően érvényes-e.
IsNCNameChar(Char)	Ellenőrzi, hogy a beadott karakter érvényes nem kettőspont típusú-e.
IsPublicIdChar(Char)	Az átadott karakterpéldányt adja vissza, ha az argumentumban szereplő karakter érvényes nyilvános azonosító karakter, ellenkező esetben null.
IsStartNCNameChar(Char)	Ellenőrzi, hogy a beadott karakter érvényes kezdőnév karaktertípus-e.
IsWhitespaceChar(Char)	Ellenőrzi, hogy a beadott karakter érvényes XML-szóköz karakter-e.
IsXmlChar(Char)	Ellenőrzi, hogy a beadott karakter érvényes XML-karakter-e.
IsXmlSurrogatePair(Char, Char)	Ellenőrzi, hogy az átadott helyettesítő karakterpár érvényes XML-karakter-e.
ToBoolean(String)	Ezzel egyenértékűvé alakítja a String függvényt Boolean .
ToByte(String)	Ezzel egyenértékűvé alakítja a String függvényt Byte .
ToChar(String)	Ezzel egyenértékűvé alakítja a String függvényt Char .
ToDateTime(String, String)	Ezzel egyenértékűvé alakítja a String függvényt DateTime .
ToDateTime(String, String[])	Ezzel egyenértékűvé alakítja a String függvényt DateTime .
ToDateTime(String, XmlDateTimeSerializationMode)	String DateTime A megadott használatával konvertálja a XmlDateTimeSerializationMode elemet.
ToDateTime(String)	Elavult. Ezzel egyenértékűvé alakítja a String függvényt DateTime .
ToDateTimeOffset(String, String)	A megadott String érték konvertálása egyenértékűvé DateTimeOffset .
ToDateTimeOffset(String, String[])	A megadott String érték konvertálása egyenértékűvé DateTimeOffset .
ToDateTimeOffset(String)	A megadott String érték konvertálása egyenértékűvé DateTimeOffset .
ToDecimal(String)	Ezzel egyenértékűvé alakítja a String függvényt Decimal .
ToDouble(String)	Ezzel egyenértékűvé alakítja a String függvényt Double .
ToGuid(String)	Ezzel egyenértékűvé alakítja a String függvényt Guid .
ToInt16(String)	Ezzel egyenértékűvé alakítja a String függvényt Int16 .
ToInt32(String)	Ezzel egyenértékűvé alakítja a String függvényt Int32 .
ToInt64(String)	Ezzel egyenértékűvé alakítja a String függvényt Int64 .
ToSByte(String)	Ezzel egyenértékűvé alakítja a String függvényt SByte .
ToSingle(String)	Ezzel egyenértékűvé alakítja a String függvényt Single .
ToString(Boolean)	Átalakítja a Boolean elemet egy String.
ToString(Byte)	Átalakítja a Byte elemet egy String.
ToString(Char)	Átalakítja a Char elemet egy String.
ToString(DateTime, String)	Átalakítja a DateTime elemet egy String.
ToString(DateTime, XmlDateTimeSerializationMode)	DateTime String A megadott használatával konvertálja a XmlDateTimeSerializationMode elemet.
ToString(DateTime)	Elavult. Átalakítja a DateTime elemet egy String.
ToString(DateTimeOffset, String)	A megadott formátumot konvertálja a megadott DateTimeOffsetString formátumra.
ToString(DateTimeOffset)	A megadott DateTimeOffset adatokat átalakítja egy String.
ToString(Decimal)	Átalakítja a Decimal elemet egy String.
ToString(Double)	Átalakítja a Double elemet egy String.
ToString(Guid)	Átalakítja a Guid elemet egy String.
ToString(Int16)	Átalakítja a Int16 elemet egy String.
ToString(Int32)	Átalakítja a Int32 elemet egy String.
ToString(Int64)	Átalakítja a Int64 elemet egy String.
ToString(SByte)	Átalakítja a SByte elemet egy String.
ToString(Single)	Átalakítja a Single elemet egy String.
ToString(TimeSpan)	Átalakítja a TimeSpan elemet egy String.
ToString(UInt16)	Átalakítja a UInt16 elemet egy String.
ToString(UInt32)	Átalakítja a UInt32 elemet egy String.
ToString(UInt64)	Átalakítja a UInt64 elemet egy String.
ToTimeSpan(String)	Ezzel egyenértékűvé alakítja a String függvényt TimeSpan .
ToUInt16(String)	Ezzel egyenértékűvé alakítja a String függvényt UInt16 .
ToUInt32(String)	Ezzel egyenértékűvé alakítja a String függvényt UInt32 .
ToUInt64(String)	Ezzel egyenértékűvé alakítja a String függvényt UInt64 .
VerifyName(String)	Ellenőrzi, hogy a név érvényes-e a W3C kiterjesztett korrektúranyelv-javaslatának megfelelően.
VerifyNCName(String)	Ellenőrzi, hogy a név érvényes-e NCName a W3C Extended Markup Language javaslatának megfelelően. Az an NCName olyan név, amely nem tartalmazhat kettőspontot.
VerifyNMTOKEN(String)	Ellenőrzi, hogy a sztring érvényes NMTOKEN-e a W3C XML-séma 2. rész: Adattípusok javaslatának megfelelően.
VerifyPublicId(String)	Az átadott karakterláncpéldányt adja vissza, ha a karakterlánc argumentumban szereplő összes karakter érvényes nyilvános azonosító karakter.
VerifyTOKEN(String)	Ellenőrzi, hogy a sztring érvényes jogkivonat-e a W3C XML Schema Part2: Datatypes javaslatának megfelelően.
VerifyWhitespace(String)	Az átadott sztringpéldányt adja vissza, ha a sztringargumentum összes karaktere érvényes szóköz karakter.
VerifyXmlChars(String)	Az átadott sztringet adja vissza, ha a sztring argumentumban szereplő összes karakter és helyettesítő pár karakter érvényes XML-karakter, ellenkező esetben az XmlException első érvénytelen karakter adatai jelennek meg.