XmlReader.Create Metodo
Definizione
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.XmlReaderPublic Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReaderParametri
- 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 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.XmlReaderPublic Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReaderParametri
- 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. È 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
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.
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.XmlReaderPublic Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReaderParametri
- 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 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.
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.XmlReaderPublic Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReaderParametri
- 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:
- 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.XmlReaderPublic Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReaderParametri
- 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:
- 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.XmlReaderPublic Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReaderParametri
- 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:
- 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.XmlReaderPublic Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReaderParametri
- 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:
- 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.XmlReaderPublic Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReaderParametri
- 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:
- 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.XmlReaderPublic Shared Function Create (inputUri As String) As XmlReaderParametri
- 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 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
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)
- 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.XmlReaderPublic Shared Function Create (input As TextReader) As XmlReaderParametri
- 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 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 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.
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.XmlReaderPublic Shared Function Create (input As Stream) As XmlReaderParametri
- 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 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 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.
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.XmlReaderPublic Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReaderParametri
- 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 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
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.
