XmlReader.Create Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Crea una nuova istanza di XmlReader.

Overload

Create(String, XmlReaderSettings, XmlParserContext)	Crea una nuova istanza di XmlReader con l'URI, le impostazioni e le informazioni di contesto specificati per l'analisi.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Crea una nuova istanza di XmlReader con il lettore di testo, le impostazioni e le informazioni di contesto specificati per l'analisi.
Create(Stream, XmlReaderSettings, XmlParserContext)	Crea una nuova istanza di XmlReader con il flusso, le impostazioni e le informazioni di contesto specificati per l'analisi.
Create(Stream, XmlReaderSettings, String)	Crea una nuova istanza di XmlReader con il flusso, l'URI di base e le impostazioni specificati.
Create(XmlReader, XmlReaderSettings)	Crea una nuova istanza di XmlReader con il lettore XML e le impostazioni specificate.
Create(TextReader, XmlReaderSettings, String)	Crea una nuova istanza di XmlReader con il lettore di testo, le impostazioni e l'URI di base specificati.
Create(TextReader, XmlReaderSettings)	Crea una nuova istanza di XmlReader con il lettore di testo e le impostazioni specificati.
Create(Stream, XmlReaderSettings)	Crea una nuova istanza di XmlReader con il flusso e le impostazioni specificati.
Create(String)	Crea una nuova istanza di XmlReader con l'URI specificato.
Create(TextReader)	Crea una nuova istanza di XmlReader con il lettore di testo specificato.
Create(Stream)	Crea una nuova istanza di XmlReader con il flusso specificato e le impostazioni predefinite.
Create(String, XmlReaderSettings)	Crea una nuova istanza di XmlReader con l'URI e le impostazioni specificati.

Commenti

Per altre informazioni su questa API, vedere Osservazioni api supplementari per XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con l'URI, le impostazioni e le informazioni di contesto specificati per l'analisi.

public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

Parametri

inputUri

String

URI del file che contiene i dati XML. L'oggetto XmlResolver nell'oggetto XmlReaderSettings viene usato per eseguire la conversione del percorso a una rappresentazione canonica dei dati. Se XmlResolver è null, viene usato un nuovo oggetto XmlUrlResolver.

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

inputContext

XmlParserContext

Informazioni sul contesto necessarie per analizzare il frammento XML. Le informazioni sul contesto possono includere l'oggetto XmlNameTable da usare, la codifica, l'ambito dello spazio dei nomi, gli ambiti xml:lang e xml:space correnti, l'URI di base e la definizione DTD.

Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore inputUri è null.

SecurityException

XmlReader non dispone di autorizzazioni sufficienti per accedere al percorso dei dati XML.

ArgumentException

Le proprietà NameTable e NameTable contengono entrambe valori. (È possibile impostare e usare solo una di queste proprietà NameTable).

FileNotFoundException

Non è possibile trovare il file specificato dall'URI.

UriFormatException

Il formato dell'URI non è corretto.

Commenti

Per impostazione predefinita, un XmlUrlResolver oggetto senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Ciò significa che può XmlReader accedere a tutti i percorsi che non richiedono l'autenticazione. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un XmlResolver oggetto con le credenziali necessarie.

Importante

È possibile limitare le risorse a cui può XmlReader accedere impostando la XmlResolver proprietà su un XmlSecureResolver oggetto .

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il lettore di testo, le impostazioni e le informazioni di contesto specificati per l'analisi.

public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

Parametri

input

TextReader

Lettore di testo da cui leggere i dati XML. Poiché un lettore di testo restituisce un flusso di caratteri Unicode, la codifica specificata nella dichiarazione XML non viene usata dal lettore XML per decodificare il flusso di dati.

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

inputContext

XmlParserContext

Informazioni sul contesto necessarie per analizzare il frammento XML. Le informazioni sul contesto possono includere l'oggetto XmlNameTable da usare, la codifica, l'ambito dello spazio dei nomi, gli ambiti xml:lang e xml:space correnti, l'URI di base e la definizione DTD.

Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

