Condividi tramite


XPathDocument Costruttori

Definizione

Inizializza una nuova istanza della classe XPathDocument.

Overload

XPathDocument(Stream)

Inizializza una nuova istanza della classe XPathDocument dai dati XML nell'oggetto Stream specificato.

XPathDocument(String)

Inizializza una nuova istanza della classe XPathDocument dai dati XML nel file specificato.

XPathDocument(XmlReader)

Inizializza una nuova istanza della classe XPathDocument dai dati XML contenuti nell'oggetto XmlReader specificato.

XPathDocument(TextReader)

Inizializza una nuova istanza della classe XPathDocument dai dati XML contenuti nell'oggetto TextReader specificato.

XPathDocument(String, XmlSpace)

Inizializza una nuova istanza della classe XPathDocument dai dati XML nel file specificato con la gestione degli spazi vuoti specificata.

XPathDocument(XmlReader, XmlSpace)

Inizializza una nuova istanza della classe XPathDocument dai dati XML contenuti nell'oggetto XmlReader specificato con la gestione degli spazi vuoti specificata.

XPathDocument(Stream)

Origine:
XPathDocument.cs
Origine:
XPathDocument.cs
Origine:
XPathDocument.cs

Inizializza una nuova istanza della classe XPathDocument dai dati XML nell'oggetto Stream specificato.

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)

Parametri

stream
Stream

Oggetto Stream contenente i dati XML.

Eccezioni

È stato rilevato un errore nei dati XML. L'oggetto XPathDocument rimane vuoto.

L'oggetto Stream passato come parametro è null.

Si applica a

XPathDocument(String)

Origine:
XPathDocument.cs
Origine:
XPathDocument.cs
Origine:
XPathDocument.cs

Inizializza una nuova istanza della classe XPathDocument dai dati XML nel file specificato.

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)

Parametri

uri
String

Percorso del file contenente i dati XML.

Eccezioni

È stato rilevato un errore nei dati XML. L'oggetto XPathDocument rimane vuoto.

Il parametro del percorso del file è null.

Commenti

Per mantenere lo spazio vuoto, usare il XPathDocument costruttore che accetta un XmlSpace oggetto come parametro.

Si applica a

XPathDocument(XmlReader)

Origine:
XPathDocument.cs
Origine:
XPathDocument.cs
Origine:
XPathDocument.cs

Inizializza una nuova istanza della classe XPathDocument dai dati XML contenuti nell'oggetto XmlReader specificato.

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)

Parametri

reader
XmlReader

Oggetto XmlReader contenente i dati XML.

Eccezioni

È stato rilevato un errore nei dati XML. L'oggetto XPathDocument rimane vuoto.

L'oggetto XmlReader passato come parametro è null.

Commenti

Un XmlReader oggetto può essere usato per caricare un documento XML intero o una parte di un documento XML in un XPathDocumentoggetto . Per caricare parte di un documento XML in un XPathDocumentoggetto , posizionare l'oggetto XmlReader nel nodo XML superiore da cui caricare i dati. Quando si crea un oggetto XPathDocument usando il XPathDocument costruttore, i dati vengono caricati dal nodo superiore corrente attraverso tutti i relativi fratelli. Successivamente, l'oggetto XmlReader viene posizionato nell'ambito esterno del nodo XML superiore. In alternativa, è possibile usare il ReadSubtree metodo per caricare l'oggetto XPathDocument in un particolare elemento nel documento XML.

Di seguito sono riportate note importanti da considerare quando si usa il XPathDocument costruttore.

  • Un XmlReader oggetto con le impostazioni di oggetto associate XmlResolver appropriate può essere usato per risolvere le entità o altri riferimenti nei dati XML.

  • Se l'oggetto XmlReader viene posizionato in un nodo foglia non valido per il livello radice di un documento, ad esempio uno spazio vuoto o un nodo attributo, l'oggetto XmlReader continua a leggere finché non viene posizionato su un nodo che può essere usato per la radice. Il XPathDocument caricamento inizia a questo punto.

  • Per mantenere lo spazio vuoto, usare il XPathDocument costruttore che accetta un XmlSpace oggetto come parametro.

Si applica a

XPathDocument(TextReader)

Origine:
XPathDocument.cs
Origine:
XPathDocument.cs
Origine:
XPathDocument.cs

Inizializza una nuova istanza della classe XPathDocument dai dati XML contenuti nell'oggetto TextReader specificato.

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)

Parametri

textReaderreader
TextReader

Oggetto TextReader contenente i dati XML.

Eccezioni

È stato rilevato un errore nei dati XML. L'oggetto XPathDocument rimane vuoto.

L'oggetto TextReader passato come parametro è null.

Commenti

Dopo l'uso dell'oggetto TextReader per caricare i dati XML, il cursore dell'oggetto TextReader viene posizionato alla fine dei dati. L'oggetto TextReader deve essere reimpostato per leggere di nuovo i dati.

Si applica a

XPathDocument(String, XmlSpace)

Origine:
XPathDocument.cs
Origine:
XPathDocument.cs
Origine:
XPathDocument.cs

Inizializza una nuova istanza della classe XPathDocument dai dati XML nel file specificato con la gestione degli spazi vuoti specificata.

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)

Parametri

uri
String

Percorso del file contenente i dati XML.

space
XmlSpace

Oggetto XmlSpace.

Eccezioni

È stato rilevato un errore nei dati XML. L'oggetto XPathDocument rimane vuoto.

Il parametro del percorso del file o dell'oggetto XmlSpace è null.

Commenti

  • L'oggetto XmlSpace passato come parametro specifica se mantenere lo spazio vuoto. Default mantiene solo uno spazio vuoto significativo; Preserve mantiene tutti gli spazi vuoti. Per impostazione predefinita, l'oggetto XmlSpace è impostato su Default.

  • La funzionalità del XPathDocument costruttore è identica a quella del costruttore, ad eccezione delle XPathDocument opzioni di gestione dello spazio vuoto descritte.

Vedi anche

Si applica a

XPathDocument(XmlReader, XmlSpace)

Origine:
XPathDocument.cs
Origine:
XPathDocument.cs
Origine:
XPathDocument.cs

Inizializza una nuova istanza della classe XPathDocument dai dati XML contenuti nell'oggetto XmlReader specificato con la gestione degli spazi vuoti specificata.

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)

Parametri

reader
XmlReader

Oggetto XmlReader contenente i dati XML.

space
XmlSpace

Oggetto XmlSpace.

Eccezioni

È stato rilevato un errore nei dati XML. L'oggetto XPathDocument rimane vuoto.

Il parametro dell'oggetto XmlReader o dell'oggetto XmlSpace è null.

Commenti

  • L'oggetto XmlSpace passato come parametro specifica se mantenere lo spazio vuoto. Default mantiene solo uno spazio vuoto significativo; Preserve mantiene tutti gli spazi vuoti. Per impostazione predefinita, l'oggetto XmlSpace è impostato su Default.

  • La funzionalità del XPathDocument costruttore è identica a quella del costruttore, ad eccezione delle XPathDocument opzioni di gestione dello spazio vuoto descritte.

Vedi anche

Si applica a