DataSet.ReadXml Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

XML şemasını ve verilerini içine DataSetokur.

Aşırı Yüklemeler

Name	Description
ReadXml(XmlReader, XmlReadMode)	Belirtilen DataSet ve XmlReaderkullanarak XML şemasını ve verilerini içine XmlReadMode okur.
ReadXml(String, XmlReadMode)	Belirtilen dosyayı ve kullanarak XML şemasını ve DataSetverilerini içine XmlReadMode okur.
ReadXml(Stream, XmlReadMode)	Belirtilen DataSet ve Streamkullanarak XML şemasını ve verilerini içine XmlReadMode okur.
ReadXml(TextReader, XmlReadMode)	Belirtilen DataSet ve TextReaderkullanarak XML şemasını ve verilerini içine XmlReadMode okur.
ReadXml(String)	Belirtilen dosyayı kullanarak XML şemasını ve verilerini içine DataSet okur.
ReadXml(TextReader)	Belirtilen DataSetkullanarak XML şemasını ve verilerini içine TextReader okur.
ReadXml(Stream)	Belirtilen DataSetkullanarak XML şemasını ve verilerini içine Stream okur.
ReadXml(XmlReader)	Belirtilen DataSetkullanarak XML şemasını ve verilerini içine XmlReader okur.

ReadXml(XmlReader, XmlReadMode)

Kaynak:

DataSet.cs

Belirtilen DataSet ve XmlReaderkullanarak XML şemasını ve verilerini içine XmlReadMode okur.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode

Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode

Parametreler

reader

XmlReader

XmlReader Okunacak yer.

mode

XmlReadMode

Değerlerden XmlReadMode biri.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması bir targetNamespaceiçeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile öğesini yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma

ReadXml(String, XmlReadMode)

Kaynak:

DataSet.cs

Belirtilen dosyayı ve kullanarak XML şemasını ve DataSetverilerini içine XmlReadMode okur.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : string * System.Data.XmlReadMode -> System.Data.XmlReadMode

Public Function ReadXml (fileName As String, mode As XmlReadMode) As XmlReadMode

Parametreler

fileName

String

Okunacak dosya adı (yol dahil).

mode

XmlReadMode

Değerlerden XmlReadMode biri.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Özel durumlar

SecurityException

FileIOPermission olarak ayarlanmadı Read.

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması bir targetNamespaceiçeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile öğesini yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma

ReadXml(Stream, XmlReadMode)

Kaynak:

DataSet.cs

Belirtilen DataSet ve Streamkullanarak XML şemasını ve verilerini içine XmlReadMode okur.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode

Public Function ReadXml (stream As Stream, mode As XmlReadMode) As XmlReadMode

Parametreler

stream

Stream

Stream Okunacak yer.

mode

XmlReadMode

Değerlerden XmlReadMode biri.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı durum sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerlidir. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

kullandığınızda ReadXml ve olarak XmlReadModeayarladığınızdaDiffgram, fark biriminin nasıl oluşturulduğu ve işlendiği nedeniyle hedefin DataSet içeriği ve özgün DataSet içerik farklı olabilir. Difgramlar hakkında daha fazla bilgi için bkz. DiffGrams.

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması içeriyorsatargetNamespace, veriler okunamayabilir ve niteleyici ad alanına sahip olmayan öğeler içeren XML ile yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma

ReadXml(TextReader, XmlReadMode)

Kaynak:

DataSet.cs

Belirtilen DataSet ve TextReaderkullanarak XML şemasını ve verilerini içine XmlReadMode okur.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader, System.Data.XmlReadMode mode);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.TextReader * System.Data.XmlReadMode -> System.Data.XmlReadMode

Public Function ReadXml (reader As TextReader, mode As XmlReadMode) As XmlReadMode

Parametreler

reader

TextReader

TextReader Okunacak yer.

mode

XmlReadMode

Değerlerden XmlReadMode biri.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması içeriyorsatargetNamespace, veriler okunamayabilir ve niteleyici ad alanına sahip olmayan öğeler içeren XML ile yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma

ReadXml(String)

Kaynak:

DataSet.cs

Belirtilen dosyayı kullanarak XML şemasını ve verilerini içine DataSet okur.

public:
 System::Data::XmlReadMode ReadXml(System::String ^ fileName);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(string fileName);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : string -> System.Data.XmlReadMode

Public Function ReadXml (fileName As String) As XmlReadMode

Parametreler

fileName

String

Okunacak dosya adı (yol dahil).

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Özel durumlar

SecurityException

FileIOPermission olarak ayarlanmadı Read.

Örnekler

Aşağıdaki örnek ilk olarak bir DataSet, iki sütun ve on satır içeren basit DataTable bir oluşturur. DataSet Şema ve veriler, yöntemi çağrılarak diske WriteXml yazılır. Saniye DataSet oluşturulur ve ReadXml şema ve verilerle doldurmak için yöntemi kullanılır.

