XPathDocument Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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
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.
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
Wyjątki
Wystąpił błąd w danych XML. Pozostaje XPathDocument pusty.
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.