XmlConvert Classe

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XmlConvert.cs

Codifica e decodifica i nomi XML e fornisce metodi per la conversione tra tipi Common Language Runtime e tipi XSD (XML Schema Definition Language). Quando si convertono tipi di dati, i valori restituiti sono indipendenti dalle impostazioni locali.

public ref class XmlConvert

public class XmlConvert

type XmlConvert = class

Public Class XmlConvert

Ereditarietà

Object

XmlConvert

Commenti

La XmlConvert classe è funzionalmente equivalente alla Convert classe , ma supporta gli standard XML. Il sistema dei tipi si basa sul tipo di schema XSD (XML Schema Definition Language) e i valori restituiti sono sempre indipendenti dalle impostazioni locali.

Codifica e decodifica

I nomi degli elementi e degli attributi o i valori ID sono limitati a un intervallo di caratteri XML in base alla raccomandazione W3C XML 1.0. Quando i nomi contengono caratteri non validi, è possibile utilizzare i EncodeName metodi e DecodeName in questa classe per convertirli in nomi XML validi.

Ad esempio, se si desidera utilizzare l'intestazione di colonna "Order Detail" in un database, il database consente lo spazio tra le due parole. In XML, tuttavia, lo spazio tra "Order" e "Detail" viene considerato un carattere XML non valido. È necessario convertirlo in una codifica esadecimale con caratteri di escape e decodificarlo in un secondo momento.

È possibile utilizzare il EncodeName metodo con la XmlWriter classe per assicurarsi che i nomi scritti siano nomi XML validi. Il codice C# seguente converte il nome "Order Detail" in un nome XML valido e scrive l'elemento <Order_0x0020_Detail>My order</Order_0x0020_Detail>.

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

I metodi seguenti XmlConvert eseguono la codifica e la decodifica.

metodo	Description
EncodeName	Accetta un nome e restituisce il nome codificato insieme a qualsiasi carattere non valido sostituito da una stringa di escape. Questo metodo consente i due punti in qualsiasi posizione, il che significa che il nome potrebbe essere ancora non valido in base alla raccomandazione W3C Namespaces in XML 1.0.
EncodeNmToken	Accetta un nome e restituisce il nome codificato.
EncodeLocalName	EncodeName È lo stesso a eccezione del fatto che codifica anche il carattere due punti, garantendo che il nome possa essere utilizzato come parte LocalName di un nome qualificato dallo spazio dei nomi.
DecodeName	Inverte la trasformazione per tutti i metodi di codifica.

Convalida dei nomi

La XmlConvert classe contiene due metodi che controllano i caratteri in un nome di elemento o attributo e verificano che il nome sia conforme alle regole impostate dalla raccomandazione W3C XML 1.0:

• VerifyName controlla i caratteri e verifica che il nome sia valido. Il metodo restituisce il nome se è valido e genera un'eccezione, se non lo è.
• VerifyNCName esegue la stessa convalida, ma accetta nomi non qualificati.

XmlConvert Contiene metodi aggiuntivi che convalidano token, spazi vuoti, ID pubblici e altre stringhe.

Conversione dei tipi di dati

XmlConvert fornisce anche metodi che consentono di convertire i dati da una stringa a un tipo di dati fortemente tipizzato. Ad esempio, il ToDateTime metodo converte una stringa nell'equivalente DateTime . Ciò è utile perché la maggior parte dei metodi della XmlReader classe restituisce dati come stringa. Dopo la lettura dei dati, è possibile convertirli nel tipo di dati appropriato prima di essere usati. Gli ToString overloads forniscono l'operazione complementare convertendo dati fortemente tipizzati in stringhe. Ad esempio, questo è utile quando si desidera aggiungere i dati alle caselle di testo in una pagina Web. Le impostazioni locali non vengono prese in considerazione durante la conversione dei dati. I tipi di dati sono basati sui tipi di dati XML Schema (XSD).

Costruttori

Nome	Descrizione
XmlConvert()	Inizializza una nuova istanza della classe XmlConvert.

Metodi

