XElement.Load XElement.Load XElement.Load XElement.Load Method

定義

URI で指定されたファイル、TextReader、または XmlReader から、新しい XElement を作成します。Creates a new XElement from a file specified by a URI, from an TextReader, or from an XmlReader.

オーバーロード

Load(TextReader, LoadOptions) Load(TextReader, LoadOptions) Load(TextReader, LoadOptions)

TextReader から XElement を読み込み、オプションで、空白の維持および行情報の保持を行います。Loads an XElement from a TextReader, optionally preserving white space and retaining line information.

Load(XmlReader, LoadOptions) Load(XmlReader, LoadOptions) Load(XmlReader, LoadOptions) Load(XmlReader, LoadOptions)

XmlReader から XElement を読み込み、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。Loads an XElement from an XmlReader, optionally preserving white space, setting the base URI, and retaining line information.

Load(String, LoadOptions) Load(String, LoadOptions) Load(String, LoadOptions) Load(String, LoadOptions)

ファイルから XElement を読み込み、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。Loads an XElement from a file, optionally preserving white space, setting the base URI, and retaining line information.

Load(Stream, LoadOptions) Load(Stream, LoadOptions) Load(Stream, LoadOptions)

指定されたストリームを使用して新しい XElement インスタンスを作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。Creates a new XElement instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

Load(TextReader) Load(TextReader) Load(TextReader)

TextReader から XElement を読み込みます。Loads an XElement from a TextReader.

Load(String) Load(String) Load(String) Load(String)

ファイルから XElement を読み込みます。Loads an XElement from a file.

Load(Stream) Load(Stream) Load(Stream)

指定されたストリームを使用して新しい XElement インスタンスを作成します。Creates a new XElement instance by using the specified stream.

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

XmlReader から XElement を読み込みます。Loads an XElement from an XmlReader.

注釈

このメソッドのオーバーロードのいずれかを使用して、ファイル、TextReader、または XmlReader から XElement を読み込むことができます。You can use one of the overloads of this method to load an XElement from a file, a TextReader, or an XmlReader.

XML を含む文字列から @no__t 0 を作成するには、Parse を使用します。To create an XElement from a string that contains XML, use Parse.

Load(TextReader, LoadOptions) Load(TextReader, LoadOptions) Load(TextReader, LoadOptions)

TextReader から XElement を読み込み、オプションで、空白の維持および行情報の保持を行います。Loads an XElement from a TextReader, optionally preserving white space and retaining line information.

public:
 static System::Xml::Linq::XElement ^ Load(System::IO::TextReader ^ textReader, System::Xml::Linq::LoadOptions options);
public static System.Xml.Linq.XElement Load (System.IO.TextReader textReader, System.Xml.Linq.LoadOptions options);
static member Load : System.IO.TextReader * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XElement

パラメーター

textReader
TextReader TextReader TextReader TextReader

XElement の内容として読み込む TextReaderA TextReader that will be read for the XElement content.

options
LoadOptions LoadOptions LoadOptions LoadOptions

空白に対する動作、およびベース URI と行情報を読み込むかどうかを指定する LoadOptionsA LoadOptions that specifies white space behavior, and whether to load base URI and line information.

戻り値

指定した TextReader から読み込まれた XML を格納している XElementAn XElement that contains the XML that was read from the specified TextReader.

次の例では、2つの異なる方法で StringReader の @no__t 0 を読み込みます。空白を維持し、空白は保持しません。The following example loads an XElement from a StringReader in two different ways: preserving white space, and not preserving white space. 次に、クエリを使用して、結果の XML ツリー内の空白ノードの数を決定します。It then uses a query to determine the number of white space nodes in the resulting XML tree.

TextReader sr;  
int whiteSpaceNodes;  
  
sr = new StringReader("<Root> <Child> </Child> </Root>");  
XElement xmlTree1 = XElement.Load(sr, LoadOptions.None);  
sr.Close();  
whiteSpaceNodes = xmlTree1  
    .DescendantNodesAndSelf()  
    .OfType<XText>()  
    .Where(tNode => tNode.ToString().Trim().Length == 0)  
    .Count();  
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes);  
  