private void DemonstrateReadWriteXMLDocumentWithStreamReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

    // Add ten rows.
    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    OriginalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the schema and data to an XML file.
    string xmlFilename = "XmlDocument.xml";

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename);

    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithStreamReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    OriginalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the schema and data to an XML file.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlFilename)

    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlFilename)

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)
        Dim row As DataRow
        For Each row In  table.Rows
            Dim column As DataColumn
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                    row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması bir targetNamespaceiçeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile öğesini yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma

ReadXml(TextReader)

Kaynak:

DataSet.cs

Belirtilen DataSetkullanarak XML şemasını ve verilerini içine TextReader okur.

public:
 System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.TextReader? reader);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.TextReader -> System.Data.XmlReadMode

Public Function ReadXml (reader As TextReader) As XmlReadMode

Parametreler

reader

TextReader

Şemanın TextReader ve verilerin okunduğu yer.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Örnekler

Aşağıdaki örnek ilk olarak bir DataSet, iki sütun ve on satır içeren basit DataTable bir oluşturur. DataSet Şema ve veriler, yöntemi çağrılarak diske WriteXml yazılır. Saniye DataSet oluşturulur ve ReadXml şema ve verilerle doldurmak için yöntemi kullanılır.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();

    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    originalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması içeriyorsatargetNamespace, veriler okunamayabilir ve niteleyici ad alanına sahip olmayan öğeler içeren XML ile yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

sınıfından devralan sınıflar TextReader ve StreamReader sınıflarını StringReader içerir.

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma

ReadXml(Stream)

Kaynak:

DataSet.cs

Belirtilen DataSetkullanarak XML şemasını ve verilerini içine Stream okur.

public:
 System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.IO.Stream? stream);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode

Public Function ReadXml (stream As Stream) As XmlReadMode

Parametreler

stream

Stream

öğesinden Streamtüretilen bir nesne.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Örnekler

Aşağıdaki örnek ilk olarak bir DataSet, iki sütun ve on satır içeren basit DataTable bir oluşturur. DataSet Şema ve veriler, yöntemi çağrılarak diske WriteXml yazılır. Saniye DataSet oluşturulur ve ReadXml şema ve verilerle doldurmak için yöntemi kullanılır.

private void DemonstrateReadWriteXMLDocumentWithFileStream()
{
    // Create a DataSet with one table and two columns.
    DataSet originalDataSet = new DataSet("dataSet");
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    originalDataSet.Tables.Add(table);
    // Add ten rows.

    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    originalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(originalDataSet, "Original DataSet");

    // Write the schema and data to XML file with FileStream.
    string xmlFilename = "XmlDocument.xml";
    System.IO.FileStream streamWrite = new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite);

    // Close the FileStream.
    streamWrite.Close();

    // Dispose of the original DataSet.
    originalDataSet.Dispose();
    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream streamRead = new System.IO.FileStream
        (xmlFilename,System.IO.FileMode.Open);
    newDataSet.ReadXml(streamRead);

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithFileStream()
    ' Create a DataSet with one table and two columns.
    Dim originalDataSet As New DataSet("dataSet")
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
       Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    originalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    originalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(originalDataSet, "Original DataSet")

    ' Write the schema and data to XML file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"
    Dim streamWrite As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Create)

    ' Use WriteXml to write the XML document.
    originalDataSet.WriteXml(streamWrite)

    ' Close the FileStream.
    streamWrite.Close()
     
    ' Dispose of the original DataSet.
    originalDataSet.Dispose()
    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
       
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim streamRead As New System.IO.FileStream _
       (xmlFilename, System.IO.FileMode.Open)
     
    newDataSet.ReadXml(streamRead)
    ' Print out values of each table in the DataSet  
    ' using the function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
   
Private Sub PrintValues(dataSet As DataSet, label As String)
    Console.WriteLine(ControlChars.Cr & label)
    Dim table As DataTable
    Dim row As DataRow
    Dim column As DataColumn
    For Each table In  dataSet.Tables
        Console.WriteLine("TableName: " & table.TableName)         
        For Each row In  table.Rows             
            For Each column In  table.Columns
                Console.Write(ControlChars.Tab & " " & _
                   row(column).ToString())
            Next column
            Console.WriteLine()
        Next row
    Next table
End Sub

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması içeriyorsatargetNamespace, veriler okunamayabilir ve niteleyici ad alanına sahip olmayan öğeler içeren XML ile yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ReadXmlSchema(XmlReader)
• WriteXml(Stream)
• WriteXmlSchema(Stream)
• ADO.NET'da DataSet'leri kullanma

ReadXml(XmlReader)

