XmlConvert Klas

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.ReaderWriter.dll
Assembly's:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs
Bron:
XmlConvert.cs

Xml-namen coderen en decoderen en biedt methoden voor het converteren tussen algemene runtimetypen voor talen en XSD-typen (XML Schema Definition Language). Bij het converteren van gegevenstypen zijn de geretourneerde waarden onafhankelijk van landinstellingen.

public ref class XmlConvert abstract sealed
public ref class XmlConvert
public static class XmlConvert
public class XmlConvert
type XmlConvert = class
Public Class XmlConvert
Overname
Object
XmlConvert

Opmerkingen

De XmlConvert klasse is functioneel gelijk aan de Convert klasse, maar ondersteunt XML-standaarden. Het typesysteem is gebaseerd op het XSD-schematype (XML Schema Definition Language) en de geretourneerde waarden zijn altijd onafhankelijk van landinstellingen.

Codering en decodering

Element- en kenmerknamen of id-waarden zijn beperkt tot een bereik van XML-tekens volgens de W3C XML 1.0-aanbeveling. Wanneer namen ongeldige tekens bevatten, kunt u de EncodeName en DecodeName methoden in deze klasse gebruiken om ze te vertalen in geldige XML-namen.

Als u bijvoorbeeld de kolomkop 'Orderdetails' in een database wilt gebruiken, staat de database de ruimte tussen de twee woorden toe. In XML wordt de ruimte tussen 'Volgorde' en 'Detail' echter beschouwd als een ongeldig XML-teken. U moet het omzetten naar een geëscapete hexadecimale codering en het later decoderen.

U kunt de EncodeName methode met de XmlWriter klasse gebruiken om ervoor te zorgen dat de namen die worden geschreven geldige XML-namen zijn. Met de volgende C#-code wordt de naam Orderdetail geconverteerd naar een geldige XML-naam en wordt het element <Order_0x0020_Detail>My order</Order_0x0020_Detail>geschreven.

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

De volgende XmlConvert methoden voeren codering en decodering uit.

Methode Description
EncodeName Neemt een naam en retourneert de gecodeerde naam samen met een ongeldig teken dat wordt vervangen door een escape-tekenreeks. Met deze methode kunnen dubbele punten in elke positie voorkomen, wat betekent dat de naam mogelijk nog steeds ongeldig is volgens de W3C-aanbeveling 'Namespaces in XML 1.0'.
EncodeNmToken Neemt een naam en retourneert de gecodeerde naam.
EncodeLocalName Hetzelfde als EncodeName, behalve dat het ook het dubbele punt codeert, wat garandeert dat de naam kan worden gebruikt als LocalName deel van een gekwalificeerde naam van een naamruimte.
DecodeName Hiermee wordt de transformatie voor alle coderingsmethoden omgekeerd.

Naamvalidatie

De XmlConvert klasse bevat twee methoden die de tekens in een element- of kenmerknaam controleren en controleren of de naam voldoet aan de regels die zijn ingesteld door de aanbeveling W3C XML 1.0:

  • VerifyName controleert de tekens en controleert of de naam geldig is. De methode retourneert de naam als deze geldig is en genereert een uitzondering als dit niet het juiste is.
  • VerifyNCName voert dezelfde validatie uit, maar accepteert niet-gekwalificeerde namen.

De XmlConvert bevat aanvullende methoden waarmee tokens, spatietekens, openbare id's en andere tekenreeksen worden gevalideerd.

Conversie van gegevenstype

XmlConvert biedt ook methoden waarmee u gegevens van een tekenreeks kunt converteren naar een sterk getypt gegevenstype. Met de ToDateTime methode wordt bijvoorbeeld een tekenreeks geconverteerd naar het DateTime equivalent ervan. Dit is handig omdat de meeste methoden in de XmlReader klasse gegevens retourneren als een tekenreeks. Nadat de gegevens zijn gelezen, kunnen deze worden geconverteerd naar het juiste gegevenstype voordat ze worden gebruikt. De ToString overbelastingen bieden de complementaire bewerking door sterk getypte gegevens te converteren naar tekenreeksen. Dit is bijvoorbeeld handig wanneer u de gegevens wilt toevoegen aan tekstvakken op een webpagina. Er wordt geen rekening gehouden met landinstellingen tijdens de gegevensconversie. De gegevenstypen zijn gebaseerd op de XSD-gegevenstypen (XML Schema).

Constructors

Name Description
XmlConvert()

Initialiseert een nieuw exemplaar van de XmlConvert klasse.

Methoden

Name Description
DecodeName(String)

Decodeert een naam. Deze methode doet het omgekeerde van de EncodeName(String) en EncodeLocalName(String) methoden.
EncodeLocalName(String)

Converteert de naam naar een geldige lokale XML-naam.
EncodeName(String)

Converteert de naam naar een geldige XML-naam.
EncodeNmToken(String)

Controleert of de naam geldig is volgens de XML-specificatie.
IsNCNameChar(Char)

Hiermee wordt gecontroleerd of het doorgegeven teken een geldig type niet-dubbele punt is.
IsPublicIdChar(Char)

Retourneert het doorgegeven tekenexemplaren als het teken in het argument een geldig openbaar id-teken is, anders null.
IsStartNCNameChar(Char)

Controleert of het doorgegeven teken een geldig type Beginnaam is.
IsWhitespaceChar(Char)

Controleert of het doorgegeven teken een geldig XML-witruimteteken is.
IsXmlChar(Char)

Controleert of het doorgegeven teken een geldig XML-teken is.
IsXmlSurrogatePair(Char, Char)

Controleert of het doorgegeven surrogaatpaar een geldig XML-teken is.
ToBoolean(String)

Converteert het String naar een Boolean equivalent.
ToByte(String)

Converteert het String naar een Byte equivalent.
ToChar(String)

Converteert het String naar een Char equivalent.
ToDateTime(String, String)

Converteert het String naar een DateTime equivalent.
ToDateTime(String, String[])

Converteert het String naar een DateTime equivalent.
ToDateTime(String, XmlDateTimeSerializationMode)

Converteert de String naar een DateTime met behulp van de XmlDateTimeSerializationMode opgegeven waarde.
ToDateTime(String)
Verouderd.
Verouderd.

Converteert het String naar een DateTime equivalent.
ToDateTimeOffset(String, String)

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.
ToDateTimeOffset(String, String[])

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.
ToDateTimeOffset(String)

Converteert de opgegeven String waarde naar een DateTimeOffset equivalent.
ToDecimal(String)

Converteert het String naar een Decimal equivalent.
ToDouble(String)

Converteert het String naar een Double equivalent.
ToGuid(String)

Converteert het String naar een Guid equivalent.
ToInt16(String)

Converteert het String naar een Int16 equivalent.
ToInt32(String)

Converteert het String naar een Int32 equivalent.
ToInt64(String)

Converteert het String naar een Int64 equivalent.
ToSByte(String)

Converteert het String naar een SByte equivalent.
ToSingle(String)

Converteert het String naar een Single equivalent.
ToString(Boolean)

Converteert de Boolean naar een String.
ToString(Byte)

Converteert de Byte naar een String.
ToString(Char)

Converteert de Char naar een String.
ToString(DateTime, String)

Converteert de DateTime naar een String.
ToString(DateTime, XmlDateTimeSerializationMode)

Converteert de DateTime naar een String met behulp van de XmlDateTimeSerializationMode opgegeven waarde.
ToString(DateTime)
Verouderd.
Verouderd.

Converteert de DateTime naar een String.
ToString(DateTimeOffset, String)

Converteert de opgegeven DateTimeOffset indeling naar een String in de opgegeven indeling.
ToString(DateTimeOffset)

Converteert de opgegeven DateTimeOffset naar een String.
ToString(Decimal)

Converteert de Decimal naar een String.
ToString(Double)

Converteert de Double naar een String.
ToString(Guid)

Converteert de Guid naar een String.
ToString(Int16)

Converteert de Int16 naar een String.
ToString(Int32)

Converteert de Int32 naar een String.
ToString(Int64)

Converteert de Int64 naar een String.
ToString(SByte)

Converteert de SByte naar een String.
ToString(Single)

Converteert de Single naar een String.
ToString(TimeSpan)

Converteert de TimeSpan naar een String.
ToString(UInt16)

Converteert de UInt16 naar een String.
ToString(UInt32)

Converteert de UInt32 naar een String.
ToString(UInt64)

Converteert de UInt64 naar een String.
ToTimeSpan(String)

Converteert het String naar een TimeSpan equivalent.
ToUInt16(String)

Converteert het String naar een UInt16 equivalent.
ToUInt32(String)

Converteert het String naar een UInt32 equivalent.
ToUInt64(String)

Converteert het String naar een UInt64 equivalent.
VerifyName(String)

Controleert of de naam een geldige naam is volgens de W3C Extended Markup Language-aanbeveling.
VerifyNCName(String)

Controleert of de naam geldig NCName is volgens de W3C Extended Markup Language-aanbeveling. Een NCName is een naam die geen dubbele punt kan bevatten.
VerifyNMTOKEN(String)

Controleert of de tekenreeks een geldig NMTOKEN is volgens het W3C XML-schemaonderdeel2: aanbeveling voor gegevenstypen.
VerifyPublicId(String)

Retourneert het doorgegeven tekenreeksexemplaren als alle tekens in het tekenreeksargument geldige openbare id-tekens zijn.
VerifyTOKEN(String)

Controleert of de tekenreeks een geldig token is volgens het W3C XML-schema deel2: aanbeveling voor gegevenstypen.
VerifyWhitespace(String)

Retourneert het doorgegeven tekenreeksexemplaren als alle tekens in het tekenreeksargument geldige spaties zijn.
VerifyXmlChars(String)

Retourneert de doorgegeven tekenreeks als alle tekens en surrogaatpaartekens in het tekenreeksargument geldige XML-tekens zijn, anders wordt er een XmlException gegenereerd met informatie over het eerste ongeldige teken.

Van toepassing op