Aracılığıyla paylaş

XElement.Load Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml.Linq
Bütünleştirilmiş Kod:
System.Xml.XDocument.dll
Bütünleştirilmiş Kod:
System.Xml.Linq.dll
Bütünleştirilmiş Kod:
netstandard.dll

URI tarafından belirtilen bir dosyadan, bir TextReaderveya dosyasından yeni XElement bir XmlReaderoluşturur.

Aşırı Yüklemeler

Load(TextReader, LoadOptions)

bir içinden TextReaderbir XElement yükler, isteğe bağlı olarak boşluğu korur ve satır bilgilerini korur.
Load(XmlReader, LoadOptions)

bir 'den XmlReaderyüklerXElement, isteğe bağlı olarak boşluğu korur, temel URI'yi ayarlar ve satır bilgilerini korur.
Load(String, LoadOptions)

İsteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak dosyadan bir XElement yükler.
Load(Stream, LoadOptions)

Belirtilen akışı kullanarak, isteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak yeni XElement bir örnek oluşturur.
Load(TextReader)

bir 'den yükler XElement TextReader.
Load(String)

Dosyadan bir XElement yükler.
Load(Stream)

Belirtilen akışı kullanarak yeni XElement bir örnek oluşturur.
Load(XmlReader)

bir 'den bir XElement XmlReaderyükler.

Açıklamalar

Bu yöntemin aşırı yüklemelerinden birini kullanarak bir dosyadan, bir TextReaderveya bir dosyasından XmlReaderyükleyebilirsinizXElement.

XML içeren bir XElement dizeden oluşturmak için kullanın Parse.

Load(TextReader, LoadOptions)

bir içinden TextReaderbir XElement yükler, isteğe bağlı olarak boşluğu korur ve satır bilgilerini korur.

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
Public Shared Function Load (textReader As TextReader, options As LoadOptions) As XElement

Parametreler

textReader
TextReader

TextReader İçerik için okunacak birXElement.

options
LoadOptions

LoadOptions Boşluk davranışını ve temel URI ile satır bilgilerinin yüklenip yüklenmeyeceğini belirten bir.

Döndürülenler

XElement

XElement Belirtilen TextReaderöğesinden okunan XML'i içeren bir .

Örnekler

Aşağıdaki örnek bir dosyasından StringReader iki farklı yolla yüklerXElement: boşluğu koruma ve boşluğu korumama. Ardından, sonuçta elde edilen XML ağacındaki boşluk düğümlerinin sayısını belirlemek için bir sorgu kullanır.

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)

Bu örnek aşağıdaki çıkışı oluşturur:

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

Aşağıdaki örnek, satırından yüklenirken TextReadersatır bilgilerini yükler. Ardından satır bilgilerini yazdırır.

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

Bu örnek aşağıdaki çıkışı oluşturur:

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

Açıklamalar

Kaynak XML girintiliyse, bayrağının PreserveWhitespace içinde options ayarlanması okuyucunun kaynak XML'deki tüm boşlukları okumasına neden olur. Türündeki XText düğümler hem önemli hem de önemsiz boşluklar için oluşturulur.

Kaynak XML girintiliyse, bayrağını PreserveWhitespace options içinde ayarlamamak okuyucunun kaynak XML'deki tüm önemsiz boşlukları yoksaymasına neden olur. XML ağacı, önemsiz boşluk için herhangi bir metin düğümü olmadan oluşturulur.

Kaynak XML girintili değilse, bayrağının içinde options ayarlanmasının PreserveWhitespace hiçbir etkisi olmaz. Önemli boşluklar hala korunur ve daha fazla boşluk metin düğümü oluşturulmasına neden olabilecek önemsiz boşluk aralıkları yoktur.

Daha fazla bilgi için bkz . XML'yi yüklerken veya ayrıştırırken boşluğu koruma ve Serileştirme sırasında boşluğu koruma.

XML içeren bir XElement dizeden oluşturmak için kullanınParse.

Ayarın SetBaseUri bir TextReader'den yüklenirken hiçbir etkisi olmaz.

Bayrağı ayarlarsanız SetLineInfo bir performans cezası uygulanır.

Satır bilgileri, XML belgesi yüklendikten hemen sonra doğrudur. Belgeyi yükledikten sonra XML ağacını değiştirirseniz, satır bilgileri anlamsız hale gelebilir.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Load(XmlReader, LoadOptions)

bir 'den XmlReaderyüklerXElement, isteğe bağlı olarak boşluğu korur, temel URI'yi ayarlar ve satır bilgilerini korur.

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

Parametreler

reader
XmlReader

