XmlReader.Create Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Origine:: XmlReader.cs

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

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.

Si applica a

Create(TextReader, XmlReaderSettings, XmlParserContext)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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

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);

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

Importante

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.

Si applica a

Create(Stream, XmlReaderSettings, XmlParserContext)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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

Il valore può essere null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.

Eccezioni

ArgumentNullException

Il valore input è null.

Commenti

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.

Si applica a

Create(Stream, XmlReaderSettings, String)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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

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

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.

Si applica a

Create(XmlReader, XmlReaderSettings)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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

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());

' 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

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.

Si applica a

Create(TextReader, XmlReaderSettings, String)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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

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

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.

Si applica a

Create(TextReader, XmlReaderSettings)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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

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

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.

Si applica a

Create(Stream, XmlReaderSettings)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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.

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

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.

Si applica a

Create(String)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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

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");

' Create the XmlReader object.
Dim reader As XmlReader = 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

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

Si applica a

Create(TextReader)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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

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));

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

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

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

Si applica a

Create(Stream)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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);

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.

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);

    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

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

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)

Origine:: XmlReader.cs

Origine:: XmlReader.cs

Origine:: XmlReader.cs

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

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()) {}

' 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

Importante

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

Condividi tramite

XmlReader.Create Metodo

Definizione

Overload

Commenti

Create(String, XmlReaderSettings, XmlParserContext)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Create(TextReader, XmlReaderSettings, XmlParserContext)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Create(Stream, XmlReaderSettings, XmlParserContext)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Create(Stream, XmlReaderSettings, String)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Create(XmlReader, XmlReaderSettings)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Create(TextReader, XmlReaderSettings, String)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Create(TextReader, XmlReaderSettings)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Create(Stream, XmlReaderSettings)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Create(String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Create(TextReader)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Create(Stream)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Create(String, XmlReaderSettings)

Parametri

Restituisce

Eccezioni