Kaynak:

DataSet.cs

Belirtilen DataSetkullanarak XML şemasını ve verilerini içine XmlReader okur.

public:
 System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")]
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")]
public System.Data.XmlReadMode ReadXml(System.Xml.XmlReader? reader);

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("Members from serialized types may use dynamic code generation.")>]
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members from serialized types may be trimmed if not referenced directly.")>]
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode

Public Function ReadXml (reader As XmlReader) As XmlReadMode

Parametreler

reader

XmlReader

XmlReader Okunacak yer.

Döndürülenler

XmlReadMode

Verileri XmlReadMode okumak için kullanılan.

Öznitelikler

RequiresDynamicCodeAttribute RequiresUnreferencedCodeAttribute

Örnekler

Aşağıdaki örnek ilk olarak bir DataSet, iki sütun ve on satır içeren basit DataTable bir oluşturur. DataSet Şema ve veriler, yöntemi çağrılarak diske WriteXml yazılır. Saniye DataSet oluşturulur ve ReadXml şema ve verilerle doldurmak için yöntemi kullanılır.

private void DemonstrateReadWriteXMLDocumentWithXMLReader()
{
    // Create a DataSet with one table and two columns.
    DataSet OriginalDataSet = new DataSet("dataSet");
    OriginalDataSet.Namespace= "NetFrameWork";
    DataTable table = new DataTable("table");
    DataColumn idColumn = new DataColumn("id",
        Type.GetType("System.Int32"));
    idColumn.AutoIncrement= true;

    DataColumn itemColumn = new DataColumn("item");
    table.Columns.Add(idColumn);
    table.Columns.Add(itemColumn);
    OriginalDataSet.Tables.Add(table);

    // Add ten rows.
    DataRow newRow;
    for(int i = 0; i < 10; i++)
    {
        newRow = table.NewRow();
        newRow["item"]= "item " + i;
        table.Rows.Add(newRow);
    }
    OriginalDataSet.AcceptChanges();

    // Print out values of each table in the DataSet
    // using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet");

    // Write the XML schema and data to file with FileStream.
    string xmlFilename = "XmlDocument.xml";

    // Create FileStream
    System.IO.FileStream fsWriteXml =
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Create);

    // Create an XmlTextWriter to write the file.
    System.Xml.XmlTextWriter xmlWriter =
        new System.Xml.XmlTextWriter
        (fsWriteXml, System.Text.Encoding.Unicode);

    // Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema);

    // Close the FileStream.
    fsWriteXml.Close();

    // Dispose of the original DataSet.
    OriginalDataSet.Dispose();

    // Create a new DataSet.
    DataSet newDataSet = new DataSet("New DataSet");

    // Read the XML document back in.
    // Create new FileStream to read schema with.
    System.IO.FileStream fsReadXml =
        new System.IO.FileStream
        (xmlFilename, System.IO.FileMode.Open);

    // Create an XmlTextReader to read the file.
    System.Xml.XmlTextReader xmlReader =
        new System.Xml.XmlTextReader(fsReadXml);

    // Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema);

    // Close the XmlTextReader
    xmlReader.Close();

    // Print out values of each table in the DataSet
    // fusing the unction defined below.
    PrintValues(newDataSet,"New DataSet");
}

private void PrintValues(DataSet dataSet, string label)
{
    Console.WriteLine("\n" + label);
    foreach(DataTable table in dataSet.Tables)
    {
        Console.WriteLine("TableName: " + table.TableName);
        foreach(DataRow row in table.Rows)
        {
            foreach(DataColumn column in table.Columns)
            {
                Console.Write("\t{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row[column]);
            }
            Console.WriteLine();
        }
    }
}

Private Sub DemonstrateReadWriteXMLDocumentWithXMLReader()
    ' Create a DataSet with one table and two columns.
    Dim OriginalDataSet As New DataSet("dataSet")
    OriginalDataSet.Namespace = "NetFrameWork"
    Dim table As New DataTable("table")
    Dim idColumn As New DataColumn("id", _
        Type.GetType("System.Int32"))
    idColumn.AutoIncrement = True

    Dim itemColumn As New DataColumn("item")
    table.Columns.Add(idColumn)
    table.Columns.Add(itemColumn)
    OriginalDataSet.Tables.Add(table)

    ' Add ten rows.
    Dim newRow As DataRow
    Dim i As Integer
    For i = 0 To 9
        newRow = table.NewRow()
        newRow("item") = "item " & i.ToString()
        table.Rows.Add(newRow)
    Next i
    OriginalDataSet.AcceptChanges()

    ' Print out values of each table in the DataSet 
    ' using the function defined below.
    PrintValues(OriginalDataSet, "Original DataSet")

    ' Write the XML schema and data to file with FileStream.
    Dim xmlFilename As String = "XmlDocument.xml"

    ' Create FileStream    
    Dim fsWriteXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Create)

    ' Create an XmlTextWriter to write the file.
    Dim xmlWriter As New System.Xml.XmlTextWriter _
        (fsWriteXml, System.Text.Encoding.Unicode)

    ' Use WriteXml to write the document.
    OriginalDataSet.WriteXml(xmlWriter, XmlWriteMode.WriteSchema)

    ' Close the FileStream.
    fsWriteXml.Close()
        
    ' Dispose of the original DataSet.
    OriginalDataSet.Dispose()

    ' Create a new DataSet.
    Dim newDataSet As New DataSet("New DataSet")
        
    ' Read the XML document back in. 
    ' Create new FileStream to read schema with.
    Dim fsReadXml As New System.IO.FileStream _
        (xmlFilename, System.IO.FileMode.Open)

    ' Create an XmlTextReader to read the file.
    Dim xmlReader As New System.Xml.XmlTextReader(fsReadXml)

    ' Read the XML document into the DataSet.
    newDataSet.ReadXml(xmlReader, XmlReadMode.ReadSchema)

    ' Close the XmlTextReader
    xmlReader.Close()
        
    ' Print out values of each table in the DataSet using the 
    ' function defined below.
    PrintValues(newDataSet, "New DataSet")
