XmlReader.Create Método

  • Referência

Definição

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Cria uma nova instância XmlReader.

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.
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.
Create(Stream, XmlReaderSettings, XmlParserContext)

Cria uma nova instância XmlReader usando as informações de fluxo, configurações e contexto especificadas para análise.
Create(Stream, XmlReaderSettings, String)

Cria uma nova instância XmlReader usando o fluxo, o URI base e as configurações especificadas.
Create(XmlReader, XmlReaderSettings)

Cria uma nova instância XmlReader usando as configurações e o leitor XML especificados.
Create(TextReader, XmlReaderSettings, String)

Cria uma nova instância XmlReader usando o leitor de texto especificado, as configurações e o URI base.
Create(TextReader, XmlReaderSettings)

Cria uma nova instância do XmlReader usando as configurações e o leitor de texto especificados.
Create(Stream, XmlReaderSettings)

Cria uma nova instância XmlReader com as configurações e o fluxo especificado.
Create(String)

Cria uma nova instância XmlReader com o URI especificado.
Create(TextReader)

Cria uma nova instância de XmlReader usando o leitor de texto especificado.
Create(Stream)

Cria uma nova instância XmlReader usando o fluxo especificado com as configurações padrão.
Create(String, XmlReaderSettings)

Cria uma nova instância XmlReader usando o URI e as configurações especificados.

Comentários

Para obter mais informações sobre essa API, consulte Comentários sobre a API Complementar para XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando as informações de URI, de configurações e de contexto especificadas para análise.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parâmetros

inputUri
String

O URI do arquivo que contém os dados XML. O objeto XmlResolver no objeto XmlReaderSettings é usado para converter o caminho em uma representação de dados canônica. Se XmlResolver for null, um novo objeto XmlUrlResolver será usado.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

inputContext
XmlParserContext

As informações de contexto necessárias para analisar o fragmento XML. As informações de contexto podem incluir o XmlNameTable a ser usado, a codificação, o escopo de namespace, os escopos xml:lang e xml:space atuais, o URI de base e a definição de tipo de documento.

Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor inputUri é null.

SecurityException

O XmlReader não tem permissões suficientes para acessar o local dos dados XML.

ArgumentException

Ambas as propriedades NameTable e NameTable contêm valores. (Somente uma dessas propriedades NameTable podem ser definidas e usadas).

FileNotFoundException

Não foi possível encontrar o arquivo especificado pelo URI.

UriFormatException

O formato de URI não está correto.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Isso significa que o XmlReader pode acessar quaisquer locais que não exijam autenticação. Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode restringir os recursos que o XmlReader pode acessar definindo a XmlResolver propriedade como um XmlSecureResolver objeto .

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(TextReader, XmlReaderSettings, XmlParserContext)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando as informações de contexto, de configurações e do leitor de texto especificadas para análise.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos. 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.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

inputContext
XmlParserContext

As informações de contexto necessárias para analisar o fragmento XML. As informações de contexto podem incluir o XmlNameTable a ser usado, a codificação, o escopo de namespace, os escopos xml:lang e xml:space atuais, o URI de base e a definição de tipo de documento.

Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

ArgumentException

Ambas as propriedades NameTable e NameTable contêm valores. (Somente uma dessas NameTable propriedades pode ser definida e usada.)

Exemplos

O exemplo a seguir cria um XmlReader objeto que lê um fragmento XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(Stream, XmlReaderSettings, XmlParserContext)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando as informações de fluxo, configurações e contexto especificadas para análise.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::Xml::XmlParserContext ^ inputContext);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parâmetros

input
Stream

O fluxo que contém os dados XML.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação. 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).

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

inputContext
XmlParserContext

As informações de contexto necessárias para analisar o fragmento XML. As informações de contexto podem incluir o XmlNameTable a ser usado, a codificação, o escopo de namespace, os escopos xml:lang e xml:space atuais, o URI de base e a definição de tipo de documento.

Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(Stream, XmlReaderSettings, String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando o fluxo, o URI base e as configurações especificadas.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parâmetros

input
Stream

O fluxo que contém os dados XML.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação. 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).

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

baseUri
String

O URI base para a entidade ou o documento que está sendo lido. Este valor pode ser null.

Observação de segurança o URI base é usado para resolver o URI relativo do documento XML. Não use um URI base de uma fonte não confiável.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar quaisquer recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(XmlReader, XmlReaderSettings)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando as configurações e o leitor XML especificados.

public:
 static System::Xml::XmlReader ^ Create(System::Xml::XmlReader ^ reader, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);
static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Parâmetros

reader
XmlReader

O objeto que você deseja usar como o leitor XML subjacente.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader.

O nível de conformidade do objeto XmlReaderSettings deve corresponder ao nível de conformidade do leitor subjacente ou deve ser definido como Auto.

Retornos

XmlReader

Um objeto encapsulado em torno do objeto XmlReader especificado.

Exceções

ArgumentNullException

O valor reader é null.

InvalidOperationException

Se o objeto XmlReaderSettings especificar um nível de conformidade que não é consistente com o nível de conformidade do leitor subjacente.

- ou -

O XmlReader subjacente está em um estado Error ou Closed.

Exemplos

O exemplo a seguir cria um objeto de validação XmlReader que é encapsulado em torno de um XmlNodeReader objeto .

// 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 adicionar recursos adicionais a um objeto subjacente XmlReader . O objeto subjacente XmlReader pode ser outro XmlReader objeto criado pelo Create método ou um XmlReader objeto criado usando uma das implementações concretas XmlReader .