XmlReader içeriğinin okunacağı bir XElement.

options
LoadOptions

LoadOptions Boşluk davranışını ve temel URI ile satır bilgilerinin yüklenip yüklenmeyeceğini belirten bir.

Döndürülenler

XElement

XElement Belirtilen XmlReaderöğesinden okunan XML'i içeren bir .

Örnekler

Aşağıdaki örnek, içinden XmlReaderyüklemiş olduğu satır bilgilerini yükler. Ardından satır bilgilerini yazdırır.

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

Bu örnek aşağıdaki çıkışı oluşturur:

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

Açıklamalar

Bir DOM belgesinden oluşturup XmlNodeReader oluşturmak için XElementkullanarakXmlNodeReader, bu yöntem LINQ to XML bir ağaçta dom belgesinin kopyasını oluşturmak için kullanılabilir.

XML içeren bir XElement dizeden oluşturmak için kullanınParse.

ayarı PreserveWhitespace bir XmlReader'den yüklenirken geçerli değil. , XmlReader boşluğu okuyacak veya okumayacak şekilde yapılandırılacaktır. LINQ to XML ağacı okuyucunun ortaya çıktığı boşluk düğümleriyle doldurulur. Ayarlanıp ayarlanmadığına PreserveWhitespace bakılmaksızın bu davranış olacaktır.

geçerli XmlReader bir temel URI'ye sahip olabilir veya olmayabilir. ayarlarsanız SetBaseUri, temel URI, tarafından XmlReaderbildirilen temel URI'den XML ağacında ayarlanır.

geçerli XmlReader bir satır bilgisine sahip olabilir veya olmayabilir. ayarlarsanız SetLineInfo, satır bilgileri XML ağacında tarafından XmlReaderbildirilen satır bilgilerinden ayarlanır.

Bayrağı ayarlarsanız SetLineInfo bir performans cezası uygulanır.

Satır bilgileri, XML belgesi yüklendikten hemen sonra doğrudur. Belgeyi yükledikten sonra XML ağacını değiştirirseniz, satır bilgileri anlamsız hale gelebilir.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Load(String, LoadOptions)

İsteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak dosyadan bir XElement yükler.

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

Parametreler

uri
String

dosyasına yüklemek için dosyaya başvuran bir XElementURI dizesi.

options
LoadOptions

LoadOptions Boşluk davranışını ve temel URI ile satır bilgilerinin yüklenip yüklenmeyeceğini belirten bir.

Döndürülenler

XElement

XElement Belirtilen dosyanın içeriğini içeren.

Örnekler

Aşağıdaki örnek bir XElement dosyadan iki farklı yolla yükler: boşluğu koruma ve boşluğu korumama. Ardından, sonuçta elde edilen XML ağacındaki boşluk düğümlerinin sayısını belirlemek için bir sorgu kullanır.

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)

Bu örnek aşağıdaki çıkışı oluşturur:

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

Aşağıdaki örnek, dosyayı yüklerken temel URI'yi ve satır bilgilerini yükler. Ardından temel URI'yi ve satır bilgilerini yazdırır.