End Sub
    
    
 Private Sub PrintValues(dataSet As DataSet, label As String)
     Console.WriteLine(ControlChars.Cr & label)
     Dim table As DataTable
     Dim row As DataRow
     Dim column As DataColumn
     For Each table In  dataSet.Tables
         Console.WriteLine("TableName: " & table.TableName)
         For Each row In  table.Rows
             For Each column In  table.Columns
                 Console.Write(ControlChars.Tab & "{0}({1})='{2}'", column.ColumnName, column.DataType.Name, row(column).ToString())

             Next column
             Console.WriteLine()
         Next row
     Next table
  End Sub

Açıklamalar

ReadXml yöntemi, xml belgesinden yalnızca verileri veya hem verileri hem de şemayı DataSet okumanın bir yolunu sağlarkenReadXmlSchema, yöntem yalnızca şemayı okur. Hem verileri hem de şemayı okumak için parametresini ReadXML içeren mode aşırı yüklemelerden birini kullanın ve değerini olarak ReadSchemaayarlayın.

Aynı değerin sırasıyla ve WriteXml yöntemleri için WriteXmlSchema de geçerli olduğunu unutmayın. XML verilerini veya 'den DataSethem şema hem de verileri yazmak için yöntemini kullanın WriteXml . Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema .

Note

InvalidOperationException uygulamasından okunan veya yazılan bir sütun türü DataRow uygular ve uygulamazsa IDynamicMetaObjectProviderIXmlSerializableoluşturulur.

Satır içi şema belirtilirse, verileri yüklemeden önce mevcut ilişkisel yapıyı genişletmek için satır içi şema kullanılır. Herhangi bir çakışma varsa (örneğin, aynı tabloda farklı veri türleriyle tanımlanan aynı sütun) bir özel durum oluşur.

Satır içi şema belirtilmezse, ilişkisel yapı, XML belgesinin yapısına göre gerektiğinde çıkarım yoluyla genişletilir. Şema, tüm verileri kullanıma sunmak için çıkarım yoluyla genişletilemiyorsa, bir özel durum oluşturulur.

Note

bir DataSet XML öğesini karşılık gelen DataColumn xml öğesiyle ilişkilendirmez veya DataTable ("_") gibi yasal XML karakterleri serileştirilmiş XML'de kaçıldığında. Kendisi DataSet yalnızca XML öğesi adlarındaki geçersiz XML karakterlerinden kaçar ve bu nedenle yalnızca aynı karakterleri kullanabilir. XML öğesi adındaki yasal karakterler kaçıldığında, öğe işlenirken yoksayılır.

için DataSet XML Şeması bir targetNamespaceiçeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile öğesini yüklemek ReadXml için çağrısı DataSet yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelenmiş" olarak ayarlayın elementFormDefault .

<xsd:schema id="MyDataSet"
   elementFormDefault="qualified"
   targetNamespace="http://www.tempuri.org/MyDataSet.xsd"
   xmlns="http://www.tempuri.org/MyDataSet.xsd"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
</xsd:schema>

System.Xml.XmlTextReader öğesinden XmlReaderdevralır.

Note

Şemanız DataSet aynı ada sahip, ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek DataSetile ReadXml içine şemayı XmlReadMode.ReadSchema okumaya çalıştığınızda bir özel durum oluşur. .NET Framework sürüm 1.0 kullanıyorsanız bu özel durum oluşmaz.

Ayrıca bkz.

• ADO.NET'da DataSet'leri kullanma