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

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した XML データを、 Stream、URL、 TextReader、または XmlReaderから読み込みます。

オーバーロード

名前	説明
Load(Stream)	指定したストリームから XML ドキュメントを読み込みます。
Load(TextReader)	指定した TextReaderから XML ドキュメントを読み込みます。
Load(String)	指定した URL から XML ドキュメントを読み込みます。
Load(XmlReader)	指定した XmlReaderから XML ドキュメントを読み込みます。

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 です。要素コンテンツの空白は保持されません。

検証を実行する場合は、XmlReaderSettings クラスとCreate メソッドを使用して、検証XmlReaderインスタンスを作成できます。詳細については、XmlReader のリファレンスページの「解説」を参照してください。

このメソッドは、ドキュメントオブジェクトモデル (DOM) に対する Microsoft の拡張機能です。

このメソッドは、入力 XML の文字列形式 (UTF-8、ANSI など) を自動的に検出します。アプリケーションでストリームの読み取りに使用されるエンコードを把握する必要がある場合は、 XmlTextReader オブジェクトを使用してストリームを読み取り、 XmlTextReader.Encoding プロパティを使用してエンコードを決定することを検討してください。 XmlDocument オブジェクトを使用して XML を操作する必要がある場合は、XmlTextReader オブジェクトを使用して作成できます。詳細については、「 XPathDocument と XmlDocument を使用した XML データの読み取り」を参照してください。

こちらもご覧ください

適用対象

Load(TextReader)

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

指定した TextReaderから XML ドキュメントを読み込みます。

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

注釈

注

このメソッドは、ドキュメントオブジェクトモデル (DOM) に対する Microsoft の拡張機能です。

こちらもご覧ください

適用対象

Load(String)

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

指定した URL から XML ドキュメントを読み込みます。

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

読み込む XML ドキュメントを含むファイルの URL。 URL には、ローカルファイルまたは HTTP URL (Web アドレス) を指定できます。

例外

XmlException

XML に読み込みまたは解析エラーがあります。この場合、 FileNotFoundException が発生します。

ArgumentException

filename は長さ 0 の文字列で、空白のみを含むか、 InvalidPathCharsで定義されている 1 つ以上の無効な文字を含みます。

ArgumentNullException

filename は nullです。

PathTooLongException

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

DirectoryNotFoundException

指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。

IOException

ファイルを開くときに I/O エラーが発生しました。

UnauthorizedAccessException

filename は、読み取り専用のファイルを指定しました。

-又は-

この操作は、現在のプラットフォームではサポートされていません。

-又は-

filename はディレクトリを指定しました。

-又は-

呼び出し元に必要なアクセス許可がありません。

FileNotFoundException

filenameで指定されたファイルが見つかりませんでした。

NotSupportedException

filename が無効な形式です。

SecurityException

呼び出し元に必要なアクセス許可がありません。

注釈

注

このメソッドは、ドキュメントオブジェクトモデル (DOM) に対する Microsoft の拡張機能です。

こちらもご覧ください

適用対象

Load(XmlReader)

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

ソース:: XmlDocument.cs

指定した XmlReaderから XML ドキュメントを読み込みます。

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>

注釈

注

リーダーが初期状態 (ReadState =ReadState.Initial) の場合、 Load はリーダーの内容全体を使用し、見つけたものから DOM をビルドします。

リーダーが既に深さ "n" のノードに配置されている場合、このメソッドは、そのノードとその後のすべての兄弟を、深さ "n" を閉じる終了タグまで読み込みます。これには次の結果があります。

現在のノードとその兄弟が次のようになります。

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

Load は、ドキュメントに 2 つのルートレベル要素を含めることができないため、例外をスローします。現在のノードとその兄弟が次のようになります。

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

Load は成功しますが、ルートレベル要素がないため、不完全な DOM ツリーがあります。ドキュメントを保存する前に、ルートレベルの要素を追加する必要があります。そうしないと、 Save は例外をスローします。

リーダーが、ドキュメントのルートレベル (空白や属性ノードなど) に対して無効なリーフノードに配置されている場合、リーダーはルートに使用できるノードに配置されるまで読み取りを続行します。この時点でドキュメントの読み込みが開始されます。

このメソッドは、ドキュメントオブジェクトモデル (DOM) に対する Microsoft の拡張機能です。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?

次の方法で共有

XmlDocument.Load メソッド

定義

オーバーロード

Load(Stream)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

Load(TextReader)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

Load(String)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

Load(XmlReader)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック