XmlDataDocument.Load Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml

Bütünleştirilmiş Kod:: System.Data.Common.dll

Bütünleştirilmiş Kod:: System.Data.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

belirtilen veri kaynağını kullanarak öğesini XmlDataDocument yükler ve yüklenen verilerle eşitler DataSet .

Aşırı Yüklemeler

Load(Stream)	Belirtilen akıştan öğesini `XmlDataDocument` yükler.
Load(TextReader)	belirtilen TextReaderiçinden öğesini `XmlDataDocument` yükler.
Load(String)	Belirtilen URL'yi kullanarak öğesini `XmlDataDocument` yükler.
Load(XmlReader)	belirtilen XmlReaderiçinden öğesini `XmlDataDocument` yükler.

Açıklamalar

Not

XML verilerini ilişkisel olarak görüntülemek için, önce veri eşlemesi için kullanılacak bir şema belirtmeniz gerekir. Bu, yöntemini çağırarak ReadXmlSchema veya içindeki tabloları ve sütunları DataSet el ile oluşturarak yapılabilir. Çağrısı yapılmadan önce Loadbu adım gerçekleştirilmelidir.

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. Ancak, bir bağımsız değişken olarak alan XmlReader aşırı yüklemeyi kullanıyorsanızLoad, varlıkları çözümleyebilecek bir XmlReader belirtmeniz gerekir.

Load(Stream)

Belirtilen akıştan öğesini XmlDataDocument yükler.

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

inStream: Stream

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

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.

Not

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Load(TextReader)

belirtilen TextReaderiçinden öğesini XmlDataDocument yükler.

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

txtReader: TextReader

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

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.

Not

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Load(String)

Belirtilen URL'yi kullanarak öğesini XmlDataDocument yükler.

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

filename: String

Yüklenemiyor XML belgesini içeren dosyanın URL'si.

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.

Not

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Load(XmlReader)

belirtilen XmlReaderiçinden öğesini XmlDataDocument yükler.

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

reader: XmlReader

XmlReader Yüklenemiyor XML belgesini içeren.

Özel durumlar

NotSupportedException

Yüklenen XML varlık başvuruları içeriyor ve okuyucu varlıkları çözümleyemez.

Ö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

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

XML

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

XML

<!--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:

XML

<!--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.

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Aracılığıyla paylaş

XmlDataDocument.Load Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

Load(Stream)

Parametreler

Açıklamalar

Şunlara uygulanır

Load(TextReader)

Parametreler

Açıklamalar

Şunlara uygulanır

Load(String)

Parametreler

Açıklamalar

Şunlara uygulanır

Load(XmlReader)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar