XmlReader.Create Método

Definição

Cria uma nova instância XmlReader.Creates a new XmlReader instance.

Sobrecargas

Create(String, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de URI, de configurações e de contexto especificadas para análise.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de contexto, de configurações e do leitor de texto especificadas para análise.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de fluxo, configurações e contexto especificadas para análise.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String)

Cria uma nova instância XmlReader usando o fluxo, o URI base e as configurações especificadas.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings)

Cria uma nova instância XmlReader usando as configurações e o leitor XML especificados.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String)

Cria uma nova instância XmlReader usando o leitor de texto especificado, as configurações e o URI base.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings)

Cria uma nova instância do XmlReader usando as configurações e o leitor de texto especificados.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings)

Cria uma nova instância XmlReader com as configurações e o fluxo especificado.Creates a new XmlReader instance with the specified stream and settings.

Create(String)

Cria uma nova instância XmlReader com o URI especificado.Creates a new XmlReader instance with specified URI.

Create(TextReader)

Cria uma nova instância de XmlReader usando o leitor de texto especificado.Creates a new XmlReader instance by using the specified text reader.

Create(Stream)

Cria uma nova instância XmlReader usando o fluxo especificado com as configurações padrão.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings)

Cria uma nova instância XmlReader usando o URI e as configurações especificados.Creates a new XmlReader instance by using the specified URI and settings.

Exemplos

Este exemplo cria um leitor XML que retira espaço em branco insignificante, retira comentários e executa a verificação de conformidade no nível do fragmento.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)

O exemplo a seguir usa um XmlUrlResolver com credenciais padrão para acessar um arquivo.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)

O código a seguir encapsula uma instância de leitor dentro de outro leitor.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)

Este exemplo encadeia os leitores para adicionar a validação de esquema XML e DTD.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

Comentários

A maioria das sobrecargas de Create inclui um parâmetro settings que aceita um objeto XmlReaderSettings.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. Você pode usar este objeto para:You can use this object to:

  • Especifique quais recursos você deseja que tenham suporte no objeto XmlReader.Specify which features you want supported on the XmlReader object.

  • Reutilize o objeto XmlReaderSettings para criar vários leitores.Reuse the XmlReaderSettings object to create multiple readers. Você pode usar as mesmas configurações para criar vários leitores com a mesma funcionalidade.You can use the same settings to create multiple readers with the same functionality. Ou, você pode modificar as configurações em uma instância de XmlReaderSettings e criar um novo leitor com um conjunto diferente de recursos.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • Adicione recursos a um leitor XML existente.Add features to an existing XML reader. O método Create pode aceitar outro objeto XmlReader.The Create method can accept another XmlReader object. O objeto de XmlReader subjacente pode ser um leitor definido pelo usuário, um objeto XmlTextReader ou outra instância XmlReader à qual você deseja adicionar recursos adicionais.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.

  • Aproveite ao máximo os recursos, como a melhor verificação de conformidade e a conformidade com a recomendação XML 1,0 (quarta edição) que estão disponíveis apenas em objetos XmlReader criados pelo método Create estático.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.

Observação

Embora o .NET Framework inclua implementações concretas da classe XmlReader, como as classes XmlTextReader, XmlNodeReadere XmlValidatingReader, recomendamos que você crie XmlReader instâncias usando o método 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.

Configurações padrãoDefault settings

Se você usar uma sobrecarga de Create que não aceita um objeto XmlReaderSettings, as seguintes configurações de leitor padrão serão usadas:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

ConfiguraçãoSetting PadrãoDefault
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas Um objeto XmlSchemaSet vazioAn empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraints habilitadoProcessIdentityConstraints enabled
ValidationType None
XmlResolver Um novo objeto XmlUrlResolver.A new XmlUrlResolver object. A partir do .NET Framework 4.5.2, essa configuração tem o valor padrão null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Configurações para cenários comunsSettings for common scenarios

Aqui estão as propriedades XmlReaderSettings que você deve definir para alguns dos cenários típicos do leitor XML.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