sr = new StringReader("<Root> <Child> </Child> </Root>");  
XElement xmlTree2 = XElement.Load(sr, LoadOptions.PreserveWhitespace);  
sr.Close();  
whiteSpaceNodes = xmlTree2  
    .DescendantNodesAndSelf()  
    .OfType<XText>()  
    .Where(tNode => tNode.ToString().Trim().Length == 0)  
    .Count();  
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes);  
Dim sr As TextReader  
Dim whiteSpaceNodes As Integer  
  
sr = New StringReader("<Root> <Child> </Child> </Root>")  
Dim xmlTree1 As XElement = XElement.Load(sr, LoadOptions.None)  
sr.Close()  
whiteSpaceNodes = xmlTree1 _  
    .DescendantNodesAndSelf() _  
    .OfType(Of XText)() _  
    .Where(Function(ByVal tNode As XNode) tNode.ToString().Trim().Length = 0) _  
    .Count()  
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes)  
  
sr = New StringReader("<Root> <Child> </Child> </Root>")  
Dim xmlTree2 As XElement = XElement.Load(sr, LoadOptions.PreserveWhitespace)  
sr.Close()  
whiteSpaceNodes = xmlTree2 _  
    .DescendantNodesAndSelf() _  
    .OfType(Of XText)() _  
    .Where(Function(ByVal tNode As XNode) tNode.ToString().Trim().Length = 0) _  
    .Count()  
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Count of white space nodes (not preserving whitespace): 0  
Count of white space nodes (preserving whitespace): 3  

次の例では、TextReader から読み込まれた行情報を読み込みます。The following example loads the line information as it loads from the TextReader. 次に、行情報を出力します。It then prints the line information.

