XmlReader.Create Metodo

Definizione

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 La sezione note sulle API supplementari per XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

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(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

Il valore inputUri è null.

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

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

Non è possibile trovare il file specificato dall'URI.

Il formato dell'URI non è corretto.

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.

Si applica a

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.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

Il valore input è null.

Le proprietà NameTable e NameTable contengono entrambe valori. Solo una di queste NameTable proprietà può essere impostata e usata.

Esempio

Nell'esempio seguente viene creato un oggetto che legge un XmlReader 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);
Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

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:

-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.

Si applica a

Create(Stream, XmlReaderSettings, XmlParserContext)

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);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

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:

-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.

Si applica a

Create(Stream, XmlReaderSettings, String)

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, System::String ^ baseUri);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

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:

-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.

Si applica a

Create(XmlReader, XmlReaderSettings)

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);
public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);
static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

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

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

Eccezioni

Il valore reader è null.

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());
' Create the XmlNodeReader object.
Dim doc As New XmlDocument()
doc.Load("books.xml")
Dim nodeReader As New XmlNodeReader(doc)

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create a validating reader that wraps the XmlNodeReader object.
Dim reader As XmlReader = XmlReader.Create(nodeReader, settings)
' Parse the XML file.
While reader.Read()
End While

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:

-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.

Si applica a

Create(TextReader, XmlReaderSettings, String)

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, System::String ^ baseUri);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

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:

-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.

Si applica a

Create(TextReader, XmlReaderSettings)

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);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

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:

-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.

Si applica a

Create(Stream, XmlReaderSettings)

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);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

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:

-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.

Si applica a

Create(String)

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

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);
public static System.Xml.XmlReader Create (string inputUri);
static member Create : string -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

Il valore inputUri è null.

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

Il file identificato dall'URI non esiste.

Il formato dell'URI non è corretto.

Nota: in .NET per le app di Windows Store o nella libreria di classi portabile intercettare invece l'eccezione della classe di base, FormatException, .

Esempio

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

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

Commenti

Per creare il lettore viene usato un XmlReaderSettings oggetto con impostazioni predefinite. 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.

Si applica a

Create(TextReader)

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);
public static System.Xml.XmlReader Create (System.IO.TextReader input);
static member Create : System.IO.TextReader -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

Il valore input è null.

Esempio

Nell'esempio seguente viene utilizzata 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));
Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

Commenti

Per creare il lettore viene usato un XmlReaderSettings oggetto con impostazioni predefinite. 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.

Si applica a

Create(Stream)

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

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);
public static System.Xml.XmlReader Create (System.IO.Stream input);
static member Create : System.IO.Stream -> System.Xml.XmlReader
Public Shared Function Create (input As Stream) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

Il valore input è null.

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 oggetto FileStream.


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

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);
    Dim fs As New FileStream("C:\data\books.xml", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
    
    ' Create the XmlReader object.
    Dim reader As XmlReader = XmlReader.Create(fs)

End Sub

Commenti

Per creare il lettore viene usato un XmlReaderSettings oggetto con impostazioni predefinite. 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.

Si applica a

Create(String, XmlReaderSettings)

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

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings);
static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

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

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

Il valore inputUri è null.

Non è possibile trovare il file specificato dall'URI.

Il formato dell'URI non è corretto.

Nota: in .NET per le app di Windows Store o nella libreria di classi portabile intercettare invece l'eccezione della classe di base, FormatException, .

Esempio

Nell'esempio seguente viene creato un XmlReader oggetto che supporta la 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()) {}
' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
settings.ValidationType = ValidationType.DTD
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("itemDTD.xml", settings)

' Parse the file. 
While reader.Read()
End While

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.

Si applica a