Nome	Descrizione
DecodeName(String)	Decodifica un nome. Questo metodo esegue l'inverso dei EncodeName(String) metodi e EncodeLocalName(String) .
EncodeLocalName(String)	Converte il nome in un nome locale XML valido.
EncodeName(String)	Converte il nome in un nome XML valido.
EncodeNmToken(String)	Verifica che il nome sia valido in base alla specifica XML.
IsNCNameChar(Char)	Controlla se il carattere passato è un tipo di carattere non due punti valido.
IsPublicIdChar(Char)	Restituisce l'istanza di caratteri passata se il carattere nell'argomento è un carattere ID pubblico valido; in caso contrario null, .
IsStartNCNameChar(Char)	Controlla se il carattere passato è un tipo di carattere nome iniziale valido.
IsWhitespaceChar(Char)	Controlla se il carattere passato è un carattere di spazio vuoto XML valido.
IsXmlChar(Char)	Controlla se il carattere passato è un carattere XML valido.
IsXmlSurrogatePair(Char, Char)	Controlla se la coppia di caratteri surrogati passati è un carattere XML valido.
ToBoolean(String)	Converte l'oggetto String in un Boolean oggetto equivalente.
ToByte(String)	Converte l'oggetto String in un Byte oggetto equivalente.
ToChar(String)	Converte l'oggetto String in un Char oggetto equivalente.
ToDateTime(String, String)	Converte l'oggetto String in un DateTime oggetto equivalente.
ToDateTime(String, String[])	Converte l'oggetto String in un DateTime oggetto equivalente.
ToDateTime(String, XmlDateTimeSerializationMode)	Converte in String un DateTime oggetto utilizzando l'oggetto XmlDateTimeSerializationMode specificato.
ToDateTime(String)	Obsoleti. Converte l'oggetto String in un DateTime oggetto equivalente.
ToDateTimeOffset(String, String)	Converte l'oggetto fornito String in un DateTimeOffset equivalente.
ToDateTimeOffset(String, String[])	Converte l'oggetto fornito String in un DateTimeOffset equivalente.
ToDateTimeOffset(String)	Converte l'oggetto fornito String in un DateTimeOffset equivalente.
ToDecimal(String)	Converte l'oggetto String in un Decimal oggetto equivalente.
ToDouble(String)	Converte l'oggetto String in un Double oggetto equivalente.
ToGuid(String)	Converte l'oggetto String in un Guid oggetto equivalente.
ToInt16(String)	Converte l'oggetto String in un Int16 oggetto equivalente.
ToInt32(String)	Converte l'oggetto String in un Int32 oggetto equivalente.
ToInt64(String)	Converte l'oggetto String in un Int64 oggetto equivalente.
ToSByte(String)	Converte l'oggetto String in un SByte oggetto equivalente.
ToSingle(String)	Converte l'oggetto String in un Single oggetto equivalente.
ToString(Boolean)	Converte l'oggetto in Boolean un oggetto String.
ToString(Byte)	Converte l'oggetto in Byte un oggetto String.
ToString(Char)	Converte l'oggetto in Char un oggetto String.
ToString(DateTime, String)	Converte l'oggetto in DateTime un oggetto String.
ToString(DateTime, XmlDateTimeSerializationMode)	Converte in DateTime un String oggetto utilizzando l'oggetto XmlDateTimeSerializationMode specificato.
ToString(DateTime)	Obsoleti. Converte l'oggetto in DateTime un oggetto String.
ToString(DateTimeOffset, String)	Converte l'oggetto fornito DateTimeOffset in un String oggetto nel formato specificato.
ToString(DateTimeOffset)	Converte l'oggetto fornito DateTimeOffset in un oggetto String.
ToString(Decimal)	Converte l'oggetto in Decimal un oggetto String.
ToString(Double)	Converte l'oggetto in Double un oggetto String.
ToString(Guid)	Converte l'oggetto in Guid un oggetto String.
ToString(Int16)	Converte l'oggetto in Int16 un oggetto String.
ToString(Int32)	Converte l'oggetto in Int32 un oggetto String.
ToString(Int64)	Converte l'oggetto in Int64 un oggetto String.
ToString(SByte)	Converte l'oggetto in SByte un oggetto String.
ToString(Single)	Converte l'oggetto in Single un oggetto String.
ToString(TimeSpan)	Converte l'oggetto in TimeSpan un oggetto String.
ToString(UInt16)	Converte l'oggetto in UInt16 un oggetto String.
ToString(UInt32)	Converte l'oggetto in UInt32 un oggetto String.
ToString(UInt64)	Converte l'oggetto in UInt64 un oggetto String.
ToTimeSpan(String)	Converte l'oggetto String in un TimeSpan oggetto equivalente.
ToUInt16(String)	Converte l'oggetto String in un UInt16 oggetto equivalente.
ToUInt32(String)	Converte l'oggetto String in un UInt32 oggetto equivalente.
ToUInt64(String)	Converte l'oggetto String in un UInt64 oggetto equivalente.
VerifyName(String)	Verifica che il nome sia un nome valido in base alla raccomandazione W3C Extended Markup Language.
VerifyNCName(String)	Verifica che il nome sia valido NCName in base alla raccomandazione W3C Extended Markup Language. È NCName un nome che non può contenere due punti.
VerifyNMTOKEN(String)	Verifica che la stringa sia un NMTOKEN valido in base alla raccomandazione W3C XML Schema Part2: Datatypes.
VerifyPublicId(String)	Restituisce l'oggetto passato nell'istanza di stringa se tutti i caratteri nell'argomento stringa sono caratteri ID pubblici validi.
VerifyTOKEN(String)	Verifica che la stringa sia un token valido in base alla raccomandazione W3C XML Schema Part2: Datatypes.
VerifyWhitespace(String)	Restituisce l'istanza di stringa passata se tutti i caratteri nell'argomento stringa sono caratteri di spazio vuoto validi.
VerifyXmlChars(String)	Restituisce la stringa passata se tutti i caratteri e i caratteri della coppia di surrogati nell'argomento stringa sono caratteri XML validi, in caso contrario viene generata un'eccezione XmlException con informazioni sul primo carattere non valido rilevato.