TextReader sr = new StringReader(  
@"<Root>  
  <Child>  
    <GrandChild1/>  
    <GrandChild2/>  
  </Child>  
</Root>");  
XElement po = XElement.Load(sr,  
    LoadOptions.SetLineInfo);  
Console.WriteLine("{0}{1}{2}",  
    "Element Name".PadRight(20),  
    "Line".PadRight(5),  
    "Position");  
Console.WriteLine("{0}{1}{2}",  
    "------------".PadRight(20),  
    "----".PadRight(5),  
    "--------");  
foreach (XElement e in po.DescendantsAndSelf())  
    Console.WriteLine("{0}{1}{2}",  
        ("".PadRight(e.Ancestors().Count() * 2) + e.Name).PadRight(20),  
        ((IXmlLineInfo)e).LineNumber.ToString().PadRight(5),  
        ((IXmlLineInfo)e).LinePosition);  
Dim sr As TextReader = New StringReader( _  
    "<Root>" & Environment.NewLine & _  
    "  <Child>" & Environment.NewLine & _  
    "    <GrandChild1/>" & Environment.NewLine & _  
    "    <GrandChild2/>" & Environment.NewLine & _  
    "  </Child>" & Environment.NewLine & _  
    "</Root>")  
Dim po As XElement = XElement.Load(sr, LoadOptions.SetLineInfo)  
Console.WriteLine("{0}{1}{2}", _  
    "Element Name".PadRight(20), _  
    "Line".PadRight(5), _  
    "Position")  
Console.WriteLine("{0}{1}{2}", _  
    "------------".PadRight(20), _  
    "----".PadRight(5), _  
    "--------")  
For Each e As XElement In po.DescendantsAndSelf()  
    Console.WriteLine("{0}{1}{2}", _  
        ("".PadRight(e.Ancestors().Count() * 2) & e.Name.ToString).PadRight(20), _  
        (DirectCast(e, IXmlLineInfo)).LineNumber.ToString().PadRight(5), _  
        (DirectCast(e, IXmlLineInfo)).LinePosition)  
Next  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Element Name        Line Position  
------------        ---- --------  
Root                1    2  
  Child             2    4  
    GrandChild1     3    6  
    GrandChild2     4    6  

注釈

ソース XML がインデントされている場合は、optionsPreserveWhitespace フラグを設定すると、リーダーはソース XML 内のすべての空白文字を読み取ります。If the source XML is indented, setting the PreserveWhitespace flag in options causes the reader to read all white space in the source XML. @No__t-0 型のノードは、有意な空白と意味のない空白の両方に対して作成されます。Nodes of type XText are created for both significant and insignificant white space.

ソース XML がインデントされている場合、optionsPreserveWhitespace フラグを設定しないと、リーダーはソース XML 内のすべての意味のない空白を無視します。If the source XML is indented, not setting the PreserveWhitespace flag in options causes the reader to ignore all of the insignificant white space in the source XML. XML ツリーは、意味のない空白のテキストノードなしで作成されます。The XML tree is created without any text nodes for insignificant white space.

ソース XML がインデントされていない場合は、optionsPreserveWhitespace フラグを設定しても効果はありません。If the source XML is not indented, setting the PreserveWhitespace flag in options has no effect. 有意の空白は保持されていますが、余分な空白文字の数が増えても、余分な空白のテキストノードが作成される可能性があります。Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes.

詳細については、「 XML の読み込み時または解析時の空白の保持」と「シリアル化時の空白の維持」を参照してください。For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

@No__t-0 を使用して、XML を含む文字列から XElement を作成します。Use Parse to create an XElement from a string that contains XML.

@No__t-0 の設定は、TextReader からの読み込み時には効果がありません。Setting SetBaseUri will have no effect when loading from a TextReader.

@No__t-0 フラグを設定すると、パフォーマンスが低下します。There is a performance penalty if you set the SetLineInfo flag.

行情報は、XML ドキュメントを読み込んだ直後に正確になります。The line information is accurate immediately after loading the XML document. ドキュメントの読み込み後に XML ツリーを変更すると、行情報が無意味になることがあります。If you modify the XML tree after loading the document, the line information may become meaningless.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

こちらもご覧ください

Load(XmlReader, LoadOptions) Load(XmlReader, LoadOptions) Load(XmlReader, LoadOptions) Load(XmlReader, LoadOptions)

XmlReader から XElement を読み込み、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。Loads an XElement from an XmlReader, optionally preserving white space, setting the base URI, and retaining line information.

public:
 static System::Xml::Linq::XElement ^ Load(System::Xml::XmlReader ^ reader, System::Xml::Linq::LoadOptions options);
public static System.Xml.Linq.XElement Load (System.Xml.XmlReader reader, System.Xml.Linq.LoadOptions options);
static member Load : System.Xml.XmlReader * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XElement
Public Shared Function Load (reader As XmlReader, options As LoadOptions) As XElement

パラメーター

reader
XmlReader XmlReader XmlReader XmlReader

XElement の内容として読み込む XmlReaderA XmlReader that will be read for the content of the XElement.

options
LoadOptions LoadOptions LoadOptions LoadOptions

空白に対する動作、およびベース URI と行情報を読み込むかどうかを指定する LoadOptionsA LoadOptions that specifies white space behavior, and whether to load base URI and line information.

戻り値

指定した XmlReader から読み込まれた XML を格納している XElementAn XElement that contains the XML that was read from the specified XmlReader.

次の例では、XmlReader から読み込まれた行情報を読み込みます。The following example loads the line information that it loads from the XmlReader. 次に、行情報を出力します。It then prints the line information.

string markup =  
@"<Root>  
    <Child>  
        <GrandChild/>  
    </Child>  
</Root>";  
  
// Create a reader and move to the content.  
using (XmlReader nodeReader = XmlReader.Create(new StringReader(markup)))  
{  
    // the reader must be in the Interactive state in order to  
    // Create a LINQ to XML tree from it.  
    nodeReader.MoveToContent();  
  
    XElement xRoot = XElement.Load(nodeReader, LoadOptions.SetLineInfo);  
    Console.WriteLine("{0}{1}{2}",  
        "Element Name".PadRight(20),  
        "Line".PadRight(5),  
        "Position");  
    Console.WriteLine("{0}{1}{2}",  
        "------------".PadRight(20),  
        "----".PadRight(5),  
        "--------");  
    foreach (XElement e in xRoot.DescendantsAndSelf())  
        Console.WriteLine("{0}{1}{2}",  
            ("".PadRight(e.Ancestors().Count() * 2) + e.Name).PadRight(20),  
            ((IXmlLineInfo)e).LineNumber.ToString().PadRight(5),  
            ((IXmlLineInfo)e).LinePosition);  
}  
Dim markup As String = _  
    "<Root>" & Environment.NewLine & _  
    "    <Child>" & Environment.NewLine & _  
    "        <GrandChild/>" & Environment.NewLine & _  
    "    </Child>" & Environment.NewLine & _  
    "</Root>"  
  
' Create a reader and move to the content.  
Using nodeReader As XmlReader = XmlReader.Create(New StringReader(markup))  
  
    ' the reader must be in the Interactive state in order to  
    ' Create a LINQ to XML tree from it.  
    nodeReader.MoveToContent()  
  
    Dim xRoot As XElement = XElement.Load(nodeReader, LoadOptions.SetLineInfo)  
    Console.WriteLine("{0}{1}{2}", _  
        "Element Name".PadRight(20), _  
        "Line".PadRight(5), _  
        "Position")  
    Console.WriteLine("{0}{1}{2}", _  
        "------------".PadRight(20), _  
        "----".PadRight(5), _  
        "--------")  
    For Each e As XElement In xRoot.DescendantsAndSelf()  
        Console.WriteLine("{0}{1}{2}", _  
            ("".PadRight(e.Ancestors().Count() * 2) & e.Name.ToString).PadRight(20), _  
            (DirectCast(e, IXmlLineInfo)).LineNumber.ToString().PadRight(5), _  
            (DirectCast(e, IXmlLineInfo)).LinePosition)  
    Next  
End Using  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Element Name        Line Position  
------------        ---- --------  
Root                1    2  
  Child             2    6  
    GrandChild      3    10  

注釈

DOM ドキュメントから XmlNodeReader を作成し、XmlNodeReader を使用して XElement を作成することにより、このメソッドを使用して、LINQ to XML ツリーに DOM ドキュメントのコピーを作成できます。By creating an XmlNodeReader from a DOM document, and then using the XmlNodeReader to create an XElement, this method can be used to create a copy of a DOM document in a LINQ to XML tree.

@No__t-0 を使用して、XML を含む文字列から XElement を作成します。Use Parse to create an XElement from a string that contains XML.

@No__t-0 は、@no__t からの読み込み時には無効です。Setting PreserveWhitespace is not valid when loading from a XmlReader. @No__t-0 は、空白文字を読み取るかどうかを構成します。The XmlReader will be configured to either read whitespace or not. LINQ to XML ツリーには、リーダーが表示する空白ノードが設定されます。The LINQ to XML tree will be populated with the whitespace nodes that the reader surfaces. これは PreserveWhitespace が設定されているかどうかに関係なく動作になります。This will be the behavior regardless of whether PreserveWhitespace is set or not.

@No__t-0 は有効なベース URI を持つことができます。The XmlReader may have a valid base URI or not. @No__t-0 に設定すると、ベース uri は、XmlReader によって報告されるベース URI から XML ツリーで設定されます。If you set SetBaseUri, the base URI will be set in the XML tree from the base URI that is reported by the XmlReader.

@No__t-0 には有効な行情報が含まれている可能性があります。The XmlReader may have a valid line information or not. @No__t-0 に設定すると、行情報は、XmlReader によって報告された行情報から XML ツリーで設定されます。If you set SetLineInfo, the line information will be set in the XML tree from the line information that is reported by the XmlReader.

@No__t-0 フラグを設定すると、パフォーマンスが低下します。There is a performance penalty if you set the SetLineInfo flag.

行情報は、XML ドキュメントを読み込んだ直後に正確になります。The line information is accurate immediately after loading the XML document. ドキュメントの読み込み後に XML ツリーを変更すると、行情報が無意味になることがあります。If you modify the XML tree after loading the document, the line information may become meaningless.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

こちらもご覧ください

Load(String, LoadOptions) Load(String, LoadOptions) Load(String, LoadOptions) Load(String, LoadOptions)

ファイルから XElement を読み込み、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。Loads an XElement from a file, optionally preserving white space, setting the base URI, and retaining line information.

public:
 static System::Xml::Linq::XElement ^ Load(System::String ^ uri, System::Xml::Linq::LoadOptions options);
public static System.Xml.Linq.XElement Load (string uri, System.Xml.Linq.LoadOptions options);
static member Load : string * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XElement
Public Shared Function Load (uri As String, options As LoadOptions) As XElement

パラメーター

uri
String String String String

XElement に読み込むファイルを参照している URI 文字列。A URI string referencing the file to load into an XElement.

options
LoadOptions LoadOptions LoadOptions LoadOptions

空白に対する動作、およびベース URI と行情報を読み込むかどうかを指定する LoadOptionsA LoadOptions that specifies white space behavior, and whether to load base URI and line information.

戻り値

指定したファイルの内容を格納している XElementAn XElement that contains the contents of the specified file.

次の例では、2つの異なる方法でファイルから XElement を読み込みます。空白を維持し、空白は保持しません。The following example loads an XElement from a file in two different ways: preserving white space, and not preserving white space. 次に、クエリを使用して、結果の XML ツリー内の空白ノードの数を決定します。It then uses a query to determine the number of white space nodes in the resulting XML tree.

XElement xmlTree1 = XElement.Parse("<Root> <Child>  </Child> </Root>", LoadOptions.PreserveWhitespace);  
xmlTree1.Save("Tree.xml");  
Console.WriteLine(xmlTree1);  
  
int whiteSpaceNodes;  
XElement xmlTree2 = XElement.Load("Tree.xml",  
    LoadOptions.None);  
whiteSpaceNodes = xmlTree2  
    .DescendantNodesAndSelf()  
    .OfType<XText>()  
    .Where(tNode => tNode.ToString().Trim().Length == 0)  
    .Count();  
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes);  
  