Um padrão XmlUrlResolver sem credenciais é usado para acessar recursos externos, como um esquema.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

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 XmlReaderSettings.XmlResolver propriedade .

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(TextReader, XmlReaderSettings, String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando o leitor de texto especificado, as configurações e o URI base.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos. 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.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

baseUri
String

O URI base para a entidade ou o documento que está sendo lido. Este valor pode ser null.

Observação de segurança o URI base é usado para resolver o URI relativo do documento XML. Não use um URI base de uma fonte não confiável.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar quaisquer recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(TextReader, XmlReaderSettings)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância do XmlReader usando as configurações e o leitor de texto especificados.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Parâmetros

input
TextReader

O leitor de texto do qual os dados XML serão lidos. 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.

settings
XmlReaderSettings

As configurações para o novo XmlReader. Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar quaisquer recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(Stream, XmlReaderSettings)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader com as configurações e o fluxo especificado.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Parâmetros

input
Stream

O fluxo que contém os dados XML.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação. 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).

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

Comentários

Por padrão, um XmlUrlResolver sem credenciais é usado para acessar quaisquer recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos o XmlReader pode acessar:

- ou -

  • Não permita que XmlReader abra os recursos externos definindo a propriedade de XmlResolver a null.

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(String)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader com o URI especificado.

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. A classe XmlUrlResolver é usada para converter o caminho em uma representação de dados canônica.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor inputUri é null.

SecurityException

O XmlReader não tem permissões suficientes para acessar o local dos dados XML.

FileNotFoundException

O arquivo identificado pelo URI não existe.

UriFormatException

O formato de URI não está correto.

Observação: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException, em vez disso.

Exemplos

O exemplo a seguir cria um XmlReader objeto que lê o arquivo de dados XML especificado pelo 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 XmlReaderSettings objeto com configurações padrão é usado para criar o leitor. Se você quiser especificar os recursos a serem compatíveis com o leitor criado, use a sobrecarga que usa um XmlReaderSettings objeto como um de seus argumentos e passe um XmlReaderSettings objeto com as configurações corretas.

Um padrão XmlUrlResolver sem credenciais é usado para acessar recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

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 XmlReaderSettings.XmlResolver propriedade .

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(TextReader)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância de XmlReader usando o leitor de texto especificado.

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

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

Exemplos

O exemplo a seguir usa a StringReader classe para ler uma cadeia de caracteres XML.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

Comentários

Um XmlReaderSettings objeto com configurações padrão é usado para criar o leitor. Se você quiser especificar os recursos a serem compatíveis com o leitor criado, use a sobrecarga que usa um XmlReaderSettings objeto como um de seus argumentos e passe um XmlReaderSettings objeto com as configurações corretas.

Um padrão XmlUrlResolver sem credenciais é usado para acessar recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

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 XmlReaderSettings.XmlResolver propriedade .

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(Stream)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando o fluxo especificado com as configurações padrão.

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.

O XmlReader examina os primeiros bytes do fluxo buscando uma marca de ordem de byte ou outro sinal de codificação. 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).

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor input é null.

SecurityException

O XmlReader não tem permissões suficientes para acessar o local dos dados XML.

Exemplos

O exemplo a seguir cria um XmlReader objeto que lê de um 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 XmlReaderSettings objeto com configurações padrão é usado para criar o leitor. Se você quiser especificar os recursos a serem compatíveis com o leitor criado, use a sobrecarga que usa um XmlReaderSettings objeto como um de seus argumentos e passe um XmlReaderSettings objeto com as configurações corretas.

Um padrão XmlUrlResolver sem credenciais é usado para acessar recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

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 XmlReaderSettings.XmlResolver propriedade .

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a

Create(String, XmlReaderSettings)

Origem:
XmlReader.cs
Origem:
XmlReader.cs
Origem:
XmlReader.cs

Cria uma nova instância XmlReader usando o URI e as configurações especificados.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings);
static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Parâmetros

inputUri
String

O URI do arquivo que contém os dados XML. O objeto XmlResolver no objeto XmlReaderSettings é usado para converter o caminho em uma representação de dados canônica. Se XmlResolver for null, um novo objeto XmlUrlResolver será usado.

settings
XmlReaderSettings

As configurações para a nova instância XmlReader. Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O valor inputUri é null.

FileNotFoundException

Não foi possível encontrar o arquivo especificado pelo URI.

UriFormatException

O formato de URI não está correto.

Observação: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException, em vez disso.

Exemplos

O exemplo a seguir cria um XmlReader objeto que dá suporte à validação de DTD (definição de tipo de documento).

// 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 recursos externos, como uma DTD (definição de tipo de documento), entidades, esquemas e assim por diante.

Importante

A partir do .NET Framework 4.5.2, nenhum padrão XmlUrlResolver é fornecido. Se sua solução for direcionada ao .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a XmlReaderSettings.XmlResolver propriedade .

Isso significa que o XmlReader pode acessar quaisquer locais que não exijam autenticação. Se o recurso externo estiver localizado em um recurso de rede que requer autenticação, use a XmlReaderSettings.XmlResolver propriedade para especificar um XmlResolver com as credenciais necessárias.

Importante

Você pode restringir os recursos que o XmlReader pode acessar definindo a XmlResolver propriedade como um XmlSecureResolver objeto .

O objeto criado XmlReader expande as referências de entidade e executa a normalização XML de novos caracteres de linha.

Aplica-se a