RequisitoRequirement SetSet
Os dados devem ser um documento XML bem formado.Data must be a well-formed XML document. ConformanceLevel Document.ConformanceLevel to Document.
Os dados devem ser uma entidade analisada XML bem formada.Data must be a well-formed XML parsed entity. ConformanceLevel Fragment.ConformanceLevel to Fragment.
Os dados devem ser validados em relação a um DTD.Data must be validated against a DTD. DtdProcessing para ParseDtdProcessing to Parse
ValidationType DTD.ValidationType to DTD.
Os dados devem ser validados em relação a um esquema XML.Data must be validated against an XML schema. ValidationType para SchemaValidationType to Schema
Schemas à XmlSchemaSet a ser usada para validação.Schemas to the XmlSchemaSet to use for validation. Observe que XmlReader não dá suporte à validação de esquema XDR (XML-Data Reduced).Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
Os dados devem ser validados em relação a um esquema XML embutido.Data must be validated against an inline XML schema. ValidationType para SchemaValidationType to Schema
ValidationFlags ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Suporte de tipo.Type support. ValidationType para SchemaValidationType to Schema
Schemas para o XmlSchemaSet a ser usado.Schemas to the XmlSchemaSet to use.

XmlReader não dá suporte à validação de esquema XDR (XML-Data Reduced).XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

Programação assíncronaAsynchronous programming

No modo síncrono, o método Create lê a primeira parte dos dados do buffer do arquivo, do fluxo ou do leitor de texto.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. Isso pode gerar uma exceção se uma operação de e/s falhar.This may throw an exception if an I/O operation fails. No modo assíncrono, a primeira operação de e/s ocorre com uma operação de leitura, portanto, as exceções que surgirão serão geradas quando a operação de leitura ocorrer.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.

Considerações sobre segurançaSecurity considerations

Por padrão, o XmlReader usa um objeto XmlUrlResolver sem credenciais de usuário para abrir recursos.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. Isso significa que, por padrão, o leitor de XML pode acessar qualquer local que não exija credenciais.This means that, by default, the XML reader can access any location that doesn't require credentials. Use a propriedade XmlResolver para controlar o acesso aos recursos:Use the XmlResolver property to control access to resources:

- ou --or-

  • Defina XmlResolver como null para impedir que o leitor de XML abra recursos externos.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de URI, de configurações e de contexto especificadas para análise.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

Parâmetros

inputUri
String

O URI do arquivo que contém os dados XML.The URI for the file containing the XML data. O objeto XmlResolver no objeto XmlReaderSettings é usado para converter o caminho em uma representação de dados canônica.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Se XmlResolver for null, um novo objeto XmlUrlResolver será usado.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

inputContext
XmlParserContext

As informações de contexto necessárias para analisar o fragmento XML.The context information required to parse the XML fragment. As informações de contexto podem incluir o XmlNameTable a ser usado, a codificação, o escopo de namespace, o escopo de xml:lang e xml:space atual, o URI base e a definição de tipo de documento.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.

Este valor pode ser null.This value can be null.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor inputUri é null.The inputUri value is null.

O XmlReader não tem permissões suficientes para acessar o local dos dados XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Ambas as propriedades NameTable e NameTable contêm valores.The NameTable and NameTable properties both contain values. (Somente uma dessas propriedades NameTable podem ser definidas e usadas).(Only one of these NameTable properties can be set and used).

Não foi possível encontrar o arquivo especificado pelo URI.The file specified by the URI cannot be found.

O formato de URI não está correto.The URI format is not correct.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Isso significa que o XmlReader pode acessar qualquer local que não exija autenticação.This means that the XmlReader can access any locations that does not require authentication. Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode restringir os recursos que o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de contexto, de configurações e do leitor de texto especificadas para análise.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

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos.The text reader from which to read the XML data. Um leitor de texto retorna um fluxo de caracteres de Unicode, por isso a codificação especificada na declaração XML não é usada pelo leitor de XML para decodificar o fluxo de dados.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

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

inputContext
XmlParserContext

As informações de contexto necessárias para analisar o fragmento XML.The context information required to parse the XML fragment. As informações de contexto podem incluir o XmlNameTable a ser usado, a codificação, o escopo de namespace, o escopo de xml:lang e xml:space atual, o URI base e a definição de tipo de documento.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.

Este valor pode ser null.This value can be null.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Ambas as propriedades NameTable e NameTable contêm valores.The NameTable and NameTable properties both contain values. (Somente uma dessas propriedades NameTable podem ser definidas e usadas).(Only one of these NameTable properties can be set and used).

Exemplos

O exemplo a seguir cria um objeto XmlReader que lê um fragmento 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)

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de fluxo, configurações e contexto especificadas para análise.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

Parâmetros

input
Stream

O fluxo que contém os dados XML.The stream that contains the XML data.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Quando a codificação é determinada, ela é usada para continuar a ler o fluxo e o processamento continuará analisando a entrada como um fluxo de caracteres (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

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

inputContext
XmlParserContext

As informações de contexto necessárias para analisar o fragmento XML.The context information required to parse the XML fragment. As informações de contexto podem incluir o XmlNameTable a ser usado, a codificação, o escopo de namespace, o escopo de xml:lang e xml:space atual, o URI base e a definição de tipo de documento.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.

Este valor pode ser null.This value can be null.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String)

Cria uma nova instância XmlReader usando o fluxo, o URI base e as configurações especificadas.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

Parâmetros

input
Stream

O fluxo que contém os dados XML.The stream that contains the XML data.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Quando a codificação é determinada, ela é usada para continuar a ler o fluxo e o processamento continuará analisando a entrada como um fluxo de caracteres (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

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

baseUri
String

O URI base para a entidade ou o documento que está sendo lido.The base URI for the entity or document being read. Este valor pode ser null.This value can be null.

Observação de segurança o URI base é usado para resolver o URI relativo do documento XML.Security Note The base URI is used to resolve the relative URI of the XML document. Não use um URI base de uma fonte não confiável.Do not use a base URI from an untrusted source.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings)

Cria uma nova instância XmlReader usando as configurações e o leitor XML especificados.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

Parâmetros

reader
XmlReader

O objeto que você deseja usar como o leitor XML subjacente.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance.

O nível de conformidade do objeto XmlReaderSettings deve corresponder ao nível de conformidade do leitor subjacente ou deve ser definido como 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.

Retornos

Um objeto encapsulado em torno do objeto XmlReader especificado.An object that is wrapped around the specified XmlReader object.

Exceções

O valor reader é null.The reader value is null.

Se o objeto XmlReaderSettings especificar um nível de conformidade que não é consistente com o nível de conformidade do leitor subjacente.If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

- ou --or- O XmlReader subjacente está em um estado Error ou Closed.The underlying XmlReader is in an Error or Closed state.

Exemplos

O exemplo a seguir cria uma XmlReader objeto de validação que é encapsulado em torno de um objeto 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

Comentários

Esse método permite que você adicione recursos adicionais a um objeto de XmlReader subjacente.This method allows you add additional features to an underlying XmlReader object. O objeto XmlReader subjacente pode ser outro XmlReader objeto criado pelo método Create ou um objeto XmlReader criado usando uma das implementações XmlReader concretas.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.

Um XmlUrlResolver padrão sem credenciais é usado para acessar qualquer recurso externo, como um esquema.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

Importante

A partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, especifique um XmlResolver com as credenciais necessárias usando a propriedade 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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String)

Cria uma nova instância XmlReader usando o leitor de texto especificado, as configurações e o URI base.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

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos.The text reader from which to read the XML data. Um leitor de texto retorna um fluxo de caracteres de Unicode, por isso a codificação especificada na declaração XML não é usada pelo XmlReader para decodificar o fluxo de dados.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

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

baseUri
String

O URI base para a entidade ou o documento que está sendo lido.The base URI for the entity or document being read. Este valor pode ser null.This value can be null.

Observação de segurança o URI base é usado para resolver o URI relativo do documento XML.Security Note The base URI is used to resolve the relative URI of the XML document. Não use um URI base de uma fonte não confiável.Do not use a base URI from an untrusted source.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings)

Cria uma nova instância do XmlReader usando as configurações e o leitor de texto especificados.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

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos.The text reader from which to read the XML data. Um leitor de texto retorna um fluxo de caracteres de Unicode, por isso a codificação especificada na declaração XML não é usada pelo leitor de XML para decodificar o fluxo de dados.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

As configurações para o novo XmlReader.The settings for the new XmlReader. Este valor pode ser null.This value can be null.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings)

Cria uma nova instância XmlReader com as configurações e o fluxo especificado.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

Parâmetros

input
Stream

O fluxo que contém os dados XML.The stream that contains the XML data.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Quando a codificação é determinada, ela é usada para continuar a ler o fluxo e o processamento continuará analisando a entrada como um fluxo de caracteres (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

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:You can use one of the following methods to control which resources the XmlReader can access:

- ou --or-

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String)

Cria uma nova instância XmlReader com o URI especificado.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

Parâmetros

inputUri
String

O URI para o arquivo que contém os dados XML.The URI for the file that contains the XML data. A classe XmlUrlResolver é usada para converter o caminho em uma representação de dados canônica.The XmlUrlResolver class is used to convert the path to a canonical data representation.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor inputUri é null.The inputUri value is null.

O XmlReader não tem permissões suficientes para acessar o local dos dados XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

O arquivo identificado pelo URI não existe.The file identified by the URI does not exist.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

O formato de URI não está correto.The URI format is not correct.

Exemplos

O exemplo a seguir cria um objeto XmlReader que lê o arquivo de dados XML especificado pelo 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")

Comentários

Um objeto XmlReaderSettings com configurações padrão é usado para criar o leitor.An XmlReaderSettings object with default settings is used to create the reader. Se você quiser especificar os recursos para dar suporte ao leitor criado, use a sobrecarga que usa um objeto XmlReaderSettings como um de seus argumentos e passe um objeto XmlReaderSettings com as configurações corretas.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.

Um XmlUrlResolver padrão sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, especifique um XmlResolver com as credenciais necessárias usando a propriedade 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.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader)

Cria uma nova instância de XmlReader usando o leitor de texto especificado.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

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos.The text reader from which to read the XML data. Um leitor de texto retorna um fluxo de caracteres de Unicode, por isso a codificação especificada na declaração XML não é usada pelo leitor de XML para decodificar o fluxo de dados.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.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

Exemplos

O exemplo a seguir usa a classe StringReader para ler uma cadeia de caracteres 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))

Comentários

Um objeto XmlReaderSettings com configurações padrão é usado para criar o leitor.An XmlReaderSettings object with default settings is used to create the reader. Se você quiser especificar os recursos para dar suporte ao leitor criado, use a sobrecarga que usa um objeto XmlReaderSettings como um de seus argumentos e passe um objeto XmlReaderSettings com as configurações corretas.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.

Um XmlUrlResolver padrão sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, especifique um XmlResolver com as credenciais necessárias usando a propriedade 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.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream)

Cria uma nova instância XmlReader usando o fluxo especificado com as configurações padrão.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

Parâmetros

input
Stream

O fluxo que contém os dados XML.The stream that contains the XML data.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Quando a codificação é determinada, ela é usada para continuar a ler o fluxo e o processamento continuará analisando a entrada como um fluxo de caracteres (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.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor input é null.The input value is null.

O XmlReader não tem permissões suficientes para acessar o local dos dados XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Exemplos

O exemplo a seguir cria um objeto XmlReader que lê de um 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

Comentários

Um objeto XmlReaderSettings com configurações padrão é usado para criar o leitor.An XmlReaderSettings object with default settings is used to create the reader. Se você quiser especificar os recursos para dar suporte ao leitor criado, use a sobrecarga que usa um objeto XmlReaderSettings como um de seus argumentos e passe um objeto XmlReaderSettings com as configurações corretas.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.

Um XmlUrlResolver padrão sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, especifique um XmlResolver com as credenciais necessárias usando a propriedade 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.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings)

Cria uma nova instância XmlReader usando o URI e as configurações especificados.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

Parâmetros

inputUri
String

O URI do arquivo que contém os dados XML.The URI for the file containing the XML data. O objeto XmlResolver no objeto XmlReaderSettings é usado para converter o caminho em uma representação de dados canônica.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Se XmlResolver for null, um novo objeto XmlUrlResolver será usado.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader.The settings for the new XmlReader instance. Este valor pode ser null.This value can be null.

Retornos

Um objeto usado para ler os dados XML no fluxo.An object that is used to read the XML data in the stream.

Exceções

O valor inputUri é null.The inputUri value is null.

Não foi possível encontrar o arquivo especificado pelo URI.The file specified by the URI cannot be found.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

O formato de URI não está correto.The URI format is not correct.

Exemplos

O exemplo a seguir cria um objeto XmlReader que dá suporte à validação de DTD (definição de tipo de documento).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

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar qualquer recurso externo, como uma definição de tipo de documento (DTD), entidades, esquemas e assim por diante.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 partir do .NET Framework 4.5.2, nenhum XmlUrlResolver padrão é fornecido.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Se sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Isso significa que o XmlReader pode acessar qualquer local que não exija autenticação.This means that the XmlReader can access any locations that does not require authentication. Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a propriedade XmlReaderSettings.XmlResolver para especificar um XmlResolver com as credenciais necessárias.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

Você pode restringir os recursos que o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

O objeto XmlReader criado expande as referências de entidade e executa a normalização XML de novos caracteres de linha.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Aplica-se a