Udostępnij za pośrednictwem


XPathDocument Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy XPathDocument.

Przeciążenia

XPathDocument(Stream)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML w określonym Stream obiekcie.

XPathDocument(String)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML w określonym pliku.

XPathDocument(XmlReader)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML zawartych w określonym XmlReader obiekcie.

XPathDocument(TextReader)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML zawartych w określonym TextReader obiekcie.

XPathDocument(String, XmlSpace)

Inicjuje nowe wystąpienie XPathDocument klasy z danych XML w pliku określonym z określoną obsługą odstępów.

XPathDocument(XmlReader, XmlSpace)

Inicjuje nowe wystąpienie XPathDocument klasy z danych XML zawartych w określonym XmlReader obiekcie z określoną obsługą odstępów.

XPathDocument(Stream)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML w określonym Stream obiekcie.

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)

Parametry

stream
Stream

Stream Obiekt zawierający dane XML.

Wyjątki

Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.

Stream Obiekt przekazany jako parametr to null.

Dotyczy

XPathDocument(String)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML w określonym pliku.

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)

Parametry

uri
String

Ścieżka pliku zawierającego dane XML.

Wyjątki

Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.

Parametr ścieżki pliku to null.

Uwagi

Aby zachować białe odstępyXmlSpace, użyj konstruktoraXPathDocument, który akceptuje obiekt jako parametr.

Dotyczy

XPathDocument(XmlReader)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML zawartych w określonym XmlReader obiekcie.

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)

Parametry

reader
XmlReader

XmlReader Obiekt zawierający dane XML.

Wyjątki

Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.

XmlReader Obiekt przekazany jako parametr to null.

Uwagi

Obiekt XmlReader może służyć do ładowania całego dokumentu XML lub części dokumentu XML do obiektu XPathDocument. Aby załadować część dokumentu XML do XPathDocumentobiektu , umieść XmlReader obiekt w górnym węźle XML w celu załadowania danych. Podczas tworzenia obiektu XPathDocument przy użyciu konstruktora dane są ładowane z bieżącego górnego XPathDocument węzła przez wszystkie jego elementy równorzędne. XmlReader Następnie element znajduje się w zewnętrznym zakresie górnego węzła XML. Alternatywnie można użyć ReadSubtree metody , aby załadować element XPathDocument do określonego elementu w dokumencie XML.

Poniżej przedstawiono ważne uwagi, które należy wziąć pod uwagę podczas korzystania z konstruktora XPathDocument .

  • Obiekt XmlReader z odpowiednimi skojarzonymi XmlResolver ustawieniami obiektu może służyć do rozpoznawania jednostek lub innych odwołań w danych XML.

  • XmlReader Jeśli obiekt jest umieszczony w węźle liścia, który nie jest prawidłowy dla poziomu głównego dokumentu — na przykład biały odstęp lub węzeł atrybutu — XmlReader obiekt będzie nadal odczytywany, dopóki nie zostanie umieszczony w węźle, który może być używany dla katalogu głównego. Rozpoczyna XPathDocument się ładowanie w tym momencie.

  • Aby zachować białe odstępyXmlSpace, użyj konstruktoraXPathDocument, który akceptuje obiekt jako parametr.

Dotyczy

XPathDocument(TextReader)

Inicjuje XPathDocument nowe wystąpienie klasy z danych XML zawartych w określonym TextReader obiekcie.

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)

Parametry

textReaderreader
TextReader

TextReader Obiekt zawierający dane XML.

Wyjątki

Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.

TextReader Obiekt przekazany jako parametr to null.

Uwagi

Po załadowaniu TextReader danych TextReader XML obiekt jest umieszczony na końcu danych. Obiekt TextReader musi zostać zresetowany w celu ponownego odczytania danych.

Dotyczy

XPathDocument(String, XmlSpace)

Inicjuje nowe wystąpienie XPathDocument klasy z danych XML w pliku określonym z określoną obsługą odstępów.

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)

Parametry

uri
String

Ścieżka pliku zawierającego dane XML.

space
XmlSpace

Obiekt XmlSpace.

Wyjątki

Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.

Parametr ścieżki pliku lub XmlSpace parametr obiektu to null.

Uwagi

  • XmlSpace Obiekt przekazany jako parametr określa, czy zachować białe znaki. Default zachowuje tylko znaczną białą spację; Preserve zachowuje wszystkie białe znaki. Domyślnie XmlSpace obiekt jest ustawiony na Defaultwartość .

  • Funkcjonalność XPathDocument konstruktora jest taka sama jak XPathDocument w przypadku konstruktora, z wyjątkiem opisanych opcji obsługi odstępów.

Zobacz też

Dotyczy

XPathDocument(XmlReader, XmlSpace)

Inicjuje nowe wystąpienie XPathDocument klasy z danych XML zawartych w określonym XmlReader obiekcie z określoną obsługą odstępów.

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)

Parametry

reader
XmlReader

XmlReader Obiekt zawierający dane XML.

space
XmlSpace

Obiekt XmlSpace.

Wyjątki

Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.

XmlReader Parametr obiektu lub XmlSpace parametr obiektu to null.

Uwagi

  • XmlSpace Obiekt przekazany jako parametr określa, czy zachować białe znaki. Default zachowuje tylko znaczną białą spację; Preserve zachowuje wszystkie białe znaki. Domyślnie XmlSpace obiekt jest ustawiony na Defaultwartość .

  • Funkcjonalność XPathDocument konstruktora jest taka sama jak XPathDocument w przypadku konstruktora, z wyjątkiem opisanych opcji obsługi odstępów.

Zobacz też

Dotyczy