XmlDataDocument.Load Yöntem

public:
 override void Load(System::IO::Stream ^ inStream);

public override void Load (System.IO.Stream inStream);

override this.Load : System.IO.Stream -> unit

Public Overrides Sub Load (inStream As Stream)

Parametreler

Açıklamalar

XmlDataDocument varlık başvuruları oluşturmayı desteklemez. Veriler varlık başvuruları içeriyorsa, Load yöntemi tüm varlık başvurularını çözümler ve genişletir.

public:
 override void Load(System::IO::TextReader ^ txtReader);

public override void Load (System.IO.TextReader txtReader);

override this.Load : System.IO.TextReader -> unit

Public Overrides Sub Load (txtReader As TextReader)

Parametreler

Açıklamalar

XmlDataDocument varlık başvuruları oluşturmayı desteklemez. Veriler varlık başvuruları içeriyorsa, Load yöntemi tüm varlık başvurularını çözümler ve genişletir.

public:
 override void Load(System::String ^ filename);

public override void Load (string filename);

override this.Load : string -> unit

Public Overrides Sub Load (filename As String)

Parametreler

Açıklamalar

XmlDataDocument varlık başvuruları oluşturmayı desteklemez. Veriler varlık başvuruları içeriyorsa, Load yöntemi tüm varlık başvurularını çözümler ve genişletir.

public:
 override void Load(System::Xml::XmlReader ^ reader);

public override void Load (System.Xml.XmlReader reader);

override this.Load : System.Xml.XmlReader -> unit

Public Overrides Sub Load (reader As XmlReader)

Parametreler

Özel durumlar

Örnekler

Aşağıdaki örnek, yöntemleri kullanarak DataSet bir kitabın fiyatını değiştirir.

#using <System.dll>
#using <System.Data.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Data;
using namespace System::Xml;
int main()
{
   // Create an XmlDataDocument.
   XmlDataDocument^ doc = gcnew XmlDataDocument;

   // Load the schema file.
   doc->DataSet->ReadXmlSchema( "store.xsd" );

   // Load the XML data.
   XmlTextReader^ reader = gcnew XmlTextReader( "2books.xml" );
   reader->MoveToContent(); // Moves the reader to the root node.
   doc->Load( reader );

   // Update the price on the first book using the DataSet methods.
   DataTable^ books = doc->DataSet->Tables["book"];
   books->Rows[0]["price"] = "12.95";
   Console::WriteLine( "Display the modified XML data..." );
   doc->Save( Console::Out );
}

using System;
using System.Data;
using System.Xml;
public class Sample {
    public static void Main() {
        // Create an XmlDataDocument.
        XmlDataDocument doc = new XmlDataDocument();

        // Load the schema file.
        doc.DataSet.ReadXmlSchema("store.xsd");

        // Load the XML data.
        XmlTextReader reader = new XmlTextReader("2books.xml");
        reader.MoveToContent(); // Moves the reader to the root node.
        doc.Load(reader);

        // Update the price on the first book using the DataSet methods.
        DataTable books = doc.DataSet.Tables["book"];
        books.Rows[0]["price"] = "12.95";

        Console.WriteLine("Display the modified XML data...");
        doc.Save(Console.Out);
    }
} // End class

Imports System.Data
Imports System.Xml

public class Sample

  public shared sub Main()

      'Create an XmlDataDocument.
      Dim doc as XmlDataDocument = new XmlDataDocument()

      'Load the schema.
      doc.DataSet.ReadXmlSchema("store.xsd") 
 
      'Load the XML data.
      Dim reader as XmlTextReader = new XmlTextReader("2books.xml")
      reader.MoveToContent() 'Moves the reader to the root node.
      doc.Load(reader)
        
     'Change the price on the first book imports the DataSet methods.
     Dim books as DataTable = doc.DataSet.Tables.Item("book")
     books.Rows.Item(0).Item("price") = "12.95"
        
     Console.WriteLine("Display the modified XML data...")
     doc.Save(Console.Out)

  end sub
end class

Örnekte aşağıdaki iki giriş dosyası kullanılır.

2books.xml

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

store.xsd

<xsd:schema xmlns:xsd="http://www.w3.org/2000/10/XMLSchema">

 <xsd:element name="bookstore" type="bookstoreType"/>

 <xsd:complexType name="bookstoreType">
  <xsd:sequence maxOccurs="unbounded">
   <xsd:element name="book"  type="bookType"/>
  </xsd:sequence>
 </xsd:complexType>

 <xsd:complexType name="bookType">
  <xsd:sequence>
   <xsd:element name="title" type="xsd:string"/>
   <xsd:element name="author" type="authorName"/>
   <xsd:element name="price"  type="xsd:decimal"/>
  </xsd:sequence>
  <xsd:attribute name="genre" type="xsd:string"/>
 </xsd:complexType>

 <xsd:complexType name="authorName">
  <xsd:sequence>
   <xsd:element name="first-name"  type="xsd:string"/>
   <xsd:element name="last-name" type="xsd:string"/>
  </xsd:sequence>
 </xsd:complexType>

</xsd:schema>

Açıklamalar

XmlDataDocument varlık başvuruları oluşturmayı desteklemez. Veri kaynağı varlık başvuruları içeriyorsa, özelliği EntityHandling.ExpandEntities olarak ayarlanmış bir XmlValidatingReader EntityHandling oluşturmanız (varsayılan davranış budur) ve yöntemine Load geçirmeniz XmlValidatingReader gerekir. kullanmazsanızXmlValidatingReader``Load, yöntemi bir özel durum oluşturur.

Load yöntemi her zaman önemli boşluklar korur. PreserveWhitespace özelliği, boşluğun korunup korunmayacağını belirler. Varsayılan değer olan false, boşluk korunmaz.

Okuyucu ilk durumdaysa (ReadState=ReadState.Initial), Load okuyucunun tüm içeriğini kullanır ve DOM'u 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 end etiketine yükler. Bu, aşağıdaki sonuçlara sahiptir.

Geçerli düğüm ve aşağıdaki eşdüzeyleri aşağıdakine benzerse:

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

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

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

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

Okuyucu, belgenin kök düzeyi (örneğin, bir boşluk veya öznitelik düğümü) için geçersiz olan bir yaprak düğüme 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.