Partilhar via


XPathDocument Construtores

Definição

Inicializa uma nova instância da classe XPathDocument.

Sobrecargas

XPathDocument(Stream)

Inicializa uma nova instância da classe XPathDocument dos dados XML no objeto Stream especificado.

XPathDocument(String)

Inicializa uma nova instância da classe XPathDocument dos dados XML no arquivo especificado.

XPathDocument(XmlReader)

Inicializa uma nova instância da classe XPathDocument dos dados XML que estão contidos no objeto XmlReader.

XPathDocument(TextReader)

Inicializa uma nova instância da classe XPathDocument dos dados XML que estão contidos no objeto TextReader.

XPathDocument(String, XmlSpace)

Inicializa uma nova instância da classe XPathDocument dos dados XML no arquivo especificado com a manipulação de espaço em branco especificada.

XPathDocument(XmlReader, XmlSpace)

Inicializa uma nova instância da classe XPathDocument dos dados XML que estão contidos no objeto XmlReader especificado com a manipulação de espaço em branco especificada.

XPathDocument(Stream)

Origem:
XPathDocument.cs
Origem:
XPathDocument.cs
Origem:
XPathDocument.cs

Inicializa uma nova instância da classe XPathDocument dos dados XML no objeto Stream especificado.

public:
 XPathDocument(System::IO::Stream ^ stream);
public XPathDocument (System.IO.Stream stream);
new System.Xml.XPath.XPathDocument : System.IO.Stream -> System.Xml.XPath.XPathDocument
Public Sub New (stream As Stream)

Parâmetros

stream
Stream

O objeto Stream que contém os dados XML.

Exceções

Um erro foi encontrado nos dados XML. O XPathDocument permanece vazio.

O objeto Stream passado como um parâmetro é null.

Aplica-se a

XPathDocument(String)

Origem:
XPathDocument.cs
Origem:
XPathDocument.cs
Origem:
XPathDocument.cs

Inicializa uma nova instância da classe XPathDocument dos dados XML no arquivo especificado.

public:
 XPathDocument(System::String ^ uri);
public XPathDocument (string uri);
new System.Xml.XPath.XPathDocument : string -> System.Xml.XPath.XPathDocument
Public Sub New (uri As String)

Parâmetros

uri
String

O caminho do arquivo que contém os dados XML.

Exceções

Um erro foi encontrado nos dados XML. O XPathDocument permanece vazio.

O parâmetro do caminho do arquivo é null.

Comentários

Para preservar o espaço em branco, use o XPathDocument construtor que aceita um XmlSpace objeto como um parâmetro.

Aplica-se a

XPathDocument(XmlReader)

Origem:
XPathDocument.cs
Origem:
XPathDocument.cs
Origem:
XPathDocument.cs

Inicializa uma nova instância da classe XPathDocument dos dados XML que estão contidos no objeto XmlReader.

public:
 XPathDocument(System::Xml::XmlReader ^ reader);
public XPathDocument (System.Xml.XmlReader reader);
new System.Xml.XPath.XPathDocument : System.Xml.XmlReader -> System.Xml.XPath.XPathDocument
Public Sub New (reader As XmlReader)

Parâmetros

reader
XmlReader

O objeto XmlReader que contém os dados XML.

Exceções

Um erro foi encontrado nos dados XML. O XPathDocument permanece vazio.

O objeto XmlReader passado como um parâmetro é null.

Comentários

Um XmlReader objeto pode ser usado para carregar um documento XML inteiro ou parte de um documento XML em um XPathDocument. Para carregar parte de um documento XML em um XPathDocument, posicione o XmlReader objeto no nó XML superior do qual carregar dados. Quando você cria um XPathDocument usando o construtor, os XPathDocument dados são carregados do nó superior atual por meio de todos os irmãos. Posteriormente, o XmlReader é posicionado no escopo externo do nó XML superior. Como alternativa, você pode usar o ReadSubtree método para carregar o XPathDocument em um elemento específico no documento XML.

Veja a seguir notas importantes a serem consideradas quando você usa o XPathDocument construtor.

  • Um XmlReader objeto com as configurações de objeto associadas XmlResolver apropriadas pode ser usado para resolver entidades ou outras referências em dados XML.

  • Se o XmlReader objeto estiver posicionado em um nó folha que não seja válido para o nível raiz de um documento - por exemplo, um nó de atributo ou espaço em branco - o XmlReader objeto continuará a ser lido até ser posicionado em um nó que pode ser usado para a raiz. O XPathDocument começa a ser carregado neste ponto.

  • Para preservar o espaço em branco, use o XPathDocument construtor que aceita um XmlSpace objeto como um parâmetro.

Aplica-se a

XPathDocument(TextReader)

Origem:
XPathDocument.cs
Origem:
XPathDocument.cs
Origem:
XPathDocument.cs

Inicializa uma nova instância da classe XPathDocument dos dados XML que estão contidos no objeto TextReader.

public:
 XPathDocument(System::IO::TextReader ^ textReader);
public:
 XPathDocument(System::IO::TextReader ^ reader);
public XPathDocument (System.IO.TextReader textReader);
public XPathDocument (System.IO.TextReader reader);
new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument
new System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocument
Public Sub New (textReader As TextReader)
Public Sub New (reader As TextReader)

Parâmetros

textReaderreader
TextReader

O objeto TextReader que contém os dados XML.

Exceções

Um erro foi encontrado nos dados XML. O XPathDocument permanece vazio.

O objeto TextReader passado como um parâmetro é null.

Comentários

Depois que o TextReader objeto tiver sido usado para carregar dados XML, o cursor do TextReader objeto será posicionado no final dos dados. O TextReader objeto deve ser redefinido para ler os dados novamente.

Aplica-se a

XPathDocument(String, XmlSpace)

Origem:
XPathDocument.cs
Origem:
XPathDocument.cs
Origem:
XPathDocument.cs

Inicializa uma nova instância da classe XPathDocument dos dados XML no arquivo especificado com a manipulação de espaço em branco especificada.

public:
 XPathDocument(System::String ^ uri, System::Xml::XmlSpace space);
public XPathDocument (string uri, System.Xml.XmlSpace space);
new System.Xml.XPath.XPathDocument : string * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument
Public Sub New (uri As String, space As XmlSpace)

Parâmetros

uri
String

O caminho do arquivo que contém os dados XML.

space
XmlSpace

Um objeto XmlSpace.

Exceções

Um erro foi encontrado nos dados XML. O XPathDocument permanece vazio.

O parâmetro de caminho de arquivo ou o parâmetro de objeto XmlSpace é null.

Comentários

  • O XmlSpace objeto passado como um parâmetro especifica se o espaço em branco deve ser preservado. Default preserva apenas espaço em branco significativo; Preserve preserva todo o espaço em branco. Por padrão, o XmlSpace objeto é definido como Default.

  • A funcionalidade do XPathDocument construtor é idêntica à do XPathDocument construtor, exceto pelas opções de manipulação de espaço em branco descritas.

Confira também

Aplica-se a

XPathDocument(XmlReader, XmlSpace)

Origem:
XPathDocument.cs
Origem:
XPathDocument.cs
Origem:
XPathDocument.cs

Inicializa uma nova instância da classe XPathDocument dos dados XML que estão contidos no objeto XmlReader especificado com a manipulação de espaço em branco especificada.

public:
 XPathDocument(System::Xml::XmlReader ^ reader, System::Xml::XmlSpace space);
public XPathDocument (System.Xml.XmlReader reader, System.Xml.XmlSpace space);
new System.Xml.XPath.XPathDocument : System.Xml.XmlReader * System.Xml.XmlSpace -> System.Xml.XPath.XPathDocument
Public Sub New (reader As XmlReader, space As XmlSpace)

Parâmetros

reader
XmlReader

O objeto XmlReader que contém os dados XML.

space
XmlSpace

Um objeto XmlSpace.

Exceções

Um erro foi encontrado nos dados XML. O XPathDocument permanece vazio.

O parâmetro de objeto XmlReader ou o parâmetro de objeto XmlSpace é null.

Comentários

  • O XmlSpace objeto passado como um parâmetro especifica se o espaço em branco deve ser preservado. Default preserva apenas espaço em branco significativo; Preserve preserva todo o espaço em branco. Por padrão, o XmlSpace objeto é definido como Default.

  • A funcionalidade do XPathDocument construtor é idêntica à do XPathDocument construtor, exceto pelas opções de manipulação de espaço em branco descritas.

Confira também

Aplica-se a