XmlReader.Create Metodo

Definizione

Crea una nuova istanza di XmlReader.Creates a new XmlReader instance.

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.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

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.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext)

Crea una nuova istanza di XmlReader con il flusso, le impostazioni e le informazioni di contesto specificati per l'analisi.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String)

Crea una nuova istanza di XmlReader con il flusso, l'URI di base e le impostazioni specificati.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings)

Crea una nuova istanza di XmlReader con il lettore XML e le impostazioni specificate.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String)

Crea una nuova istanza di XmlReader con il lettore di testo, le impostazioni e l'URI di base specificati.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings)

Crea una nuova istanza di XmlReader con il lettore di testo e le impostazioni specificati.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings)

Crea una nuova istanza di XmlReader con il flusso e le impostazioni specificati.Creates a new XmlReader instance with the specified stream and settings.

Create(String)

Crea una nuova istanza di XmlReader con l'URI specificato.Creates a new XmlReader instance with specified URI.

Create(TextReader)

Crea una nuova istanza di XmlReader con il lettore di testo specificato.Creates a new XmlReader instance by using the specified text reader.

Create(Stream)

Crea una nuova istanza di XmlReader con il flusso specificato e le impostazioni predefinite.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings)

Crea una nuova istanza di XmlReader con l'URI e le impostazioni specificati.Creates a new XmlReader instance by using the specified URI and settings.

Esempio

In questo esempio viene creato un lettore XML che rimuove gli spazi vuoti non significativi, rimuove i commenti ed esegue il controllo della conformità a livello di frammento.This example creates an XML reader that strips insignificant white space, strips comments, and performs fragment-level conformance checking.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

Nell'esempio seguente viene usato un XmlUrlResolver con credenziali predefinite per accedere a un file.The following example uses an XmlUrlResolver with default credentials to access a file.

// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;
' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true
// Create a resolver with default credentials.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
resolver->Credentials = System::Net::CredentialCache::DefaultCredentials;

 // Set the reader settings object to use the resolver.
 settings->XmlResolver = resolver;

// Create the XmlReader object.
XmlReader^ reader = XmlReader::Create( L"http://ServerName/data/books.xml", settings );

// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the reader settings object to use the resolver.
settings.XmlResolver = resolver;

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);
' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

Il codice seguente esegue il wrapping di un'istanza del lettore all'interno di un altro Reader.The following code wraps a reader instance within another reader.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

Questo esempio Concatena i Reader per aggiungere la DTD e la convalida XML Schema.This example chains readers to add DTD and XML schema validation.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

Commenti

La maggior parte degli overload di Create include un parametro di settings che accetta un oggetto XmlReaderSettings.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. È possibile utilizzare questo oggetto per:You can use this object to:

  • Specificare le funzionalità che si desidera supportare nell'oggetto XmlReader.Specify which features you want supported on the XmlReader object.

  • Riutilizzare l'oggetto XmlReaderSettings per creare più Reader.Reuse the XmlReaderSettings object to create multiple readers. In tal modo è possibile utilizzare le stesse impostazioni per creare più lettori con la stessa funzionalità.You can use the same settings to create multiple readers with the same functionality. In alternativa, è possibile modificare le impostazioni in un'istanza di XmlReaderSettings e creare un nuovo Reader con un set di funzionalità diverso.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • Aggiungere funzionalità a un lettore XML esistente.Add features to an existing XML reader. Il metodo Create può accettare un altro oggetto XmlReader.The Create method can accept another XmlReader object. L'oggetto XmlReader sottostante può essere un reader definito dall'utente, un oggetto XmlTextReader o un'altra istanza di XmlReader a cui si desidera aggiungere altre funzionalità.The underlying XmlReader object can be a user-defined reader, a XmlTextReader object, or another XmlReader instance that you want to add additional features to.

  • È possibile sfruttare appieno le funzionalità, ad esempio il controllo della conformità migliore e la conformità alla raccomandazione XML 1,0 (quarta edizione) , disponibile solo su XmlReader oggetti creati dal metodo Create statico.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 (fourth edition) recommendation that are available only on XmlReader objects created by the static Create method.

