Поделиться через

XmlDocument.Load Метод

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.XmlDocument.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.XmlDocument.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

Загружает указанные XML-данные из StreamURL-адреса, url-адреса TextReaderили объекта XmlReader.

Перегрузки

Имя Описание
Load(Stream)

Загружает XML-документ из указанного потока.
Load(TextReader)

Загружает XML-документ из указанного TextReader.
Load(String)

Загружает XML-документ из указанного URL-адреса.
Load(XmlReader)

Загружает XML-документ из указанного XmlReader.

Load(Stream)

Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs

Загружает XML-документ из указанного потока.

public:
 virtual void Load(System::IO::Stream ^ inStream);
public virtual void Load(System.IO.Stream inStream);
abstract member Load : System.IO.Stream -> unit
override this.Load : System.IO.Stream -> unit
Public Overridable Sub Load (inStream As Stream)

Параметры

inStream
Stream

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

Исключения

XmlException

В XML возникает ошибка загрузки или синтаксического анализа. В этом случае FileNotFoundException вызывается.

Комментарии

Замечание

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

Если требуется выполнить проверку, можно создать проверяющий XmlReader экземпляр с помощью XmlReaderSettings класса и Create метода. Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

Этот метод автоматически обнаруживает формат строки входного XML (например, UTF-8, ANSI и т. д.). Если приложению необходимо знать, какая кодировка используется для чтения потока, рассмотрите возможность использования XmlTextReader объекта для чтения потока, а затем используйте XmlTextReader.Encoding свойство для определения кодировки. Если необходимо использовать XmlDocument объект для работы с XML, можно использовать XmlTextReader объект для создания. Дополнительные сведения см. в разделе "Чтение XML-данных с помощью XPathDocument и XmlDocument".

См. также раздел

Применяется к

Load(TextReader)

Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs

Загружает XML-документ из указанного TextReader.

public:
 virtual void Load(System::IO::TextReader ^ txtReader);
public virtual void Load(System.IO.TextReader txtReader);
abstract member Load : System.IO.TextReader -> unit
override this.Load : System.IO.TextReader -> unit
Public Overridable Sub Load (txtReader As TextReader)

Параметры

txtReader
TextReader

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

Исключения

XmlException

В XML возникает ошибка загрузки или синтаксического анализа. В этом случае документ остается пустым.

Примеры

В следующем примере класс используется StringReader для загрузки строки XML-данных в XmlDocument объект.

using System;
using System.IO;
using System.Xml;

public class Sample1
{
  public static void CreateElementExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    string xmlData = "<book xmlns:bk='urn:samples'></book>";

    doc.Load(new StringReader(xmlData));

    // Create a new element and add it to the document.
    XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
    elem.InnerText = "fantasy";
    doc.DocumentElement.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 

    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"

    doc.Load(new StringReader(xmlData))

    ' Create a new element and add it to the document.
    Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
    elem.InnerText = "fantasy"
    doc.DocumentElement.AppendChild(elem)

    Console.WriteLine("Display the modified XML...")
    doc.Save(Console.Out)

  end sub
end class

Комментарии

Замечание

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

Если требуется выполнить проверку, можно создать проверяющий XmlReader экземпляр с помощью XmlReaderSettings класса и Create метода. Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

См. также раздел

Применяется к

Load(String)

Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs

Загружает XML-документ из указанного URL-адреса.

public:
 virtual void Load(System::String ^ filename);
public virtual void Load(string filename);
abstract member Load : string -> unit
override this.Load : string -> unit
Public Overridable Sub Load (filename As String)

Параметры

filename
String

URL-адрес файла, содержащего XML-документ для загрузки. URL-адрес может быть локальным файлом или URL-адресом HTTP (веб-адресом).

Исключения

XmlException

В XML возникает ошибка загрузки или синтаксического анализа. В этом случае FileNotFoundException вызывается.

ArgumentException

filename — строка нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов, как определено InvalidPathChars.

ArgumentNullException

filename равно null.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

DirectoryNotFoundException

Указанный путь недопустим (например, он находится на несопоставленном диске).

IOException

При открытии файла произошла ошибка ввода-вывода.

UnauthorizedAccessException

filename указали файл, доступный только для чтения.

–или–

Эта операция не поддерживается на текущей платформе.

–или–

filename указан каталог.

–или–

Вызывающий объект не имеет требуемого разрешения.

FileNotFoundException

Файл, указанный в filename, не найден.

NotSupportedException

filename имеет недопустимый формат.

SecurityException

Вызывающий объект не имеет требуемого разрешения.

Комментарии

Замечание

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

Если требуется выполнить проверку, можно создать проверяющий XmlReader экземпляр с помощью XmlReaderSettings класса и Create метода. Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

См. также раздел

Применяется к

Load(XmlReader)

Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs
Исходный код:
XmlDocument.cs

Загружает XML-документ из указанного XmlReader.

public:
 virtual void Load(System::Xml::XmlReader ^ reader);
public virtual void Load(System.Xml.XmlReader reader);
abstract member Load : System.Xml.XmlReader -> unit
override this.Load : System.Xml.XmlReader -> unit
Public Overridable Sub Load (reader As XmlReader)

Параметры

reader
XmlReader

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

Исключения

XmlException

В XML возникает ошибка загрузки или синтаксического анализа. В этом случае документ остается пустым.

Примеры

В следующем примере загружается последний узел книги books.xml файла в XML-документ.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();

    //Load the document with the last book node.
    XmlTextReader reader = new XmlTextReader("books.xml");
    reader.WhitespaceHandling = WhitespaceHandling.None;
    reader.MoveToContent();
    reader.Read();
    reader.Skip(); //Skip the first book.
    reader.Skip(); //Skip the second book.
    doc.Load(reader);

    doc.Save(Console.Out);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        
        'Load the document with the last book node.
        Dim reader As New XmlTextReader("books.xml")
        reader.WhitespaceHandling = WhitespaceHandling.None
        reader.MoveToContent()
        reader.Read()
        reader.Skip() 'Skip the first book.
        reader.Skip() 'Skip the second book.
        doc.Load(reader)
        
        doc.Save(Console.Out)
    End Sub
End Class

В этом примере файл books.xmlиспользуется в качестве входных данных.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

Комментарии

Замечание

Метод 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 возникнет исключение.

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

Если требуется выполнить проверку, можно создать проверяющий XmlReader экземпляр с помощью XmlReaderSettings класса и Create метода. Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

Этот метод является расширением Майкрософт для объектной модели документов (DOM).

См. также раздел

Применяется к