XmlDataDocument.Load Метод

Определение

Пространство имен:

System.Xml

Сборка:

System.Data.Common.dll

XmlDataDocument Загружает указанный источник данных и синхронизирует DataSet их с загруженными данными.

Перегрузки

Имя	Описание
Load(Stream)	XmlDataDocument Загружается из указанного потока.
Load(TextReader)	Загружает указанный XmlDataDocumentTextReaderобъект.
Load(String)	Загружает указанный XmlDataDocument URL-адрес.
Load(XmlReader)	Загружает указанный XmlDataDocumentXmlReaderобъект.

Комментарии

Замечание

Чтобы просмотреть xml-данные относительно, сначала необходимо указать схему, используемую для сопоставления данных. Это можно сделать, вызвав ReadXmlSchema метод или создав таблицы и столбцы в ручном режиме DataSet . Перед вызовом Loadнеобходимо выполнить этот шаг.

XmlDataDocument не поддерживает создание ссылок на сущности. Если данные содержат ссылки на сущности, Load метод разрешает и расширяет все ссылки на сущности. Однако если вы используете перегрузку Load , XmlReader принимающую в качестве аргумента, необходимо указать XmlReader , что может разрешать сущности.

Load(Stream)

Исходный код:

XmlDataDocument.cs

XmlDataDocument Загружается из указанного потока.

public:
 override void Load(System::IO::Stream ^ inStream);

public override void Load(System.IO.Stream inStream);

override this.Load : System.IO.Stream -> unit

Public Overrides Sub Load (inStream As Stream)

Параметры

inStream

Stream

Поток, содержащий XML-документ для загрузки.

Комментарии

XmlDataDocument не поддерживает создание ссылок на сущности. Если данные содержат ссылки на сущности, Load метод разрешает и расширяет все ссылки на сущности.

Замечание

Чтобы просмотреть xml-данные относительно, сначала необходимо указать схему, используемую для сопоставления данных. Это можно сделать, вызвав ReadXmlSchema метод или создав таблицы и столбцы в ручном режиме DataSet . Перед вызовом Loadнеобходимо выполнить этот шаг.

Load(TextReader)

Исходный код:

XmlDataDocument.cs

Загружает указанный XmlDataDocumentTextReaderобъект.

public:
 override void Load(System::IO::TextReader ^ txtReader);

public override void Load(System.IO.TextReader txtReader);

override this.Load : System.IO.TextReader -> unit

Public Overrides Sub Load (txtReader As TextReader)

Параметры

txtReader

TextReader

Используется TextReader для отправки XML-данных в документ.

Комментарии

XmlDataDocument не поддерживает создание ссылок на сущности. Если данные содержат ссылки на сущности, Load метод разрешает и расширяет все ссылки на сущности.

Замечание

Чтобы просмотреть xml-данные относительно, сначала необходимо указать схему, используемую для сопоставления данных. Это можно сделать, вызвав ReadXmlSchema метод или создав таблицы и столбцы в ручном режиме DataSet . Перед вызовом Loadнеобходимо выполнить этот шаг.

Load(String)

Исходный код:

XmlDataDocument.cs

Загружает указанный XmlDataDocument URL-адрес.

public:
 override void Load(System::String ^ filename);

public override void Load(string filename);

override this.Load : string -> unit

Public Overrides Sub Load (filename As String)

Параметры

filename

String

URL-адрес файла, содержащего XML-документ для загрузки.

Комментарии

XmlDataDocument не поддерживает создание ссылок на сущности. Если данные содержат ссылки на сущности, Load метод разрешает и расширяет все ссылки на сущности.

Замечание

Чтобы просмотреть xml-данные относительно, сначала необходимо указать схему, используемую для сопоставления данных. Это можно сделать, вызвав ReadXmlSchema метод или создав таблицы и столбцы в ручном режиме DataSet . Перед вызовом Loadнеобходимо выполнить этот шаг.

Load(XmlReader)

Исходный код:

XmlDataDocument.cs

Загружает указанный XmlDataDocumentXmlReaderобъект.

public:
 override void Load(System::Xml::XmlReader ^ reader);

public override void Load(System.Xml.XmlReader reader);

override this.Load : System.Xml.XmlReader -> unit

Public Overrides Sub Load (reader As XmlReader)

Параметры

reader

XmlReader

Содержащий XmlReader XML-документ для загрузки.

Исключения

NotSupportedException

Xml-файл, загруженный, содержит ссылки на сущности, и читатель не может разрешать сущности.

Комментарии

XmlDataDocument не поддерживает создание ссылок на сущности. Если источник данных содержит ссылки на сущности, необходимо создать XmlValidatingReaderEntityHandling свойство с параметром EntityHandling.ExpandEntities (это поведение по умолчанию) и передать XmlValidatingReader методу Load . Если этот метод не используется XmlValidatingReader, Load метод создает исключение.

Метод Load всегда сохраняет значительное пробелы. Свойство PreserveWhitespace определяет, сохраняются ли пробелы. Значение по умолчанию false— пробелы не сохраняются.

Если средство чтения находится в исходном состоянии (то есть ReadState=ReadState.Initial), Load использует все содержимое средства чтения и создает объект DOM из того, что он находит.

Если средство чтения уже размещено на некотором узле на глубине "n", этот метод загружает этот узел и все последующие братья и сестры до конечного тега, закрывающего глубину "n". Это имеет следующие результаты.

Если текущий узел и его следующие одноуровневые элементы выглядят примерно так:

<!--comment--><element1>one</element1><element2>two</element2>

Load создает исключение, так как документ не может содержать два элемента корневого уровня. Если текущий узел и его следующие одноуровневые элементы выглядят примерно так:

<!--comment--><?process
    instruction?><!--comment--></endtag>

Load будет успешно выполнено; однако у вас будет неполное дерево DOM, так как отсутствует элемент корневого уровня. Перед сохранением документа необходимо добавить элемент корневого уровня; В Save противном случае метод создает исключение.

Если считыватель находится на конечном узле, который недопустим для корневого уровня документа (например, пробел или узел атрибута), он продолжает чтение, пока не окажется на узле, который можно использовать для корневого уровня. Документ начинает загрузку на этом этапе.