Nota

Sebbene il .NET Framework includa implementazioni concrete della classe XmlReader, ad esempio XmlTextReader, XmlNodeReadere le classi XmlValidatingReader, è consigliabile creare istanze di XmlReader usando il metodo Create.Although the .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, we recommend that you create XmlReader instances by using the Create method.

Impostazioni predefiniteDefault settings

Se si usa un overload Create che non accetta un oggetto XmlReaderSettings, vengono usate le impostazioni del lettore predefinite seguenti:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

ImpostazioneSetting PredefinitoDefault
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas Oggetto XmlSchemaSet vuoto.An empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraints abilitatoProcessIdentityConstraints enabled
ValidationType None
XmlResolver Nuovo oggetto XmlUrlResolver.A new XmlUrlResolver object. A partire da .NET Framework 4.5.2, il valore predefinito di questa impostazione è null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Impostazioni per scenari comuniSettings for common scenarios

Di seguito sono riportate le proprietà di XmlReaderSettings che è necessario impostare per alcuni degli scenari di lettura XML tipici.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

RequisitoRequirement ConfigurazioneSet
I dati devono essere un documento XML ben formato.Data must be a well-formed XML document. ConformanceLevel Document.ConformanceLevel to Document.
I dati devono essere un'entità analizzata XML ben formata.Data must be a well-formed XML parsed entity. ConformanceLevel Fragment.ConformanceLevel to Fragment.
I dati devono essere convalidati rispetto a una DTD.Data must be validated against a DTD. Da DtdProcessing a ParseDtdProcessing to Parse
ValidationType DTD.ValidationType to DTD.
I dati devono essere convalidati in base a un XML Schema.Data must be validated against an XML schema. Da ValidationType a SchemaValidationType to Schema
Schemas al XmlSchemaSet da utilizzare per la convalida.Schemas to the XmlSchemaSet to use for validation. Si noti che XmlReader non supporta la convalida dello schema XDR (XML-Data Reduced).Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
I dati devono essere convalidati in base a un XML Schema inline.Data must be validated against an inline XML schema. Da ValidationType a SchemaValidationType to Schema
ValidationFlags ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Supporto del tipo.Type support. Da ValidationType a SchemaValidationType to Schema
Schemas al XmlSchemaSet da utilizzare.Schemas to the XmlSchemaSet to use.

XmlReader non supporta la convalida dello schema XDR (XML-Data Reduced).XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

Programmazione asincronaAsynchronous programming

In modalità sincrona, il metodo Create legge il primo blocco di dati dal buffer del file, del flusso o del lettore di testo.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. Questo può generare un'eccezione se un'operazione di I/O ha esito negativo.This may throw an exception if an I/O operation fails. In modalità asincrona la prima operazione di I/O viene eseguita con un'operazione di lettura, quindi le eccezioni che si verificano verranno generate quando si verifica l'operazione di lettura.In asynchronous mode, the first I/O operation occurs with a read operation, so exceptions that arise will be thrown when the read operation occurs.

Considerazioni relative alla sicurezzaSecurity considerations

Per impostazione predefinita, il XmlReader usa un oggetto XmlUrlResolver senza credenziali utente per aprire le risorse.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. Ciò significa che, per impostazione predefinita, il lettore XML può accedere a qualsiasi percorso che non richiede le credenziali.This means that, by default, the XML reader can access any location that doesn't require credentials. Usare la proprietà XmlResolver per controllare l'accesso alle risorse:Use the XmlResolver property to control access to resources:

-oppure--or-

  • Impostare XmlResolver su null per impedire che il lettore XML apra le risorse esterne.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext)

Crea una nuova istanza di XmlReader con l'URI, le impostazioni e le informazioni di contesto specificati per l'analisi.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

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);
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.The URI for the file containing the XML data. L'oggetto XmlResolver nell'oggetto XmlReaderSettings viene usato per eseguire la conversione del percorso a una rappresentazione canonica dei dati.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Se XmlResolver è null, viene usato un nuovo oggetto XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

inputContext
XmlParserContext

Informazioni sul contesto necessarie per analizzare il frammento XML.The context information required to parse the XML fragment. 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 (Document Type Definition).The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Il valore può essere null.This value can be null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di inputUri è null.The inputUri value is null.

XmlReader non dispone di autorizzazioni sufficienti per accedere al percorso dei dati XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Le proprietà NameTable e NameTable contengono entrambe valori.The NameTable and NameTable properties both contain values. (È possibile impostare e usare solo una di queste proprietà NameTable).(Only one of these NameTable properties can be set and used).

Non è possibile trovare il file specificato dall'URI.The file specified by the URI cannot be found.

Il formato dell'URI non è corretto.The URI format is not correct.

Commenti

Per impostazione predefinita, un XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Ciò significa che il XmlReader può accedere a qualsiasi posizione che non richiede l'autenticazione.This means that the XmlReader can access any locations that does not require authentication. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile limitare le risorse a cui l'XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

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.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

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.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

inputContext
XmlParserContext

Informazioni sul contesto necessarie per analizzare il frammento XML.The context information required to parse the XML fragment. 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 (Document Type Definition).The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Il valore può essere null.This value can be null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Le proprietà NameTable e NameTable contengono entrambe valori.The NameTable and NameTable properties both contain values. (È possibile impostare e usare solo una di queste proprietà NameTable).(Only one of these NameTable properties can be set and used).

Esempio

Nell'esempio seguente viene creato un oggetto XmlReader per la lettura di un frammento XML.The following example creates an XmlReader object that reads an XML fragment.

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 senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext)

Crea una nuova istanza di XmlReader con il flusso, le impostazioni e le informazioni di contesto specificati per l'analisi.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

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.The stream that contains the XML data.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

inputContext
XmlParserContext

Informazioni sul contesto necessarie per analizzare il frammento XML.The context information required to parse the XML fragment. 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 (Document Type Definition).The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Il valore può essere null.This value can be null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Commenti

Per impostazione predefinita, un XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String)

Crea una nuova istanza di XmlReader con il flusso, l'URI di base e le impostazioni specificati.Creates a new XmlReader instance using the specified stream, base URI, and settings.

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);
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.The stream that contains the XML data.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

baseUri
String

URI di base relativo all'entità o al documento letto.The base URI for the entity or document being read. Il valore può essere null.This value can be null.

Nota sulla sicurezza L'URI di base viene usato per risolvere l'URI relativo del documento XML.Security Note The base URI is used to resolve the relative URI of the XML document. Non usare un URI di base proveniente da una fonte non attendibile.Do not use a base URI from an untrusted source.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Commenti

Per impostazione predefinita, un XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings)

Crea una nuova istanza di XmlReader con il lettore XML e le impostazioni specificate.Creates a new XmlReader instance by using the specified XML reader and 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.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance.

Il livello di conformità dell'oggetto XmlReaderSettings deve corrispondere a quello del lettore sottostante o deve essere impostato su Auto.The conformance level of the XmlReaderSettings object must either match the conformance level of the underlying reader, or it must be set to Auto.

Restituisce

XmlReader

Oggetto di cui è stato eseguito il wrapping intorno all'oggetto XmlReader specificato.An object that is wrapped around the specified XmlReader object.

Eccezioni

Il valore di reader è null.The reader value is null.

Se l'oggetto XmlReaderSettings specifica un livello di conformità non coerente con quello del lettore sottostante.If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

-oppure--or- L'oggetto XmlReader sottostante è in uno stato Error o Closed.The underlying XmlReader is in an Error or Closed state.

Esempio

Nell'esempio seguente viene creato un oggetto di convalida XmlReader di cui viene eseguito il wrapped intorno a un oggetto XmlNodeReader.The following example creates a validating XmlReader object that is wrapped around an XmlNodeReader object.

