XmlDataDocument.Load Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Data.Common.dll

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

Aşırı Yüklemeler

Name	Description
Load(Stream)	belirtilen akıştan öğesini XmlDataDocument yükler.
Load(TextReader)	belirtilen TextReader'den öğesini XmlDataDocument yükler.
Load(String)	Belirtilen URL'yi kullanarak öğesini XmlDataDocument yükler.
Load(XmlReader)	belirtilen XmlReader'den öğesini XmlDataDocument yükler.

Açıklamalar

Uyarı

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ın yapılması gerekir.

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

Load(Stream)

Kaynak:

XmlDataDocument.cs

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üklenecek 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.

Uyarı

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ın yapılması gerekir.

Load(TextReader)

Kaynak:

XmlDataDocument.cs

belirtilen TextReader'den öğ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ılır.

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.

Uyarı

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ın yapılması gerekir.

Load(String)

Kaynak:

XmlDataDocument.cs

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üklenecek 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.

Uyarı

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ın yapılması gerekir.

Load(XmlReader)

Kaynak:

XmlDataDocument.cs

belirtilen XmlReader'den öğ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üklenecek XML belgesini içeren.

Özel durumlar

NotSupportedException

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

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 XmlValidatingReaderEntityHandling oluşturmanız (varsayılan davranış budur) ve yöntemini geçirmeniz XmlValidatingReaderLoad gerekir. bir kullanmazsanızXmlValidatingReaderLoad, 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'yi bulduklarından oluşturur.

Okuyucu zaten bir düğümde "n" derinliğinde 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 aşağıdaki eşdüzeyleri aşağıdakine benzerse:

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

Load bir belge iki kök düzeyinde öğe içeremediği için 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 tamamlanmamış 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, 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.