Classe XmlConvert (System.Xml)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Classe XmlConvert

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

Spazio dei nomi: System.Xml
Assembly: System.Xml (in system.xml.dll)

Sintassi

Visual Basic - (Dichiarazione)
Public Class XmlConvert
Visual Basic (Utilizzo)
Dim instance As XmlConvert

C#
public class XmlConvert
C++
public ref class XmlConvert
J#
public class XmlConvert
JScript
public class XmlConvert
Note

I nomi di elementi e attributi o i valori di ID sono limitati a un intervallo di caratteri XML conforme alle specifiche della versione 1.0 del linguaggio XML (Extensible Markup Language), seconda edizione, disponibili all'indirizzo www.w3.org/TR/2000/REC-xml-20001006.html (informazioni in lingua inglese). Quando i nomi contengono caratteri non validi, i metodi EncodeName e DecodeName vengono utilizzati per convertirli in nomi XML validi.

Molti linguaggi e applicazioni quali Microsoft SQL Server e Microsoft Word utilizzano nei nomi caratteri Unicode, non validi nei nomi XML. Se, ad esempio, in un database l'intestazione di una colonna è "Order Detail", nel database è possibile utilizzare lo spazio tra le parole Order e Detail. In XML, invece, lo spazio tra Order e Detail viene considerato un carattere XML non valido. Per questo motivo è necessario convertire lo spazio, un carattere non valido, in una codifica esadecimale escape che potrà essere decodificata in un secondo momento.

Il metodo EncodeName può essere utilizzato con la classe XmlWriter per assicurare che in nomi scritti siano nomi XML validi. Il seguente codice C# 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");

XmlConvert fornisce inoltre metodi che consentono la conversione da una stringa ad un tipo di dati .NET Framework e viceversa. Durante la conversione dei dati le impostazioni internazionali non vengono considerate. I tipi di dati si basano sui tipi di dati dello schema XML (XSD).

NotaNota

In .NET Framework versione 2.0, le classi XmlReader, XmlWriter e XPathNavigator includono nuovi metodi per la gestione dei dati tipizzati. I nuovi metodi gestiscono automaticamente la conversione della stringa in un tipo di dati .NET Framework.

Gerarchia di ereditarietà

System.Object
  System.Xml.XmlConvert
Codice thread safe

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.
Piattaforme

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0 1.1 1.0

.NET Compact Framework

Supportato in: 2.0 1.0
Vedere anche