// 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 ulteriori funzionalità a un oggetto XmlReader sottostante.This method allows you add additional features to an underlying XmlReader object. L'oggetto XmlReader sottostante può essere un altro XmlReader oggetto creato dal metodo Create o un oggetto XmlReader creato utilizzando una delle implementazioni di XmlReader concrete.The underlying XmlReader object can be another XmlReader object created by the Create method, or an XmlReader object created using one of the concrete XmlReader implementations.

Per accedere a tutte le risorse esterne, ad esempio uno schema, viene utilizzata una XmlUrlResolver predefinita senza credenziali.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver con le credenziali necessarie usando la proprietà XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String)

Crea una nuova istanza di XmlReader con il lettore di testo, le impostazioni e l'URI di base specificati.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

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);
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.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XmlReader to decode the data stream.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

baseUri
String

URI di base relativo all'entità o al documento letto.The base URI for the entity or document being read. Il valore può essere null.This value can be null.

Nota sulla sicurezza L'URI di base viene usato per risolvere l'URI relativo del documento XML.Security Note The base URI is used to resolve the relative URI of the XML document. Non usare un URI di base proveniente da una fonte non attendibile.Do not use a base URI from an untrusted source.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Commenti

Per impostazione predefinita, un XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings)

Crea una nuova istanza di XmlReader con il lettore di testo e le impostazioni specificati.Creates a new XmlReader instance by using the specified text reader and 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.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

Impostazioni del nuovo oggetto XmlReader.The settings for the new XmlReader. Il valore può essere null.This value can be null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Commenti

Per impostazione predefinita, un XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings)

Crea una nuova istanza di XmlReader con il flusso e le impostazioni specificati.Creates a new XmlReader instance with the specified stream and 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.The stream that contains the XML data.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Commenti

Per impostazione predefinita, un XmlUrlResolver senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile utilizzare uno dei metodi seguenti per controllare quali risorse possono accedere ai XmlReader:You can use one of the following methods to control which resources the XmlReader can access:

-oppure--or-

  • Non consentire al tipo XmlReader di aprire alcuna risorsa esterna impostando la proprietà XmlResolver su null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String)

Crea una nuova istanza di XmlReader con l'URI specificato.Creates a new XmlReader instance with specified URI.

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.The URI for the file that contains the XML data. La classe XmlUrlResolver viene usata per convertire il percorso in una rappresentazione canonica dei dati.The XmlUrlResolver class is used to convert the path to a canonical data representation.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di inputUri è null.The inputUri value is null.

XmlReader non dispone di autorizzazioni sufficienti per accedere al percorso dei dati XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Il file identificato dall'URI non esiste.The file identified by the URI does not exist.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare in alternativa l'eccezione della classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Il formato dell'URI non è corretto.The URI format is not correct.

Esempio

Nell'esempio seguente viene creato un oggetto XmlReader che legge il file di dati XML specificato dall'URI.The following example creates an XmlReader object that reads XML data file specified by the 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 utilizzato un oggetto XmlReaderSettings con le impostazioni predefinite.An XmlReaderSettings object with default settings is used to create the reader. Se si desidera specificare le funzionalità da supportare sul Reader creato, utilizzare l'overload che accetta un oggetto XmlReaderSettings come uno degli argomenti e passare un oggetto XmlReaderSettings con le impostazioni corrette.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Per accedere a tutte le risorse esterne, ad esempio un Document Type Definition (DTD), le entità, gli schemi e così via, viene utilizzata una XmlUrlResolver predefinita senza credenziali.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver con le credenziali necessarie usando la proprietà XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader)

Crea una nuova istanza di XmlReader con il lettore di testo specificato.Creates a new XmlReader instance by using the specified text reader.

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.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

Esempio