XElement xmlTree3 = XElement.Load("Tree.xml",  
    LoadOptions.PreserveWhitespace);  
whiteSpaceNodes = xmlTree3  
    .DescendantNodesAndSelf()  
    .OfType<XText>()  
    .Where(tNode => tNode.ToString().Trim().Length == 0)  
    .Count();  
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes);  
Dim xmlTree1 As XElement = XElement.Parse("<Root> <Child>  </Child> </Root>", LoadOptions.PreserveWhitespace)  
xmlTree1.Save("Tree.xml")  
Console.WriteLine(xmlTree1)  
  
Dim whiteSpaceNodes As Integer  
Dim xmlTree2 As XElement = XElement.Load("Tree.xml", LoadOptions.None)  
whiteSpaceNodes = xmlTree2 _  
                  .DescendantNodesAndSelf() _  
                  .OfType(Of XText)() _  
                  .Where(Function(ByVal tNode As XNode) tNode.ToString().Trim().Length = 0) _  
                  .Count()  
Console.WriteLine("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes)  
  
Dim xmlTree3 As XElement = XElement.Load("Tree.xml", LoadOptions.PreserveWhitespace)  
whiteSpaceNodes = xmlTree3 _  
                  .DescendantNodesAndSelf() _  
                  .OfType(Of XText)() _  
                  .Where(Function(ByVal tNode As XNode) tNode.ToString().Trim().Length = 0) _  
                  .Count()  
Console.WriteLine("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

<Root> <Child>  </Child> </Root>  
Count of white space nodes (not preserving whitespace): 0  
Count of white space nodes (preserving whitespace): 3  

次の例では、ファイルを読み込むときにベース URI と行情報を読み込みます。The following example loads the base URI and line information as it loads the file. 次に、ベース URI と行情報を出力します。It then prints the base URI and the line information.

この例では、次のリソースファイルを使用します。「サンプル XML ファイル:一般的な購買発注書 (LINQ to XML) を使用します。This example uses the following resource file: Sample XML File: Typical Purchase Order (LINQ to XML).

XElement po = XElement.Load("PurchaseOrder.xml",  
    LoadOptions.SetBaseUri | LoadOptions.SetLineInfo);  
string[] splitUri = po.BaseUri.Split('/');  
Console.WriteLine("BaseUri: {0}", splitUri[splitUri.Length - 1]);  
Console.WriteLine();  
Console.WriteLine("{0}{1}{2}",  
    "Element Name".PadRight(20),  
    "Line".PadRight(5),  
    "Position");  
Console.WriteLine("{0}{1}{2}",  
    "------------".PadRight(20),  
    "----".PadRight(5),  
    "--------");  
foreach (XElement e in po.DescendantsAndSelf())  
    Console.WriteLine("{0}{1}{2}",  
        ("".PadRight(e.Ancestors().Count() * 2) + e.Name).PadRight(20),  
        ((IXmlLineInfo)e).LineNumber.ToString().PadRight(5),  
        ((IXmlLineInfo)e).LinePosition);  
Dim po As XElement = XElement.Load("PurchaseOrder.xml", LoadOptions.SetBaseUri Or LoadOptions.SetLineInfo)  
Dim splitUri() As String = po.BaseUri.Split("/")  
Console.WriteLine("BaseUri: {0}", splitUri(splitUri.Length - 1))  
Console.WriteLine()  
Console.WriteLine("{0}{1}{2}", _  
    "Element Name".PadRight(20), _  
    "Line".PadRight(5), _  
    "Position")  
Console.WriteLine("{0}{1}{2}", _  
    "------------".PadRight(20), _  
    "----".PadRight(5), _  
    "--------")  
For Each e As XElement In po.DescendantsAndSelf()  
    Console.WriteLine("{0}{1}{2}", _  
        ("".PadRight(e.Ancestors().Count() * 2) & e.Name.ToString()).PadRight(20), _  
        (DirectCast(e, IXmlLineInfo)).LineNumber.ToString().PadRight(5), _  
        (DirectCast(e, IXmlLineInfo)).LinePosition)  
Next  

この例を実行すると、次の出力が生成されます。This example produces the following output:

BaseUri: PurchaseOrder.xml  
  
Element Name        Line Position  
------------        ---- --------  
PurchaseOrder       2    2  
  Address           3    4  
    Name            4    6  
    Street          5    6  
    City            6    6  
    State           7    6  
    Zip             8    6  
    Country         9    6  
  Address           11   4  
    Name            12   6  
    Street          13   6  
    City            14   6  
    State           15   6  
    Zip             16   6  
    Country         17   6  
  DeliveryNotes     19   4  
  Items             20   4  
    Item            21   6  
      ProductName   22   8  
      Quantity      23   8  
      USPrice       24   8  
      Comment       25   8  
    Item            27   6  
      ProductName   28   8  
      Quantity      29   8  
      USPrice       30   8  
      ShipDate      31   8  

注釈

ソース XML がインデントされている場合は、optionsPreserveWhitespace フラグを設定すると、リーダーはソース XML 内のすべての空白文字を読み取ります。If the source XML is indented, setting the PreserveWhitespace flag in options causes the reader to read all white space in the source XML. @No__t-0 型のノードは、有意な空白と意味のない空白の両方に対して作成されます。Nodes of type XText are created for both significant and insignificant white space.

ソース XML がインデントされている場合、optionsPreserveWhitespace フラグを設定しないと、リーダーはソース XML 内のすべての意味のない空白を無視します。If the source XML is indented, not setting the PreserveWhitespace flag in options causes the reader to ignore all of the insignificant white space in the source XML. XML ツリーは、意味のない空白のテキストノードなしで作成されます。The XML tree is created without any text nodes for insignificant white space.

ソース XML がインデントされていない場合は、optionsPreserveWhitespace フラグを設定しても効果はありません。If the source XML is not indented, setting the PreserveWhitespace flag in options has no effect. 有意の空白は保持されていますが、余分な空白文字の数が増えても、余分な空白のテキストノードが作成される可能性があります。Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes.

詳細については、「 XML の読み込み時または解析時の空白の保持」と「シリアル化時の空白の維持」を参照してください。For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

@No__t-0 を使用して、XML を含む文字列から XElement を作成します。Use Parse to create an XElement from a string that contains XML.

@No__t-0 および SetLineInfo フラグを設定すると、パフォーマンスが低下します。There is a performance penalty if you set the SetBaseUri and the SetLineInfo flags.

ベース URI と行情報は、XML ドキュメントを読み込んだ直後に正確になります。The base URI and the line information are accurate immediately after loading the XML document. ドキュメントの読み込み後に XML ツリーを変更すると、ベース URI と行情報が無意味になることがあります。If you modify the XML tree after loading the document, the base URI and line information may become meaningless.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

こちらもご覧ください

Load(Stream, LoadOptions) Load(Stream, LoadOptions) Load(Stream, LoadOptions)

指定されたストリームを使用して新しい XElement インスタンスを作成し、必要に応じて、空白の維持、ベース URI の設定、および行情報の保持を行います。Creates a new XElement instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

public:
 static System::Xml::Linq::XElement ^ Load(System::IO::Stream ^ stream, System::Xml::Linq::LoadOptions options);
public static System.Xml.Linq.XElement Load (System.IO.Stream stream, System.Xml.Linq.LoadOptions options);
static member Load : System.IO.Stream * System.Xml.Linq.LoadOptions -> System.Xml.Linq.XElement

パラメーター

stream
Stream Stream Stream Stream

XML データが含まれるストリーム。The stream containing the XML data.

options
LoadOptions LoadOptions LoadOptions LoadOptions

ベース URI と行情報を読み込むかどうかを指定する LoadOptions オブジェクト。A LoadOptions object that specifies whether to load base URI and line information.

戻り値

ストリームに格納されたデータを読み取るために使用する XElement オブジェクト。An XElement object used to read the data that the stream contains.

注釈

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

@No__t-0 を変更する必要がある場合は、次の手順を実行します。If you have to modify XmlReaderSettings, following these steps:

  1. パラメーターとして XmlReaderSettings を受け取る Create オーバーロードのいずれかを呼び出すことによって、@no__t 0 を作成します。Create an XmlReader by calling one of the Create overloads that take XmlReaderSettings as a parameter.

  2. @No__t-0 を、パラメーターとして XmlReader を受け取る XElementLoad オーバーロードのいずれかに渡します。Pass the XmlReader to one of the XElement's Load overloads that takes XmlReader as a parameter.

Load(TextReader) Load(TextReader) Load(TextReader)

TextReader から XElement を読み込みます。Loads an XElement from a TextReader.

public:
 static System::Xml::Linq::XElement ^ Load(System::IO::TextReader ^ textReader);
public static System.Xml.Linq.XElement Load (System.IO.TextReader textReader);
static member Load : System.IO.TextReader -> System.Xml.Linq.XElement

パラメーター

textReader
TextReader TextReader TextReader TextReader

XElement の内容として読み込む TextReaderA TextReader that will be read for the XElement content.

戻り値

指定した TextReader から読み込まれた XML を格納している XElementAn XElement that contains the XML that was read from the specified TextReader.

次の例では、StringReader から要素を読み込みます。The following example loads an element from a StringReader.

TextReader sr = new StringReader("<Root><Child/></Root>");  
XElement xmlTree = XElement.Load(sr);  
sr.Close();  
Console.WriteLine(xmlTree);  
Dim sr As TextReader = New StringReader("<Root><Child/></Root>")  
Dim xmlTree As XElement = XElement.Load(sr)  
sr.Close()  
Console.WriteLine(xmlTree)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

<Root>  
  <Child />  
</Root>  

注釈

このメソッドは、未加工の XML を XML ツリーに読み取ります。This method reads the raw XML into the XML tree. ファイル内のすべての意味のない空白を破棄します。It discards all insignificant white space in the file.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

こちらもご覧ください

Load(String) Load(String) Load(String) Load(String)

ファイルから XElement を読み込みます。Loads an XElement from a file.

public:
 static System::Xml::Linq::XElement ^ Load(System::String ^ uri);
public static System.Xml.Linq.XElement Load (string uri);
static member Load : string -> System.Xml.Linq.XElement
Public Shared Function Load (uri As String) As XElement

パラメーター

uri
String String String String

新しい XElement に読み込むファイルを参照している URI 文字列。A URI string referencing the file to load into a new XElement.

戻り値

指定したファイルの内容を格納している XElementAn XElement that contains the contents of the specified file.

次の例では、XML ツリーを作成し、ファイルに保存した後、このメソッドを使用して、ファイルから XElement を読み込みます。The following example creates an XML tree, saves it to a file, and then uses this method to load the XElement from the file.

XElement xmlTree1 = new XElement("Root",  
    new XElement("Child", "content")  
);  
xmlTree1.Save("Tree.xml");  
  
XElement xmlTree2 = XElement.Load("Tree.xml");  
Console.WriteLine(xmlTree2.Name);  
Dim xmlTree1 As XElement = _   
        <Root>  
            <Child>Content</Child>  
        </Root>  
xmlTree1.Save("Tree.xml")  
  
Dim xmlTree2 As XElement = XElement.Load("Tree.xml")  
Console.WriteLine(xmlTree2.Name)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Root  

注釈

このメソッドは、未加工の XML を XML ツリーに読み取ります。This method reads the raw XML into the XML tree. ファイル内のすべての意味のない空白を破棄します。It discards all insignificant white space in the file.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

こちらもご覧ください

Load(Stream) Load(Stream) Load(Stream)

指定されたストリームを使用して新しい XElement インスタンスを作成します。Creates a new XElement instance by using the specified stream.

public:
 static System::Xml::Linq::XElement ^ Load(System::IO::Stream ^ stream);
public static System.Xml.Linq.XElement Load (System.IO.Stream stream);
static member Load : System.IO.Stream -> System.Xml.Linq.XElement

パラメーター

stream
Stream Stream Stream Stream

XML データを格納しているストリーム。The stream that contains the XML data.

戻り値

ストリームに格納されているデータを読み取るために使用する XElement オブジェクト。An XElement object used to read the data that is contained in the stream.

注釈

読み込みオプションを制御する場合は、パラメーターとして LoadOptions を受け取る Load のオーバーロードを使用します。If you want to control load options, use the Load overload that takes LoadOptions as a parameter.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

@No__t-0 を変更する必要がある場合は、次の手順を実行します。If you have to modify XmlReaderSettings, following these steps:

  1. パラメーターとして XmlReaderSettings を受け取る Create オーバーロードのいずれかを呼び出すことによって、@no__t 0 を作成します。Create an XmlReader by calling one of the Create overloads that take XmlReaderSettings as a parameter.

  2. @No__t-0 を、パラメーターとして XmlReader を受け取る XElementLoad オーバーロードのいずれかに渡します。Pass the XmlReader to one of the XElement's Load overloads that takes XmlReader as a parameter.

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

XmlReader から XElement を読み込みます。Loads an XElement from an XmlReader.

public:
 static System::Xml::Linq::XElement ^ Load(System::Xml::XmlReader ^ reader);
public static System.Xml.Linq.XElement Load (System.Xml.XmlReader reader);
static member Load : System.Xml.XmlReader -> System.Xml.Linq.XElement
Public Shared Function Load (reader As XmlReader) As XElement

パラメーター

reader
XmlReader XmlReader XmlReader XmlReader

XElement の内容として読み込む XmlReaderA XmlReader that will be read for the content of the XElement.

戻り値

指定した XmlReader から読み込まれた XML を格納している XElementAn XElement that contains the XML that was read from the specified XmlReader.

次の例では、DOM ドキュメントを作成し、DOM ドキュメントから @no__t 0 を作成して、リーダーからツリーをインスタンス化します。The following example creates a DOM document, creates an XmlNodeReader from the DOM document, instantiates a tree from the reader. このコードは、効率的に DOM ドキュメントを LINQ to XML ツリーにコピーします。This code effectively copies a DOM document into a LINQ to XML tree.

// Create a DOM document with some content.  
XmlDocument doc = new XmlDocument();  
XmlElement child = doc.CreateElement("Child");  
child.InnerText = "child contents";  
XmlElement root = doc.CreateElement("Root");  
root.AppendChild(child);  
doc.AppendChild(root);  
  
// Create a reader and move to the content.  
using (XmlNodeReader nodeReader = new XmlNodeReader(doc)) {  
    // the reader must be in the Interactive state in order to  
    // Create a LINQ to XML tree from it.  
    nodeReader.MoveToContent();  
  
    XElement xRoot = XElement.Load(nodeReader);  
    Console.WriteLine(xRoot);  
}  
' Create a DOM document with some content.  
Dim doc As XmlDocument = New XmlDocument()  
Dim child As XmlElement = doc.CreateElement("Child")  
child.InnerText = "child contents"  
Dim root As XmlElement = doc.CreateElement("Root")  
root.AppendChild(child)  
doc.AppendChild(root)  
  
' Create a reader and move to the content.  
Using nodeReader = New XmlNodeReader(doc)  
    ' the reader must be in the Interactive state in order to  
    ' Create a LINQ to XML tree from it.  
    nodeReader.MoveToContent()  
  
    Dim xRoot As XElement = XElement.Load(nodeReader)  
    Console.WriteLine(xRoot)  
End Using  

この例を実行すると、次の出力が生成されます。This example produces the following output:

<Root>  
  <Child>child contents</Child>  
</Root>  

注釈

DOM ドキュメントから XmlNodeReader を作成し、XmlNodeReader を使用して XElement を作成することにより、このメソッドを使用して、LINQ to XML ツリーに DOM ドキュメントのコピーを作成できます。By creating an XmlNodeReader from a DOM document, and then using the XmlNodeReader to create an XElement, this method can be used to create a copy of a DOM document in a LINQ to XML tree.

LINQ to XML の読み込み機能は XmlReader に基づいて構築されています。LINQ to XML's loading functionality is built upon XmlReader. したがって、@no__t 0 のオーバーロードメソッドによってスローされた例外と、ドキュメントを読み取って解析する XmlReader メソッドをキャッチすることができます。Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.

こちらもご覧ください

適用対象