DataSet.ReadXml Yöntem
Tanım
Ö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.
XML şemasını ve verilerini dosyasında DataSetokur.
Aşırı Yüklemeler
ReadXml(XmlReader, XmlReadMode) |
Belirtilen XmlReader ve XmlReadModekullanarak XML şemasını ve verilerini içine DataSet okur. |
ReadXml(String, XmlReadMode) |
Belirtilen ve dosyasını kullanarak XML şemasını ve XmlReadModeverilerini dosyasında DataSet okur. |
ReadXml(Stream, XmlReadMode) |
Belirtilen Stream ve XmlReadModekullanarak XML şemasını ve verilerini içine DataSet okur. |
ReadXml(TextReader, XmlReadMode) |
Belirtilen TextReader ve XmlReadModekullanarak XML şemasını ve verilerini içine DataSet okur. |
ReadXml(String) |
Belirtilen dosyayı kullanarak XML şemasını ve verilerini dosyasında DataSet okur. |
ReadXml(TextReader) |
Belirtilen TextReaderkullanarak XML şemasını ve verilerini dosyasında DataSet okur. |
ReadXml(Stream) |
Belirtilen Streamkullanarak XML şemasını ve verilerini dosyasında DataSet okur. |
ReadXml(XmlReader) |
Belirtilen XmlReaderkullanarak XML şemasını ve verilerini dosyasında DataSet okur. |
ReadXml(XmlReader, XmlReadMode)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
Belirtilen XmlReader ve XmlReadModekullanarak XML şemasını ve verilerini içine DataSet okur.
public:
System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader, System.Data.XmlReadMode mode);
member this.ReadXml : System.Xml.XmlReader * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader, mode As XmlReadMode) As XmlReadMode
Parametreler
- mode
- XmlReadMode
Değerlerden XmlReadMode biri.
Döndürülenler
Verileri XmlReadMode
okumak için kullanılır.
Açıklamalar
ReadXml yöntemi bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması bir targetNamespace
içeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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>
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(String, XmlReadMode)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
Belirtilen ve dosyasını kullanarak XML şemasını ve XmlReadModeverilerini dosyasında DataSet okur.
public:
System::Data::XmlReadMode ReadXml(System::String ^ fileName, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (string fileName, System.Data.XmlReadMode mode);
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
Verileri XmlReadMode
okumak için kullanılır.
Özel durumlar
FileIOPermission olarak ayarlanmadı Read.
Açıklamalar
ReadXml yöntemi bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması bir targetNamespace
içeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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>
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(Stream, XmlReadMode)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
Belirtilen Stream ve XmlReadModekullanarak XML şemasını ve verilerini içine DataSet okur.
public:
System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream, System.Data.XmlReadMode mode);
member this.ReadXml : System.IO.Stream * System.Data.XmlReadMode -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream, mode As XmlReadMode) As XmlReadMode
Parametreler
- mode
- XmlReadMode
Değerlerden XmlReadMode biri.
Döndürülenler
Verileri XmlReadMode
okumak için kullanılır.
Açıklamalar
ReadXml yöntemi bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Aynı durum sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerlidir. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
kullandığınızda ReadXml ve olarak Diffgram
ayarladığınızdaXmlReadMode, difgramın nasıl oluşturulduğu ve işlendiği nedeniyle hedefin DataSet
içeriği ve özgün DataSet
içeriği farklılık gösterebilir. Difgramlar hakkında daha fazla bilgi için bkz. DiffGrams.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması öğesini içeriyorsatargetNamespace
, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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>
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(TextReader, XmlReadMode)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
Belirtilen TextReader ve XmlReadModekullanarak XML şemasını ve verilerini içine DataSet okur.
public:
System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader, System::Data::XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader, System.Data.XmlReadMode mode);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader, System.Data.XmlReadMode mode);
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 kaynak.
- mode
- XmlReadMode
Değerlerden XmlReadMode biri.
Döndürülenler
Verileri XmlReadMode
okumak için kullanılır.
Açıklamalar
ReadXml yöntemi bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması öğesini içeriyorsatargetNamespace
, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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>
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(String)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
Belirtilen dosyayı kullanarak XML şemasını ve verilerini dosyasında DataSet okur.
public:
System::Data::XmlReadMode ReadXml(System::String ^ fileName);
public System.Data.XmlReadMode ReadXml (string fileName);
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
Verileri XmlReadMode
okumak için kullanılır.
Özel durumlar
FileIOPermission olarak ayarlanmadı Read.
Örnekler
Aşağıdaki örnek önce bir DataTable, iki sütun ve on satır içeren basit DataSet bir oluşturur. Şema DataSet ve veriler, yöntemi çağrılarak diske WriteXml yazılır. bir saniye DataSet oluşturulur ve şema ve ReadXml 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 bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması bir targetNamespace
içeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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>
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(TextReader)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
Belirtilen TextReaderkullanarak XML şemasını ve verilerini dosyasında DataSet okur.
public:
System::Data::XmlReadMode ReadXml(System::IO::TextReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader? reader);
public System.Data.XmlReadMode ReadXml (System.IO.TextReader reader);
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
Verileri XmlReadMode okumak için kullanılır.
Örnekler
Aşağıdaki örnek önce bir DataTable, iki sütun ve on satır içeren basit DataSet bir oluşturur. Şema DataSet ve veriler, yöntemi çağrılarak diske WriteXml yazılır. bir saniye DataSet oluşturulur ve şema ve ReadXml 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 bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması öğesini içeriyorsatargetNamespace
, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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 devralınan TextReader sınıflar ve StringReader sınıflarını StreamReader içerir.
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(Stream)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
public:
System::Data::XmlReadMode ReadXml(System::IO::Stream ^ stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream? stream);
public System.Data.XmlReadMode ReadXml (System.IO.Stream stream);
member this.ReadXml : System.IO.Stream -> System.Data.XmlReadMode
Public Function ReadXml (stream As Stream) As XmlReadMode
Parametreler
Döndürülenler
Verileri XmlReadMode okumak için kullanılır.
Örnekler
Aşağıdaki örnek önce bir DataTable, iki sütun ve on satır içeren basit DataSet bir oluşturur. Şema DataSet ve veriler, yöntemi çağrılarak diske WriteXml yazılır. bir saniye DataSet oluşturulur ve şema ve ReadXml 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 bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması öğesini içeriyorsatargetNamespace
, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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>
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.
Ayrıca bkz.
Şunlara uygulanır
ReadXml(XmlReader)
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
- Kaynak:
- DataSet.cs
public:
System::Data::XmlReadMode ReadXml(System::Xml::XmlReader ^ reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader? reader);
public System.Data.XmlReadMode ReadXml (System.Xml.XmlReader reader);
member this.ReadXml : System.Xml.XmlReader -> System.Data.XmlReadMode
Public Function ReadXml (reader As XmlReader) As XmlReadMode
Parametreler
Döndürülenler
Verileri XmlReadMode
okumak için kullanılır.
Örnekler
Aşağıdaki örnek önce bir DataTable, iki sütun ve on satır içeren basit DataSet bir oluşturur. Şema DataSet ve veriler, yöntemi çağrılarak diske WriteXml yazılır. bir saniye DataSet oluşturulur ve şema ve ReadXml 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 bir XML belgesinden yalnızca verileri veya hem verileri hem de şemayı okumanın bir DataSet 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 ReadSchema
ayarlayın.
Bunun sırasıyla ve WriteXmlSchema yöntemleri için WriteXml de geçerli olduğunu unutmayın. XML verileri yazmak için veya dosyasından DataSet
hem şema hem de veri yazmak için yöntemini kullanın WriteXml
. Yalnızca şemayı yazmak için yöntemini kullanın WriteXmlSchema
.
Not
InvalidOperationException'den okunan veya uygulamasına yazılan bir sütun türü DataRow
uygularsa IDynamicMetaObjectProvider ve uygulamazsa IXmlSerializablebir oluşturulur.
Bir satır içi şema belirtilmezse, satır içi şema veri yükleme öncesinde varolan ilişkisel yapıyı genişletmek için kullanılır. Çakışmalar varsa (örneğin, aynı tablodaki aynı sütun farklı veri türleriyle tanımlanmış) bir özel durum oluşturulur.
Hiçbir satır içi şema belirtilmezse, çıkarım yoluyla ilişkisel yapı, XML belgesinin yapısına göre gerektiği gibi genişletilir. Şema tüm verileri göstermek için çıkarım yoluyla genişletilemiyorsa, özel durum oluşturulur.
Not
, DataSet
bir XML öğesini karşılık gelen DataColumn
xml ile 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 öğesinin adındaki geçerli karakterler çıkarıldığında, öğe işlenirken göz ardı edilir.
için DataSet XML Şeması bir targetNamespace
içeriyorsa, veriler okunamayabilir ve niteleyici ad alanı olmayan öğeler içeren XML ile yüklemek DataSet için çağrısı ReadXml yaparken özel durumlarla karşılaşabilirsiniz. Nitelenmemiş öğeleri okumak için, aşağıdaki örnekte gösterildiği gibi XML Şemanızda "nitelikli" 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 ' den XmlReaderdevralır.
Not
Şemanız DataSet aynı ada sahip ancak farklı türde öğeler içeriyorsa, aynı ad alanında, belirterek XmlReadMode.ReadSchema
ile içine şemayı DataSetReadXml okumaya çalıştığınızda bir özel durum oluşturulur. .NET Framework sürüm 1.0 kullanıyorsanız, bu özel durum oluşmaz.