Nell'esempio seguente viene utilizzata la classe StringReader per leggere una stringa XML.The following example uses the StringReader class to read an XML string.

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 utilizzato un oggetto XmlReaderSettings con le impostazioni predefinite.An XmlReaderSettings object with default settings is used to create the reader. Se si desidera specificare le funzionalità da supportare sul Reader creato, utilizzare l'overload che accetta un oggetto XmlReaderSettings come uno degli argomenti e passare un oggetto XmlReaderSettings con le impostazioni corrette.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Per accedere a tutte le risorse esterne, ad esempio un Document Type Definition (DTD), le entità, gli schemi e così via, viene utilizzata una XmlUrlResolver predefinita senza credenziali.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver con le credenziali necessarie usando la proprietà XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream)

Crea una nuova istanza di XmlReader con il flusso specificato e le impostazioni predefinite.Creates a new XmlReader instance using the specified stream with default settings.

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.The stream that contains the XML data.

L'oggetto XmlReader analizza i primi byte del flusso cercando un indicatore per l'ordine dei byte o un altro segno di codifica.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 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).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di input è null.The input value is null.

XmlReader non dispone di autorizzazioni sufficienti per accedere al percorso dei dati XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Esempio

Nell'esempio seguente viene creato un oggetto XmlReader che legge da un FileStream.The following example creates an XmlReader object that reads from a 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 utilizzato un oggetto XmlReaderSettings con le impostazioni predefinite.An XmlReaderSettings object with default settings is used to create the reader. Se si desidera specificare le funzionalità da supportare sul Reader creato, utilizzare l'overload che accetta un oggetto XmlReaderSettings come uno degli argomenti e passare un oggetto XmlReaderSettings con le impostazioni corrette.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Per accedere a tutte le risorse esterne, ad esempio un Document Type Definition (DTD), le entità, gli schemi e così via, viene utilizzata una XmlUrlResolver predefinita senza credenziali.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, specificare un XmlResolver con le credenziali necessarie usando la proprietà XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings)

Crea una nuova istanza di XmlReader con l'URI e le impostazioni specificati.Creates a new XmlReader instance by using the specified URI and settings.

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);
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.The URI for the file containing the XML data. L'oggetto XmlResolver nell'oggetto XmlReaderSettings viene usato per eseguire la conversione del percorso a una rappresentazione canonica dei dati.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Se XmlResolver è null, viene usato un nuovo oggetto XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

Impostazioni per la nuova istanza di XmlReader.The settings for the new XmlReader instance. Il valore può essere null.This value can be null.

Restituisce

XmlReader

Oggetto usato per leggere i dati XML nel flusso.An object that is used to read the XML data in the stream.

Eccezioni

Il valore di inputUri è null.The inputUri value is null.

Non è possibile trovare il file specificato dall'URI.The file specified by the URI cannot be found.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare in alternativa l'eccezione della classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Il formato dell'URI non è corretto.The URI format is not correct.

Esempio

Nell'esempio seguente viene creato un oggetto XmlReader che supporta la convalida della Document Type Definition (DTD).The following example creates an XmlReader object that supports document type definition (DTD) validation.

// 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 senza credenziali viene usato per accedere a qualsiasi risorsa esterna, ad esempio una Document Type Definition (DTD), entità, schemi e così via.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Importante

A partire da .NET Framework 4.5.2, non viene fornito alcun XmlUrlResolver predefinito.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se la soluzione è destinata a .NET Framework 4.5.2 o versioni successive, specificare una XmlResolver usando la proprietà XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Ciò significa che il XmlReader può accedere a qualsiasi posizione che non richiede l'autenticazione.This means that the XmlReader can access any locations that does not require authentication. Se la risorsa esterna si trova in una risorsa di rete che richiede l'autenticazione, usare la proprietà XmlReaderSettings.XmlResolver per specificare una XmlResolver con le credenziali necessarie.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Importante

È possibile limitare le risorse a cui l'XmlReader può accedere impostando la proprietà XmlResolver su un oggetto XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

L'oggetto XmlReader creato espande i riferimenti alle entità ed esegue la normalizzazione XML dei caratteri di nuova riga.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Si applica a