XPathDocument 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 XPathDocument 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| XPathDocument(Stream) |
從指定XPathDocument物件中的 XML 資料初始化該Stream類別的新實例。 |
| XPathDocument(String) |
從指定檔案中的 XML 資料初始化該 XPathDocument 類別的新實例。 |
| XPathDocument(XmlReader) |
從指定XPathDocument物件中包含的 XML 資料初始化該XmlReader類別的新實例。 |
| XPathDocument(TextReader) |
從指定XPathDocument物件中包含的 XML 資料初始化該TextReader類別的新實例。 |
| XPathDocument(String, XmlSpace) |
從指定且指定空白處理的檔案中的 XML 資料初始化該 XPathDocument 類別的新實例。 |
| XPathDocument(XmlReader, XmlSpace) |
從指定XPathDocument物件中包含的 XML 資料初始化該類別的新實例XmlReader，並以指定的空白處理方式處理。 |
XPathDocument(Stream)
從指定XPathDocument物件中的 XML 資料初始化該Stream類別的新實例。
public:
XPathDocument(System::IO::Stream ^ stream);public XPathDocument(System.IO.Stream stream);new System.Xml.XPath.XPathDocument : System.IO.Stream -> System.Xml.XPath.XPathDocumentPublic Sub New (stream As Stream)參數
例外狀況
XML 資料中出現錯誤。 XPathDocument剩下的空間是空的。
作為參數傳遞的 Stream 物件為 null。
適用於
XPathDocument(String)
從指定檔案中的 XML 資料初始化該 XPathDocument 類別的新實例。
public:
XPathDocument(System::String ^ uri);public XPathDocument(string uri);new System.Xml.XPath.XPathDocument : string -> System.Xml.XPath.XPathDocumentPublic Sub New (uri As String)參數
- uri
- String
包含 XML 資料的檔案路徑。
例外狀況
XML 資料中出現錯誤。 XPathDocument剩下的空間是空的。
檔案路徑參數為 null。
備註
為了保留空白，請使用 XPathDocument 接受 XmlSpace 物件作為參數的建構子。
適用於
XPathDocument(XmlReader)
從指定XPathDocument物件中包含的 XML 資料初始化該XmlReader類別的新實例。
public:
XPathDocument(System::Xml::XmlReader ^ reader);public XPathDocument(System.Xml.XmlReader reader);new System.Xml.XPath.XPathDocument : System.Xml.XmlReader -> System.Xml.XPath.XPathDocumentPublic Sub New (reader As XmlReader)參數
例外狀況
XML 資料中出現錯誤。 XPathDocument剩下的空間是空的。
作為參數傳遞的 XmlReader 物件為 null。
備註
XmlReader物件可以用來載入整個 XML 文件或其部分到 XPathDocument。 若要將 XML 文件的一部分載入 XPathDocument，請將物件置 XmlReader 於頂端 XML 節點以載入資料。 當你用XPathDocument建構子建立 by XPathDocument 時，資料會從目前頂端節點載入，經過所有兄弟節點。 之後，將 XmlReader 置於頂端 XML 節點的外層作用域。 或者，你也可以用這個 ReadSubtree 方法將 載 XPathDocument 入 XML 文件中的特定元素。
以下是使用 XPathDocument 建構子時需要注意的重要注意事項。
XmlReader具有適當相關XmlResolver物件設定的物件可用來解析 XML 資料中的實體或其他參考。
如果 XmlReader 物件位於不適用於文件根節點的葉節點上——例如空白區域或屬性節點——物件 XmlReader 會繼續讀取，直到被定位到可用於根節點的節點。 這時開始 XPathDocument 載入。
為了保留空白，請使用 XPathDocument 接受 XmlSpace 物件作為參數的建構子。
適用於
XPathDocument(TextReader)
從指定XPathDocument物件中包含的 XML 資料初始化該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.XPathDocumentnew System.Xml.XPath.XPathDocument : System.IO.TextReader -> System.Xml.XPath.XPathDocumentPublic Sub New (textReader As TextReader)Public Sub New (reader As TextReader)參數
- textReaderreader
- TextReader
包含 XML 資料的 TextReader 物件。
例外狀況
XML 資料中出現錯誤。 XPathDocument剩下的空間是空的。
作為參數傳遞的 TextReader 物件為 null。
備註
物件載入 XML 資料後 TextReader ，物件的 TextReader 游標會被置於資料的末端。 必須重置物件 TextReader 才能再次讀取資料。
適用於
XPathDocument(String, XmlSpace)
從指定且指定空白處理的檔案中的 XML 資料初始化該 XPathDocument 類別的新實例。
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.XPathDocumentPublic Sub New (uri As String, space As XmlSpace)參數
- uri
- String
包含 XML 資料的檔案路徑。
例外狀況
XML 資料中出現錯誤。 XPathDocument剩下的空間是空的。
檔案路徑參數或 XmlSpace 物件參數為 null。
備註
作為參數傳遞的 XmlSpace 物件指定是否要保留留白。 Default 僅保留顯著的留白; Preserve 保留所有空白空間。 預設情況下，物件 XmlSpace 設定為 Default。
建構子的功能 XPathDocument 與 XPathDocument 建構子相同，唯獨缺少上述的空白處理選項。
另請參閱
適用於
XPathDocument(XmlReader, XmlSpace)
從指定XPathDocument物件中包含的 XML 資料初始化該類別的新實例XmlReader，並以指定的空白處理方式處理。
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.XPathDocumentPublic Sub New (reader As XmlReader, space As XmlSpace)參數
例外狀況
XML 資料中出現錯誤。 XPathDocument剩下的空間是空的。
備註
作為參數傳遞的 XmlSpace 物件指定是否要保留留白。 Default 僅保留顯著的留白; Preserve 保留所有空白空間。 預設情況下，物件 XmlSpace 設定為 Default。
建構子的功能 XPathDocument 與 XPathDocument 建構子相同，唯獨缺少上述的空白處理選項。