ArgumentException

Le proprietà NameTable e NameTable contengono entrambe valori. È possibile impostare e usare solo una di queste NameTable proprietà.

Esempio

Nell'esempio seguente viene creato un XmlReader oggetto che legge un frammento XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Commenti

Per impostazione predefinita, un XmlUrlResolver oggetto senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un XmlResolver oggetto con le credenziali necessarie.

Importante

È possibile usare uno dei metodi seguenti per controllare le risorse a XmlReader cui è possibile accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(Stream, XmlReaderSettings, XmlParserContext)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il flusso, le impostazioni e le informazioni di contesto specificati per l'analisi.

public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

Parametri

input

Stream

Flusso che contiene i dati XML.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica. Quando viene determinata, la codifica viene usata per continuare la lettura del flusso, mentre l'elaborazione continua ad analizzare l'input come flusso di caratteri (Unicode).

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

inputContext

XmlParserContext

Informazioni sul contesto necessarie per analizzare il frammento XML. Le informazioni sul contesto possono includere l'oggetto XmlNameTable da usare, la codifica, l'ambito dello spazio dei nomi, gli ambiti xml:lang e xml:space correnti, l'URI di base e la definizione DTD.

Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Commenti

Per impostazione predefinita, un XmlUrlResolver oggetto senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un XmlResolver oggetto con le credenziali necessarie.

Importante

È possibile usare uno dei metodi seguenti per controllare le risorse a XmlReader cui è possibile accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(Stream, XmlReaderSettings, String)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il flusso, l'URI di base e le impostazioni specificati.

public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);

Parametri

input

Stream

Flusso che contiene i dati XML.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica. Quando viene determinata, la codifica viene usata per continuare la lettura del flusso, mentre l'elaborazione continua ad analizzare l'input come flusso di caratteri (Unicode).

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

baseUri

String

URI di base relativo all'entità o al documento letto. Il valore può essere null.

Nota sulla sicurezza L'URI di base viene usato per risolvere l'URI relativo del documento XML. Non usare un URI di base proveniente da una fonte non attendibile.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Commenti

Per impostazione predefinita, un oggetto XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un oggetto XmlResolver con le credenziali necessarie.

Importante

È possibile usare uno dei metodi seguenti per controllare quali risorse possono XmlReader accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(XmlReader, XmlReaderSettings)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il lettore XML e le impostazioni specificate.

public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);

Parametri

reader

XmlReader

Oggetto da usare come lettore XML sottostante.

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.

Il livello di conformità dell'oggetto XmlReaderSettings deve corrispondere a quello del lettore sottostante o deve essere impostato su Auto.

Restituisce

XmlReader

Oggetto di cui è stato eseguito il wrapping intorno all'oggetto XmlReader specificato.

Eccezioni

ArgumentNullException

Il valore reader è null.

InvalidOperationException

Se l'oggetto XmlReaderSettings specifica un livello di conformità non coerente con quello del lettore sottostante.

-oppure-

L'oggetto XmlReader sottostante è in uno stato Error o Closed.

Esempio

Nell'esempio seguente viene creato un oggetto di convalida XmlReader che viene eseguito il wrapping intorno a un XmlNodeReader oggetto.

// Create the XmlNodeReader object.
XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XmlNodeReader nodeReader = new XmlNodeReader(doc);

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

// Create a validating reader that wraps the XmlNodeReader object.
XmlReader reader = XmlReader.Create(nodeReader, settings);
// Parse the XML file.
while (reader.Read());

Commenti

Questo metodo consente di aggiungere funzionalità aggiuntive a un oggetto sottostante XmlReader . L'oggetto sottostante XmlReader può essere un altro XmlReader oggetto creato dal metodo o un XmlReader oggetto creato usando una delle implementazioni concreteXmlReader.Create

Un valore predefinito senza credenziali viene usato per accedere a qualsiasi risorsa XmlUrlResolver esterna, ad esempio uno schema.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver oggetto con le credenziali necessarie usando la XmlReaderSettings.XmlResolver proprietà .

Importante

È possibile usare uno dei metodi seguenti per controllare quali risorse possono XmlReader accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(TextReader, XmlReaderSettings, String)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il lettore di testo, le impostazioni e l'URI di base specificati.

public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);

Parametri

input

TextReader

Lettore di testo da cui leggere i dati XML. Poiché un lettore di testo restituisce un flusso di caratteri Unicode, la codifica specificata nella dichiarazione XML non viene usata da XmlReader per decodificare il flusso di dati.

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

baseUri

String

URI di base relativo all'entità o al documento letto. Il valore può essere null.

Nota sulla sicurezza L'URI di base viene usato per risolvere l'URI relativo del documento XML. Non usare un URI di base proveniente da una fonte non attendibile.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Commenti

Per impostazione predefinita, un oggetto XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un oggetto XmlResolver con le credenziali necessarie.

Importante

È possibile usare uno dei metodi seguenti per controllare quali risorse possono XmlReader accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(TextReader, XmlReaderSettings)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il lettore di testo e le impostazioni specificati.

public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);

Parametri

input

TextReader

Lettore di testo da cui leggere i dati XML. Poiché un lettore di testo restituisce un flusso di caratteri Unicode, la codifica specificata nella dichiarazione XML non viene usata dal lettore XML per decodificare il flusso di dati.

settings

XmlReaderSettings

Impostazioni del nuovo oggetto XmlReader. Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Commenti

Per impostazione predefinita, un oggetto XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un oggetto XmlResolver con le credenziali necessarie.

Importante

È possibile usare uno dei metodi seguenti per controllare quali risorse possono XmlReader accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(Stream, XmlReaderSettings)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il flusso e le impostazioni specificati.

public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings);

Parametri

input

Stream

Flusso che contiene i dati XML.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica. Quando viene determinata, la codifica viene usata per continuare la lettura del flusso, mentre l'elaborazione continua ad analizzare l'input come flusso di caratteri (Unicode).

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Commenti

Per impostazione predefinita, un oggetto XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un oggetto XmlResolver con le credenziali necessarie.

Importante

È possibile usare uno dei metodi seguenti per controllare quali risorse possono XmlReader accedere:

• Limitando le risorse a cui la classe XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.

-oppure-

• Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(String)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con l'URI specificato.

public static System.Xml.XmlReader Create (string inputUri);

Parametri

inputUri

String

URI del file che contiene i dati XML. La classe XmlUrlResolver viene usata per convertire il percorso in una rappresentazione canonica dei dati.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore inputUri è null.

SecurityException

XmlReader non dispone di autorizzazioni sufficienti per accedere al percorso dei dati XML.

FileNotFoundException

Il file identificato dall'URI non esiste.

UriFormatException

Il formato dell'URI non è corretto.

Nota: in .NET per le app di Windows Store o la libreria di classi portabili, rilevare invece l'eccezione della classe di base, , FormatException.

Esempio

Nell'esempio seguente viene creato un oggetto che legge il XmlReader file di dati XML specificato dall'URI.

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

Commenti

Un XmlReaderSettings oggetto con impostazioni predefinite viene usato per creare il lettore. Se si desidera specificare le funzionalità da supportare nel lettore creato, usare l'overload che accetta un XmlReaderSettings oggetto come uno dei relativi argomenti e passare un XmlReaderSettings oggetto con le impostazioni corrette.

Un valore predefinito senza credenziali viene usato per accedere a qualsiasi risorsa XmlUrlResolver esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver oggetto con le credenziali necessarie usando la XmlReaderSettings.XmlResolver proprietà .

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(TextReader)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il lettore di testo specificato.

public static System.Xml.XmlReader Create (System.IO.TextReader input);

Parametri

input

TextReader

