XmlReader.Create Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Assemblagens:
System.Xml.dll, System.Xml.ReaderWriter.dll

Cria uma nova XmlReader instância.

Sobrecargas

Name Description
Create(String, XmlReaderSettings, XmlParserContext)

Cria uma nova XmlReader instância usando o URI, definições e informação de contexto especificadas para análise sintática.
Create(TextReader, XmlReaderSettings, XmlParserContext)

Cria uma nova XmlReader instância usando o leitor de texto especificado, as definições e a informação de contexto para análise sintática.
Create(Stream, XmlReaderSettings, XmlParserContext)

Cria uma nova XmlReader instância usando o fluxo especificado, as definições e a informação de contexto para análise sintática.
Create(Stream, XmlReaderSettings, String)

Cria uma nova XmlReader instância usando o stream especificado, o URI base e as definições.
Create(XmlReader, XmlReaderSettings)

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

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

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

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

Cria uma nova XmlReader instância com um 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 stream especificado com as definições predefinidas.
Create(String, XmlReaderSettings)

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

Observações

Para mais informações sobre esta API, consulte Observações suplementares sobre a API 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, definições e informação de contexto especificadas para análise sintática.

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 ficheiro que contém os dados XML. O XmlResolver objeto no XmlReaderSettings objeto é usado para converter o caminho numa representação canónica de dados. Se XmlResolver for null, é usado um novo XmlUrlResolver objeto.

settings
XmlReaderSettings

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

inputContext
XmlParserContext

A informação de contexto necessária para analisar o fragmento XML. A informação de contexto pode incluir o XmlNameTable to use, codificação, âmbito do namespace, o atual xml:lang e xml:space scope, o URI base e a definição do tipo de documento.

Este valor pode ser null.

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O inputUri valor é null.

SecurityException

Não XmlReader tem permissões suficientes para aceder à localização dos dados XML.

ArgumentException

As NameTable propriedades e NameTable contêm ambas valores. (Apenas uma destas NameTable propriedades pode ser definida e utilizada).

FileNotFoundException

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

UriFormatException

O formato do URI não está correto.

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Podes restringir os recursos a que XmlReader podem aceder definindo a XmlResolver propriedade para um XmlSecureResolver objeto.

O objeto criado XmlReader expande referências de entidade e realiza 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 especificado, as definições e a informação de contexto para análise sintática.

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

settings
XmlReaderSettings

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

inputContext
XmlParserContext

A informação de contexto necessária para analisar o fragmento XML. A informação de contexto pode incluir o XmlNameTable to use, codificação, âmbito do namespace, o atual xml:lang e xml:space scope, o URI base e a definição do tipo de documento.

Este valor pode ser null.

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

ArgumentException

As NameTable propriedades e NameTable contêm ambas valores. (Apenas uma destas NameTable propriedades pode ser definida e utilizada.)

Exemplos

O exemplo seguinte 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)

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 especificado, as definições e a informação de contexto para análise sintática.

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.

Analisa XmlReader os primeiros bytes do fluxo à procura de uma marca de ordem de bytes ou outro sinal de codificação. Quando a codificação é determinada, a codificação é usada para continuar a ler o fluxo, e o processamento continua a analisar a entrada como um fluxo de caracteres (Unicode).

settings
XmlReaderSettings

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

inputContext
XmlParserContext

A informação de contexto necessária para analisar o fragmento XML. A informação de contexto pode incluir o XmlNameTable to use, codificação, âmbito do namespace, o atual xml:lang e xml:space scope, o URI base e a definição do tipo de documento.

Este valor pode ser null.

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 stream especificado, o URI base e as definições.

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.

Analisa XmlReader os primeiros bytes do fluxo à procura de uma marca de ordem de bytes ou outro sinal de codificação. Quando a codificação é determinada, a codificação é usada para continuar a ler o fluxo, e o processamento continua a analisar a entrada como um fluxo de caracteres (Unicode).

settings
XmlReaderSettings

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

baseUri
String

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

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

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 especificado e as definições.

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 queres usar como leitor XML subjacente.

settings
XmlReaderSettings

As definições para a 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 para Auto.

Devoluções

XmlReader

Um objeto que envolve o objeto especificado XmlReader .

Exceções

ArgumentNullException

O reader valor é null.

InvalidOperationException

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

-ou-

O subjacente XmlReader está num Error estado de ou.Closed

Exemplos

O exemplo seguinte cria um objeto validador XmlReader que é enrolado 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

Observações

Este método permite-lhe adicionar funcionalidades 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 aceder a quaisquer recursos externos, como um esquema.

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

Se o recurso externo estiver localizado num recurso de rede que requer autenticação, especifique an XmlResolver com as credenciais necessárias usando a XmlReaderSettings.XmlResolver propriedade.

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 especificado, as definiçõ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 a partir do qual ler os dados XML. Um leitor de texto devolve um fluxo de caracteres Unicode, pelo que a codificação especificada na declaração XML não é usada pelo XmlReader para decodificar o fluxo de dados.

settings
XmlReaderSettings

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

baseUri
String

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

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

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 definições especificadas.

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

settings
XmlReaderSettings

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

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 definiçõ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.

Analisa XmlReader os primeiros bytes do fluxo à procura de uma marca de ordem de bytes ou outro sinal de codificação. Quando a codificação é determinada, a codificação é usada para continuar a ler o fluxo, e o processamento continua a analisar a entrada como um fluxo de caracteres (Unicode).

settings
XmlReaderSettings

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

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Pode usar um dos seguintes métodos para controlar quais recursos pode XmlReader acedecer:

-ou-

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

O objeto criado XmlReader expande referências de entidade e realiza 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 um 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 ficheiro que contém os dados XML. A XmlUrlResolver classe é usada para converter o caminho numa representação canónica de dados.

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O inputUri valor é null.

SecurityException

Não XmlReader tem permissões suficientes para aceder à localização dos dados XML.

FileNotFoundException

O ficheiro identificado pelo URI não existe.

UriFormatException

O formato do URI não está correto.

Nota: Em .NET para aplicações Windows Store ou a Portable Class Library, apanhe a exceção da classe base, FormatException, em vez disso.

Exemplos

O exemplo seguinte cria um XmlReader objeto que lê ficheiro 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")

Observações

Um XmlReaderSettings objeto com definições padrão é usado para criar o leitor. Se quiser especificar as funcionalidades a suportar no leitor criado, use a sobrecarga que aceita um XmlReaderSettings objeto como um dos seus argumentos, e passe um XmlReaderSettings objeto com as definições corretas.

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

Se o recurso externo estiver localizado num recurso de rede que requer autenticação, especifique an XmlResolver com as credenciais necessárias usando a XmlReaderSettings.XmlResolver propriedade.

O objeto criado XmlReader expande referências de entidade e realiza 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

O leitor de texto a partir do qual ler os dados XML. Um leitor de texto devolve um fluxo de caracteres Unicode, pelo que a codificação especificada na declaração XML não é usada pelo leitor XML para decodificar o fluxo de dados.

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

Exemplos

O exemplo seguinte usa a StringReader classe para ler uma string 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))

Observações

Um XmlReaderSettings objeto com definições padrão é usado para criar o leitor. Se quiser especificar as funcionalidades a suportar no leitor criado, use a sobrecarga que aceita um XmlReaderSettings objeto como um dos seus argumentos, e passe um XmlReaderSettings objeto com as definições corretas.

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

Se o recurso externo estiver localizado num recurso de rede que requer autenticação, especifique an XmlResolver com as credenciais necessárias usando a XmlReaderSettings.XmlResolver propriedade.

O objeto criado XmlReader expande referências de entidade e realiza 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 stream especificado com as definições predefinidas.

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.

Analisa XmlReader os primeiros bytes do fluxo à procura de uma marca de ordem de bytes ou outro sinal de codificação. Quando a codificação é determinada, a codificação é usada para continuar a ler o fluxo, e o processamento continua a analisar a entrada como um fluxo de caracteres (Unicode).

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O input valor é null.

SecurityException

Não XmlReader tem permissões suficientes para aceder à localização dos dados XML.

Exemplos

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

Observações

Um XmlReaderSettings objeto com definições padrão é usado para criar o leitor. Se quiser especificar as funcionalidades a suportar no leitor criado, use a sobrecarga que aceita um XmlReaderSettings objeto como um dos seus argumentos, e passe um XmlReaderSettings objeto com as definições corretas.

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

Se o recurso externo estiver localizado num recurso de rede que requer autenticação, especifique an XmlResolver com as credenciais necessárias usando a XmlReaderSettings.XmlResolver propriedade.

O objeto criado XmlReader expande referências de entidade e realiza 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 definições especificadas.

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 ficheiro que contém os dados XML. O XmlResolver objeto no XmlReaderSettings objeto é usado para converter o caminho numa representação canónica de dados. Se XmlResolver for null, é usado um novo XmlUrlResolver objeto.

settings
XmlReaderSettings

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

Devoluções

XmlReader

Um objeto que é usado para ler os dados XML no fluxo.

Exceções

ArgumentNullException

O inputUri valor é null.

FileNotFoundException

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

UriFormatException

O formato do URI não está correto.

Nota: Em .NET para aplicações Windows Store ou a Portable Class Library, apanhe a exceção da classe base, FormatException, em vez disso.

Exemplos

O exemplo seguinte cria um XmlReader objeto que suporta validação de definição de tipo de documento (DTD).

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

Observações

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

Importante

A partir do .NET Framework 4.5.2, não é fornecido XmlUrlResolver por defeito. Se a sua solução tiver como alvo o .NET Framework 4.5.2 ou versões posteriores, especifique um XmlResolver usando a propriedade XmlReaderSettings.XmlResolver.

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

Importante

Podes restringir os recursos a que XmlReader podem aceder definindo a XmlResolver propriedade para um XmlSecureResolver objeto.

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

Aplica-se a