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.

Esempi

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 XmlUrlResolver un 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 Create degli overload include un settings parametro che accetta un XmlReaderSettings oggetto.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 XmlReader funzionalità che si desidera supportare nell'oggetto.Specify which features you want supported on the XmlReader object.

  • Riutilizzare XmlReaderSettings l'oggetto 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 XmlReaderSettings un'istanza di 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 lettore definito dall'utente, un XmlTextReader oggetto o un'altra XmlReader istanza 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.

  • Sfruttare appieno le funzionalità, ad esempio il controllo della conformità migliore e la conformità alla raccomandazione XML 1,0 (quarta edizione) , disponibile solo per XmlReader gli 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 XmlReader della classe, ad esempio XmlTextReaderle XmlNodeReader XmlValidatingReader classi, e, è consigliabile creare XmlReader istanze di tramite il Create Metodo.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 Create overload che non accetta un XmlReaderSettings oggetto, vengono usate le impostazioni del reader predefinite seguenti:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

ImpostazioneSetting Impostazione predefinitaDefault
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 ProcessIdentityConstraintsabilitatoProcessIdentityConstraints 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 XmlReaderSettings riportate le proprietà 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 ImpostaSet
I dati devono essere un documento XML ben formato.Data must be a well-formed XML document. ConformanceLevela Document.ConformanceLevel to Document.
I dati devono essere un'entità analizzata XML ben formata.Data must be a well-formed XML parsed entity. ConformanceLevela Fragment.ConformanceLevel to Fragment.
I dati devono essere convalidati rispetto a una DTD.Data must be validated against a DTD. DtdProcessing in ParseDtdProcessing to Parse
ValidationTypea DTD.ValidationType to DTD.
I dati devono essere convalidati in base a un XML Schema.Data must be validated against an XML schema. ValidationType in SchemaValidationType to Schema
Schemasoggetto da XmlSchemaSet utilizzare per la convalida.Schemas to the XmlSchemaSet to use for validation. Si noti XmlReader che 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. ValidationType in SchemaValidationType to Schema
ValidationFlagsa ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Supporto del tipo.Type support. ValidationType in SchemaValidationType to Schema
Schemasoggetto XmlSchemaSet da utilizzare.Schemas to the XmlSchemaSet to use.

XmlReadernon 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, Create il metodo 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 sulla sicurezzaSecurity considerations

Per impostazione predefinita, XmlReader usa un XmlUrlResolver oggetto 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 XmlResolver proprietà per controllare l'accesso alle risorse:Use the XmlResolver property to control access to resources:

-oppure--or-

  • Impostare XmlResolver sunull per evitare 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

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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Ciò significa che 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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 XmlReader può accedere impostando la XmlResolver proprietà su un XmlSecureResolver oggetto.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

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

Esempi

Nell'esempio seguente viene creato XmlReader un oggetto che legge 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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere:You can use one of the following methods to control which resources the XmlReader can access:

In alternativa-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

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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere: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

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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere:You can use one of the following methods to control which resources the XmlReader can access:

In alternativa-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

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.

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

Esempi

Nell'esempio seguente viene creato un XmlReader oggetto di convalida di cui è XmlNodeReader stato eseguito il wrapped intorno a un oggetto.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 XmlReader altro oggetto creato dal Create metodo o un XmlReader oggetto creato utilizzando una delle implementazioni concrete XmlReader .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 XmlUrlResolver a tutte le risorse esterne, ad esempio uno schema, viene utilizzato un valore predefinito 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlResolver specificare un con le credenziali necessarie XmlReaderSettings.XmlResolver usando la proprietà.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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere:You can use one of the following methods to control which resources the XmlReader can access:

In alternativa-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

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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere: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

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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere:You can use one of the following methods to control which resources the XmlReader can access:

In alternativa-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

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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 usare uno dei metodi seguenti per controllare a quali risorse XmlReader può accedere: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

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 invece l'eccezione della classe di 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.

Esempi

Nell'esempio seguente viene creato XmlReader un oggetto 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 XmlReaderSettings creare il lettore viene utilizzato un oggetto 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 XmlReaderSettings oggetto come uno degli argomenti e passare un XmlReaderSettings oggetto 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 XmlUrlResolver a tutte le risorse esterne, ad esempio un Document Type Definition (DTD), le entità, gli schemi e così via, viene utilizzato un valore predefinito 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlResolver specificare un con le credenziali necessarie XmlReaderSettings.XmlResolver usando la proprietà.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

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.

Esempi

Nell'esempio seguente viene usata StringReader la classe 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 XmlReaderSettings creare il lettore viene utilizzato un oggetto 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 XmlReaderSettings oggetto come uno degli argomenti e passare un XmlReaderSettings oggetto 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 XmlUrlResolver a tutte le risorse esterne, ad esempio un Document Type Definition (DTD), le entità, gli schemi e così via, viene utilizzato un valore predefinito 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlResolver specificare un con le credenziali necessarie XmlReaderSettings.XmlResolver usando la proprietà.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

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.

Esempi

Nell'esempio seguente viene creato XmlReader un oggetto che legge FileStreamda.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 XmlReaderSettings creare il lettore viene utilizzato un oggetto 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 XmlReaderSettings oggetto come uno degli argomenti e passare un XmlReaderSettings oggetto 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 XmlUrlResolver a tutte le risorse esterne, ad esempio un Document Type Definition (DTD), le entità, gli schemi e così via, viene utilizzato un valore predefinito 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.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, XmlResolver specificare un con le credenziali necessarie XmlReaderSettings.XmlResolver usando la proprietà.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

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 invece l'eccezione della classe di 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.

Esempi

Nell'esempio seguente viene creato XmlReader un oggetto che supporta la convalida 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 XmlUrlResolver , un oggetto senza credenziali viene utilizzato per accedere a risorse esterne, ad esempio un 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 XmlUrlResolver specificato alcun valore 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, XmlResolver specificare un XmlReaderSettings.XmlResolver usando la proprietà.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Ciò significa che 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, XmlReaderSettings.XmlResolver usare la proprietà per XmlResolver specificare un 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 XmlReader può accedere impostando la XmlResolver proprietà su un XmlSecureResolver oggetto.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