XPathDocument Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса XPathDocument.
Перегрузки
| XPathDocument(Stream) |
Инициализация нового экземпляра класса XPathDocument из XML-данных в указанном объекте Stream. |
| XPathDocument(String) |
Инициализация нового экземпляра класса XPathDocument из XML-данных в указанном файле. |
| XPathDocument(XmlReader) |
Инициализация нового экземпляра класса XPathDocument из XML-данных, содержащихся в указанном объекте XmlReader. |
| XPathDocument(TextReader) |
Инициализация нового экземпляра класса XPathDocument из XML-данных, содержащихся в указанном объекте TextReader. |
| XPathDocument(String, XmlSpace) |
Инициализация нового экземпляра класса XPathDocument из XML-данных в указанном файле с указанной обработкой пробелов. |
| 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)
Инициализация нового экземпляра класса XPathDocument из XML-данных в указанном файле.
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-документа или части XML-документа в .XPathDocument Чтобы загрузить часть XML-документа в XPathDocumentобъект, разместите XmlReader объект на верхнем узле XML для загрузки данных. При создании с XPathDocument помощью конструктора 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
Объект TextReader, содержащий XML-данные.
Исключения
В XML-данных возникла ошибка. XPathDocument остается пустым.
Объект TextReader, переданный в качестве параметра, является null.
Комментарии
TextReader После использования объекта для загрузки XML-данных курсор TextReader объекта размещается в конце данных. Объект TextReader должен быть сброшен для повторного чтения данных.
Применяется к
XPathDocument(String, XmlSpace)
Инициализация нового экземпляра класса XPathDocument из XML-данных в указанном файле с указанной обработкой пробелов.
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 , за исключением описанных параметров обработки пробелов.