XmlDocument.Load Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Belirtilen XML verilerini bir Stream, URL, TextReaderveya XmlReaderöğesinden yükler.

Aşırı Yüklemeler

Load(Stream)	Belirtilen akıştan XML belgesini yükler.
Load(TextReader)	Belirtilen TextReaderöğesinden XML belgesini yükler.
Load(String)	Belirtilen URL'den XML belgesini yükler.
Load(XmlReader)	Belirtilen XmlReaderöğesinden XML belgesini yükler.

Load(Stream)

Source:

XmlDocument.cs

Belirtilen akıştan XML belgesini yükler.

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)

Parametreler

inStream

Stream

Yüklenemiyor XML belgesini içeren akış.

Özel durumlar

XmlException

XML'de bir yükleme veya ayrıştırma hatası var. Bu durumda, bir FileNotFoundException oluşturulur.

Açıklamalar

Not

Load yöntemi her zaman önemli boşluklar korur. PreserveWhitespace özelliği, öğe içeriğindeki boşluk olan önemsiz boşluğun korunup korunmayacağını belirler. Varsayılan değerdir false; öğe içeriğindeki boşluk korunmaz.

Doğrulamanın gerçekleşmesini istiyorsanız, sınıfını XmlReaderSettings ve Create yöntemini kullanarak bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Bu yöntem, giriş XML'sinin dize biçimini otomatik olarak algılar (örneğin, UTF-8, ANSI vb.). Uygulamanızın akışı okumak için hangi kodlamanın kullanıldığını bilmesi gerekiyorsa, akışı okumak için bir XmlTextReader nesne kullanmayı ve ardından kodlamayı XmlTextReader.Encoding belirlemek için özelliğini kullanmayı göz önünde bulundurun. XML ile çalışmak için bir XmlDocument nesne kullanmanız gerekiyorsa, oluşturmak için nesnesini kullanabilirsiniz XmlTextReader . Daha fazla bilgi için bkz. XPathDocument ve XmlDocument kullanarak XML Verilerini Okuma.

Ayrıca bkz.

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(TextReader)

Source:

XmlDocument.cs

Belirtilen TextReaderöğesinden XML belgesini yükler.

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)

Parametreler

txtReader

TextReader

TextReader XML verilerini belgeye beslemek için kullanılan.

Özel durumlar

XmlException

XML'de bir yükleme veya ayrıştırma hatası var. Bu durumda, belge boş kalır.

Örnekler

Aşağıdaki örnek, nesnesine StringReader bir XML verisi dizesi yüklemek için sınıfını XmlDocument kullanır.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   String^ xmlData = "<book xmlns:bk='urn:samples'></book>";
   doc->Load( gcnew 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 );
}

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

public class Sample {

  public static void Main() {

    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    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

Açıklamalar

Not

Load yöntemi her zaman önemli boşluklar korur. PreserveWhitespace özelliği, öğe içeriğindeki boşluk olan önemsiz boşluğun korunup korunmayacağını belirler. Varsayılan değerdir false; öğe içeriğindeki boşluk korunmaz.

Doğrulamanın gerçekleşmesini istiyorsanız, sınıfını XmlReaderSettings ve Create yöntemini kullanarak bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Ayrıca bkz.

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(String)

Source:

XmlDocument.cs

Belirtilen URL'den XML belgesini yükler.

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)

Parametreler

filename

String

Yüklenemiyor XML belgesini içeren dosyanın URL'si. URL yerel bir dosya veya HTTP URL'si (Web adresi) olabilir.

Özel durumlar

XmlException

XML'de bir yükleme veya ayrıştırma hatası var. Bu durumda, bir FileNotFoundException oluşturulur.

ArgumentException

filename sıfır uzunluklu bir dizedir, yalnızca boşluk içerir veya tarafından InvalidPathCharstanımlanan bir veya daha fazla geçersiz karakter içerir.

ArgumentNullException

filename, null değeridir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

Dosyayı açarken bir G/Ç hatası oluştu.

UnauthorizedAccessException

filename salt okunur bir dosya belirtti.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

filename bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

FileNotFoundException

içinde filename belirtilen dosya bulunamadı.

NotSupportedException

filename geçersiz biçimde.

SecurityException

Çağıranın gerekli izni yok.

Açıklamalar

Not

Load yöntemi her zaman önemli boşluklar korur. PreserveWhitespace özelliği, öğe içeriğindeki boşluk olan önemsiz boşluğun korunup korunmayacağını belirler. Varsayılan değerdir false; öğe içeriğindeki boşluk korunmaz.

Doğrulamanın gerçekleşmesini istiyorsanız, sınıfını XmlReaderSettings ve Create yöntemini kullanarak bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Ayrıca bkz.

• ValidationEventArgs
• XmlSeverityType
• Schemas

Load(XmlReader)

Source:

XmlDocument.cs

Belirtilen XmlReaderöğesinden XML belgesini yükler.

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)

Parametreler

reader

XmlReader

XmlReader XML verilerini belgeye beslemek için kullanılan.

Özel durumlar

XmlException

XML'de bir yükleme veya ayrıştırma hatası var. Bu durumda, belge boş kalır.

Örnekler

Aşağıdaki örnek dosyanın son kitap düğümünü books.xml XML belgesine yükler.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   
   //Load the document with the last book node.
   XmlTextReader^ reader = gcnew 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 );
}

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

Örnekte giriş olarak dosyası books.xmlkullanılır.

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

Açıklamalar

Not

Load yöntemi her zaman önemli boşluklar korur. PreserveWhitespace özelliği, öğe içeriğindeki boşluk olan önemsiz boşluğun korunup korunmayacağını belirler. Varsayılan değerdir false; öğe içeriğindeki boşluk korunmaz.

Okuyucu ilk durumdaysa (ReadState =ReadState.Initial), Load okuyucunun tüm içeriğini kullanır ve DOM'yi bulduklarından oluşturur.

Okuyucu zaten "n" derinliğindeki bir düğümde konumlandırıldıysa, bu yöntem bu düğümü ve izleyen tüm eşdüzeyleri "n" derinliğini kapatan bitiş etiketine yükler. Bu, aşağıdaki sonuçlara sahiptir.

Geçerli düğüm ve eşdüzeyleri aşağıdaki gibi görünüyorsa:

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

Load bir belgenin iki kök düzeyi öğesi olamayacağından özel durum oluşturur. Geçerli düğüm ve eşdüzeyleri aşağıdaki gibi görünüyorsa:

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

Load başarılı olur, ancak kök düzeyi öğesi olmadığından eksik bir DOM ağacınız var. Belgeyi kaydetmeden önce bir kök düzeyi öğesi eklemeniz gerekir, aksi takdirde Save bir özel durum oluşturur.

Okuyucu, belgenin kök düzeyi için geçersiz olan bir yaprak düğüme (örneğin, boşluk veya öznitelik düğümü) konumlandırıldıysa, okuyucu kök için kullanılabilecek bir düğüme konumlandırılana kadar okumaya devam eder. Belge bu noktada yüklenmeye başlar.

Doğrulamanın gerçekleşmesini istiyorsanız, sınıfını XmlReaderSettings ve Create yöntemini kullanarak bir doğrulama XmlReader örneği oluşturabilirsiniz. Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlReader bakın.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Ayrıca bkz.

• ValidationEventArgs
• XmlSeverityType
• Schemas