XmlReader.Create Método

Definição

Namespace:: System.Xml

Assemblies:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Assemblies:: System.Xml.dll, System.Xml.ReaderWriter.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma nova instância XmlReader.

Sobrecargas

Nome	Description
Create(String, XmlReaderSettings, XmlParserContext)	Cria uma nova XmlReader instância usando o URI, as configurações e as informações de contexto especificadas para análise.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Cria uma nova XmlReader instância usando o leitor de texto, as configurações e as informações de contexto especificadas para análise.
Create(Stream, XmlReaderSettings, XmlParserContext)	Cria uma nova XmlReader instância usando o fluxo, as configurações e as informações de contexto especificadas para análise.
Create(Stream, XmlReaderSettings, String)	Cria uma nova XmlReader instância usando o fluxo, o URI base e as configurações especificados.
Create(XmlReader, XmlReaderSettings)	Cria uma nova XmlReader instância usando o leitor XML e as configurações especificados.
Create(TextReader, XmlReaderSettings, String)	Cria uma nova XmlReader instância usando o leitor de texto, as configurações e o URI base especificados.
Create(TextReader, XmlReaderSettings)	Cria uma nova XmlReader instância usando o leitor de texto e as configurações especificados.
Create(Stream, XmlReaderSettings)	Cria uma nova XmlReader instância com o fluxo e as configurações especificados.
Create(String)	Cria uma nova XmlReader instância com URI especificado.
Create(TextReader)	Cria uma nova XmlReader instância usando o leitor de texto especificado.
Create(Stream)	Cria uma nova XmlReader instância usando o fluxo especificado com configurações padrão.
Create(String, XmlReaderSettings)	Cria uma nova XmlReader instância usando o URI e as configurações especificados.

Exemplos

Este exemplo cria um leitor XML que remove espaço em branco insignificante, remove comentários e executa a verificação de conformidade em nível de fragmento.

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 uma credenciais padrão XmlUrlResolver para acessar um arquivo.

// 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 = 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 em outro leitor.

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 orienta leitores a adicionar validação de DTD e esquema XML.

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 Create sobrecargas inclui um settings parâmetro que aceita um XmlReaderSettings objeto. Você pode usar este objeto para:

Especifique quais recursos você deseja ter suporte no XmlReader objeto.
Reutilize o XmlReaderSettings objeto para criar vários leitores. Você pode usar as mesmas configurações para criar vários leitores com a mesma funcionalidade. Ou você pode modificar as configurações em uma XmlReaderSettings instância e criar um novo leitor com um conjunto diferente de recursos.
Adicione recursos a um leitor XML existente. O Create método pode aceitar outro XmlReader objeto. O objeto subjacente XmlReader pode ser um leitor definido pelo usuário, um XmlTextReader objeto ou outra XmlReader instância à qual você deseja adicionar recursos adicionais.
Tire o máximo proveito de recursos como melhor verificação e conformidade com a recomendação XML 1.0 (quarta edição), que estão disponíveis apenas em XmlReader objetos criados pelo método estático Create.

Note

Embora o .NET inclua implementações concretas da XmlReader classe, como o XmlTextReader, XmlNodeReadere as XmlValidatingReader classes, recomendamos que você crie XmlReader instâncias usando o Create método.

Configurações padrão

Se você usar uma Create sobrecarga que não aceita um XmlReaderSettings objeto, as seguintes configurações de leitor padrão serão usadas:

Setting	Default
CheckCharacters	`true`
ConformanceLevel	ConformanceLevel.Document
IgnoreComments	`false`
IgnoreProcessingInstructions	`false`
IgnoreWhitespace	`false`
LineNumberOffset	0
LinePositionOffset	0
NameTable	`null`
DtdProcessing	Prohibit
Schemas	Um objeto vazio XmlSchemaSet
ValidationFlags	ProcessIdentityConstraints Habilitado
ValidationType	None
XmlResolver	`null`

Configurações para cenários comuns

Aqui estão as XmlReaderSettings propriedades que você deve definir para alguns dos cenários típicos de leitor XML.

Requirement	Definir
Os dados devem ser um documento XML bem formado.	ConformanceLevel para Document.
Os dados devem ser uma entidade analisada por XML bem formada.	ConformanceLevel para Fragment.
Os dados devem ser validados em relação a um DTD.	DtdProcessing a Parse ValidationType para DTD.
Os dados devem ser validados em relação a um esquema XML.	ValidationType a Schema Schemas ao XmlSchemaSet a ser usado para validação. Observe que XmlReader não dá suporte à validação de esquema XML-Data Reduzido (XDR).
Os dados devem ser validados em um esquema XML embutido.	ValidationType a Schema ValidationFlags para ProcessInlineSchema.
Suporte de tipos.	ValidationType a Schema Schemas para XmlSchemaSet usar.

XmlReader não dá suporte à validação de esquema XML-Data Reduzido (XDR).

Programação assíncrona

No modo síncrono, o Create método lê a primeira parte dos dados do buffer do arquivo, fluxo ou leitor de texto. Isso poderá gerar uma exceção se uma operação de E/S falhar. No modo assíncrono, a primeira operação de E/S ocorre com uma operação de leitura, portanto, as exceções que surgirem serão geradas durante essa operação.

Considerações de segurança

Por padrão, ele XmlReader usa um XmlUrlResolver objeto sem credenciais de usuário para abrir recursos. Isso significa que, por padrão, o leitor de XML pode acessar qualquer local que não exija credenciais. Use a XmlResolver propriedade para controlar o acesso aos recursos.

Use ThrowingResolver para restringir os recursos que o leitor XML pode acessar ou...
Defina XmlResolver para null para evitar que o leitor XML abra quaisquer recursos externos.

Create(String, XmlReaderSettings, XmlParserContext)

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Cria uma nova XmlReader instância usando o URI, as configurações e as informações 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 XmlResolver objeto no XmlReaderSettings objeto é usado para converter o caminho em uma representação de dados canônica. Se XmlResolver for null, um novo XmlUrlResolver objeto será usado.

settings: XmlReaderSettings

As configurações da nova XmlReader instância. 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 uso, a codificação, o escopo do namespace, o escopo e xml:lang o escopo atuaisxml:space, o URI 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 inputUri valor é null.

SecurityException

Não XmlReader há permissões suficientes para acessar o local dos dados XML.

ArgumentException

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

FileNotFoundException

O arquivo especificado pelo URI não pode ser encontrado.

UriFormatException

O formato URI não está correto.

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 a solução for direcionada para o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver uso da XmlReaderSettings.XmlResolver propriedade.

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

Importante

Você pode restringir os recursos que podem XmlReader ser acessados usando ThrowingResolver.

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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Cria uma nova XmlReader instância usando o leitor de texto, as configurações e as informações de contexto 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 ler os dados XML. Um leitor de texto retorna um fluxo de caracteres Unicode, portanto, a codificação especificada na declaração XML não é usada pelo leitor XML para decodificar o fluxo de dados.

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

ArgumentException

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

Importante

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

Importante

Você pode usar um dos seguintes métodos para controlar quais recursos podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

Verifica XmlReader os primeiros bytes do fluxo procurando uma marca de ordem de byte ou outro sinal de codificação. Quando a codificação é determinada, a codificação é usada para continuar lendo o fluxo e o processamento continua analisando a entrada como um fluxo de caracteres (Unicode).

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Este valor pode ser null.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é 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

Você pode usar um dos seguintes métodos para controlar quais recursos podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

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.

settings: XmlReaderSettings

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

baseUri: String

O URI base da entidade ou do 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 de base de uma fonte não confiável.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é 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

Você pode usar um dos seguintes métodos para controlar quais recursos podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

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

Retornos

XmlReader

Um objeto que é encapsulado ao redor do objeto especificado XmlReader .

Exceções

ArgumentNullException

O reader valor é null.

InvalidOperationException

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

- ou -

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

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 quaisquer recursos externos, como um esquema.

Importante

Se o recurso externo estiver localizado em um recurso de rede que exija 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 podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

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 ler os dados XML. Um leitor de texto retorna um fluxo de caracteres Unicode, portanto, a codificação especificada na declaração XML não é usada pelo XmlReader fluxo de dados para decodificar.

settings: XmlReaderSettings

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

baseUri: String

O URI base da entidade ou do 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 de base de uma fonte não confiável.

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é 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

Você pode usar um dos seguintes métodos para controlar quais recursos podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

settings: XmlReaderSettings

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

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é 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

Você pode usar um dos seguintes métodos para controlar quais recursos podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

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.

settings: XmlReaderSettings

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

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é 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

Você pode usar um dos seguintes métodos para controlar quais recursos podem XmlReader ser acessados:

Restrinja os recursos que podem XmlReader ser acessados usando ThrowingResolver.
Não permita que o XmlReader abra quaisquer recursos externos definindo a propriedade XmlResolver como 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Cria uma nova XmlReader instância com 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 do arquivo que contém os dados XML. A XmlUrlResolver classe é 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 inputUri valor é null.

SecurityException

Não XmlReader há permissões suficientes para acessar o local dos dados XML.

FileNotFoundException

O arquivo identificado pelo URI não existe.

UriFormatException

O formato URI não está correto.

Observação: em .NET para aplicativos da Windows Store ou a biblioteca de classes Portable, capture a exceção de classe base, FormatException.

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

Importante

Se o recurso externo estiver localizado em um recurso de rede que exija 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Cria uma nova XmlReader instância 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

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é 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 padrão 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

Se o recurso externo estiver localizado em um recurso de rede que exija 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

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

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

SecurityException

Não XmlReader há 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 padrão 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

Se o recurso externo estiver localizado em um recurso de rede que exija 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

Origem:: XmlReader.cs

Origem:: XmlReader.cs

Cria uma nova XmlReader instância 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

settings: XmlReaderSettings

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

Retornos

XmlReader

Um objeto usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O inputUri valor é null.

FileNotFoundException

O arquivo especificado pelo URI não pode ser encontrado.

UriFormatException

O formato URI não está correto.

Observação: em .NET para aplicativos da Windows Store ou a biblioteca de classes Portable, capture a exceção de classe base, FormatException.

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

Importante

Você pode restringir os recursos que podem XmlReader ser acessados usando ThrowingResolver.

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

Aplica-se a

Comentários

Esta página foi útil?