Lettore di testo da cui leggere i dati XML. Poiché un lettore di testo restituisce un flusso di caratteri Unicode, la codifica specificata nella dichiarazione XML non viene usata dal lettore XML per decodificare il flusso di dati.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Esempio

Nell'esempio seguente viene usata la StringReader classe per leggere una stringa XML.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Commenti

Un XmlReaderSettings oggetto con impostazioni predefinite viene usato per creare il lettore. Se si desidera specificare le funzionalità da supportare nel lettore creato, usare l'overload che accetta un XmlReaderSettings oggetto come uno dei relativi argomenti e passare un XmlReaderSettings oggetto con le impostazioni corrette.

Un valore predefinito senza credenziali viene usato per accedere a qualsiasi risorsa XmlUrlResolver esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver oggetto con le credenziali necessarie usando la XmlReaderSettings.XmlResolver proprietà .

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(Stream)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con il flusso specificato e le impostazioni predefinite.

public static System.Xml.XmlReader Create (System.IO.Stream input);

Parametri

input

Stream

Flusso che contiene i dati XML.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica. Quando viene determinata, la codifica viene usata per continuare la lettura del flusso, mentre l'elaborazione continua ad analizzare l'input come flusso di caratteri (Unicode).

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

SecurityException

XmlReader non dispone di autorizzazioni sufficienti per accedere al percorso dei dati XML.

Esempio

Nell'esempio seguente viene creato un XmlReader oggetto che legge da un FileStreamoggetto .

FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate,
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

Commenti

Un XmlReaderSettings oggetto con impostazioni predefinite viene usato per creare il lettore. Se si desidera specificare le funzionalità da supportare nel lettore creato, usare l'overload che accetta un XmlReaderSettings oggetto come uno dei relativi argomenti e passare un XmlReaderSettings oggetto con le impostazioni corrette.

Un valore predefinito senza credenziali viene usato per accedere a qualsiasi risorsa XmlUrlResolver esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver oggetto con le credenziali necessarie usando la XmlReaderSettings.XmlResolver proprietà .

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.

Create(String, XmlReaderSettings)

Origine:

XmlReader.cs

Crea una nuova istanza di XmlReader con l'URI e le impostazioni specificati.

public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings);

Parametri

inputUri

String

URI del file che contiene i dati XML. L'oggetto XmlResolver nell'oggetto XmlReaderSettings viene usato per eseguire la conversione del percorso a una rappresentazione canonica dei dati. Se XmlResolver è null, viene usato un nuovo oggetto XmlUrlResolver.

settings

XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader. Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore inputUri è null.

FileNotFoundException

Non è possibile trovare il file specificato dall'URI.

UriFormatException

Il formato dell'URI non è corretto.

Nota: in .NET per le app di Windows Store o la libreria di classi portabili, rilevare invece l'eccezione della classe di base, , FormatException.

Esempio

Nell'esempio seguente viene creato un oggetto che supporta la XmlReader convalida DTD (Document Type Definition).

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
settings.ValidationType = ValidationType.DTD;
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

 // Create the XmlReader object.
XmlReader reader = XmlReader.Create("itemDTD.xml", settings);

// Parse the file.
while (reader.Read()) {}

Commenti

Per impostazione predefinita, un oggetto XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una definizione del tipo di documento (DTD), entità, schemi e così via.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun valore predefinito XmlUrlResolver . Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare un XmlResolver oggetto usando la XmlReaderSettings.XmlResolver proprietà .

Ciò significa che l'oggetto XmlReader può accedere a qualsiasi posizione che non richiede l'autenticazione. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la XmlReaderSettings.XmlResolver proprietà per specificare un oggetto XmlResolver con le credenziali necessarie.

Importante

È possibile limitare le risorse a cui è XmlReader possibile accedere impostando la XmlResolver proprietà su un XmlSecureResolver oggetto.

L'oggetto creato XmlReader espande i riferimenti alle entità ed esegue la normalizzazione XML dei nuovi caratteri di riga.