Bu örnekte şu kaynak dosyası kullanılmaktadır: Örnek XML Dosyası: Tipik Satın Alma Siparişi (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

Bu örnek aşağıdaki çıkışı oluşturur:

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

Açıklamalar

Kaynak XML girintiliyse, bayrağının PreserveWhitespace içinde options ayarlanması okuyucunun kaynak XML'deki tüm boşlukları okumasına neden olur. Türündeki XText düğümler hem önemli hem de önemsiz boşluklar için oluşturulur.

Kaynak XML girintiliyse, bayrağını PreserveWhitespace options içinde ayarlamamak okuyucunun kaynak XML'deki tüm önemsiz boşlukları yoksaymasına neden olur. XML ağacı, önemsiz boşluk için herhangi bir metin düğümü olmadan oluşturulur.

Kaynak XML girintili değilse, bayrağının içinde options ayarlanmasının PreserveWhitespace hiçbir etkisi olmaz. Önemli boşluklar hala korunur ve daha fazla boşluk metin düğümü oluşturulmasına neden olabilecek önemsiz boşluk aralıkları yoktur.

Daha fazla bilgi için bkz . XML'yi yüklerken veya ayrıştırırken boşluğu koruma ve Serileştirme sırasında boşluğu koruma.

XML içeren bir XElement dizeden oluşturmak için kullanınParse.

ve SetLineInfo bayraklarını ayarlarsanız SetBaseUri bir performans cezası uygulanır.

Temel URI ve satır bilgileri, XML belgesi yüklendikten hemen sonra doğru şekildedir. Belgeyi yükledikten sonra XML ağacını değiştirirseniz, temel URI ve satır bilgileri anlamsız hale gelebilir.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Load(Stream, LoadOptions)

Belirtilen akışı kullanarak, isteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak yeni XElement bir örnek oluşturur.

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
Public Shared Function Load (stream As Stream, options As LoadOptions) As XElement

Parametreler

stream
Stream

XML verilerini içeren akış.

options
LoadOptions

LoadOptions Temel URI'nin ve satır bilgilerinin yüklenip yüklenmeyeceğini belirten bir nesne.

Döndürülenler

XElement

XElement Akışın içerdiği verileri okumak için kullanılan nesne.

Açıklamalar

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

değiştirmeniz XmlReaderSettingsgerekiyorsa, aşağıdaki adımları izleyin:

  1. XmlReader Parametre olarak alan XmlReaderSettings aşırı yüklemelerden birini Create çağırarak bir oluşturun.

  2. XmlReader parametresi olarak alan XmlReader 'nin Load aşırı yüklemelerinden birine XElementgeçirin.

Şunlara uygulanır

Load(TextReader)

bir 'den yükler XElement 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
Public Shared Function Load (textReader As TextReader) As XElement

Parametreler

textReader
TextReader

TextReader İçerik için okunacak birXElement.

Döndürülenler

XElement

XElement Belirtilen TextReaderöğesinden okunan XML'i içeren bir .

Örnekler

Aşağıdaki örnek öğesinden bir StringReaderöğesini yükler.

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)

Bu örnek aşağıdaki çıkışı oluşturur:

<Root>  
  <Child />  
</Root>

Açıklamalar

Bu yöntem ham XML'yi XML ağacına okur. Dosyadaki tüm önemsiz boşlukları atar.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Load(String)

Dosyadan bir XElement yükler.

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

Parametreler

uri
String

Yeni XElementbir içine yüklemek için dosyaya başvuran bir URI dizesi.

Döndürülenler

XElement

XElement Belirtilen dosyanın içeriğini içeren.

Örnekler

Aşağıdaki örnek bir XML ağacı oluşturur, bunu bir dosyaya kaydeder ve ardından dosyasından XElement yüklemek için bu yöntemi kullanır.

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)

Bu örnek aşağıdaki çıkışı oluşturur:

Root

Açıklamalar

Bu yöntem ham XML'yi XML ağacına okur. Dosyadaki tüm önemsiz boşlukları atar.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

Load(Stream)

Belirtilen akışı kullanarak yeni XElement bir örnek oluşturur.

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
Public Shared Function Load (stream As Stream) As XElement

Parametreler

stream
Stream

XML verilerini içeren akış.

Döndürülenler

XElement

XElement Akışta yer alan verileri okumak için kullanılan nesne.

Açıklamalar

Yükleme seçeneklerini denetlemek istiyorsanız, parametre olarak alan LoadOptions aşırı yüklemeyi kullanınLoad.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

değiştirmeniz XmlReaderSettingsgerekiyorsa, aşağıdaki adımları izleyin:

  1. XmlReader Parametre olarak alan XmlReaderSettings aşırı yüklemelerden birini Create çağırarak bir oluşturun.

  2. XmlReader parametresi olarak alan XmlReader 'nin Load aşırı yüklemelerinden birine XElementgeçirin.

Şunlara uygulanır

Load(XmlReader)

bir 'den bir XElement XmlReaderyükler.

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

Parametreler

reader
XmlReader

XmlReader içeriğinin okunacağı bir XElement.

Döndürülenler

XElement

XElement Belirtilen XmlReaderöğesinden okunan XML'i içeren bir .

Örnekler

Aşağıdaki örnek bir DOM belgesi oluşturur, DOM belgesinden bir XmlNodeReader oluşturur, okuyucudan bir ağaç örneği oluşturur. Bu kod bir DOM belgesini bir LINQ to XML ağacına etkili bir şekilde kopyalar.

// 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

Bu örnek aşağıdaki çıkışı oluşturur:

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

Açıklamalar

Bir DOM belgesinden oluşturup XmlNodeReader oluşturmak için XElementkullanarakXmlNodeReader, bu yöntem LINQ to XML bir ağaçta dom belgesinin kopyasını oluşturmak için kullanılabilir.

LINQ to XML yükleme işlevi üzerine XmlReaderkurulmuştur. Bu nedenle, aşırı yükleme yöntemleri ve XmlReader belgeyi XmlReader.Create okuyup ayrıştıran yöntemler tarafından oluşan özel durumları yakalayabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır