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.

Comentários

Para obter mais informações sobre essa API, consulte comentários da API Suplementar para XmlReader.Close.

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:space o escopo atuaisxml:lang, 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 ele XmlReader pode 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 definindo a XmlResolver propriedade para 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

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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 o XmlReader pode acessar definindo a propriedade XmlResolver como um objeto XmlSecureResolver.

- ou -

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: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, pegue a exceção de classe base, FormatExceptionem 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 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: no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, pegue a exceção de classe base, FormatExceptionem 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 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 definindo a XmlResolver propriedade para 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

Comentários

Esta página foi útil?

Partilhar via

XmlReader.Create Método

Definição

Sobrecargas

Comentários

Create(String, XmlReaderSettings, XmlParserContext)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Create(TextReader, XmlReaderSettings, XmlParserContext)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Create(Stream, XmlReaderSettings, XmlParserContext)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Create(Stream, XmlReaderSettings, String)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Create(XmlReader, XmlReaderSettings)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Create(TextReader, XmlReaderSettings, String)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Create(TextReader, XmlReaderSettings)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Create(Stream, XmlReaderSettings)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Create(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Create(TextReader)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Create(Stream)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Create(String, XmlReaderSettings)

Parâmetros

Retornos

Exceções