DataSet.ReadXml メソッドとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

DataSet.ReadXml メソッド (String)

指定したファイルを使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    fileName As String _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim fileName As String
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(fileName)
C#
public XmlReadMode ReadXml (
    string fileName
)
C++
public:
XmlReadMode ReadXml (
    String^ fileName
)
J#
public XmlReadMode ReadXml (
    String fileName
)
JScript
public function ReadXml (
    fileName : String
) : XmlReadMode

パラメータ

fileName

読み込み元の (パスを含む) ファイル名。

戻り値
データを読み込むために使用する XmlReadMode。

例外例外
例外の種類条件

SecurityException

FileIOPermission が Read に設定されていません。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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>
メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

使用例使用例

初めに 1 つの DataTable、2 列、および 10 行で単純な DataSet を作成する例を次に示します。DataSet のスキーマとデータは、WriteXml メソッドの呼び出しによってディスクに書き込みます。2 番目の DataSet を作成し、ReadXml メソッドを使用して、スキーマとデータを格納します。

Visual Basic
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
C#
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();
        }
    }
}
.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (Stream)

指定した System.IO.Stream を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    stream As Stream _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim stream As Stream
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(stream)
C#
public XmlReadMode ReadXml (
    Stream stream
)
C++
public:
XmlReadMode ReadXml (
    Stream^ stream
)
J#
public XmlReadMode ReadXml (
    Stream stream
)
JScript
public function ReadXml (
    stream : Stream
) : XmlReadMode

パラメータ

stream

Stream から派生するオブジェクト。

戻り値
データを読み込むために使用する XmlReadMode。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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>
メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

使用例使用例

初めに 1 つの DataTable、2 列、および 10 行で単純な DataSet を作成する例を次に示します。DataSet のスキーマとデータは、WriteXml メソッドの呼び出しによってディスクに書き込みます。2 番目の DataSet を作成し、ReadXml メソッドを使用して、スキーマとデータを格納します。

Visual Basic
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
C#
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();
        }
    }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
ReadXmlSchema
WriteXml
WriteXmlSchema
その他の技術情報
ADO.NET での DataSet の使用
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (XmlReader, XmlReadMode)

指定した System.Xml.XmlReader と XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    reader As XmlReader, _
    mode As XmlReadMode _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As XmlReader
Dim mode As XmlReadMode
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(reader, mode)
C#
public XmlReadMode ReadXml (
    XmlReader reader,
    XmlReadMode mode
)
C++
public:
XmlReadMode ReadXml (
    XmlReader^ reader, 
    XmlReadMode mode
)
J#
public XmlReadMode ReadXml (
    XmlReader reader, 
    XmlReadMode mode
)
JScript
public function ReadXml (
    reader : XmlReader, 
    mode : XmlReadMode
) : XmlReadMode

パラメータ

reader

読み込み元の XmlReader。

mode

XmlReadMode 値の 1 つ。

戻り値
データを読み込むために使用する XmlReadMode。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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>
メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (TextReader)

指定した System.IO.TextReader を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    reader As TextReader _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As TextReader
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(reader)
C#
public XmlReadMode ReadXml (
    TextReader reader
)
C++
public:
XmlReadMode ReadXml (
    TextReader^ reader
)
J#
public XmlReadMode ReadXml (
    TextReader reader
)
JScript
public function ReadXml (
    reader : TextReader
) : XmlReadMode

パラメータ

reader

スキーマおよびデータの読み出し元の TextReader。

戻り値
データを読み込むために使用する XmlReadMode。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

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

TextReader クラスから継承するクラスには、StreamReader クラスと StringReader クラスが含まれます。

メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

使用例使用例

初めに 1 つの DataTable、2 列、および 10 行で単純な DataSet を作成する例を次に示します。DataSet のスキーマとデータは、WriteXml メソッドの呼び出しによってディスクに書き込みます。2 番目の DataSet を作成し、ReadXml メソッドを使用して、スキーマとデータを格納します。

Visual Basic
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
C#
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();
        }
    }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (XmlReader)

指定した System.Xml.XmlReader を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    reader As XmlReader _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As XmlReader
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(reader)
C#
public XmlReadMode ReadXml (
    XmlReader reader
)
C++
public:
XmlReadMode ReadXml (
    XmlReader^ reader
)
J#
public XmlReadMode ReadXml (
    XmlReader reader
)
JScript
public function ReadXml (
    reader : XmlReader
) : XmlReadMode

パラメータ

reader

読み込み元の XmlReader。

戻り値
データを読み込むために使用する XmlReadMode。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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 は XmlReader から継承します。

メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

使用例使用例

初めに 1 つの DataTable、2 列、および 10 行で単純な DataSet を作成する例を次に示します。DataSet のスキーマとデータは、WriteXml メソッドの呼び出しによってディスクに書き込みます。2 番目の DataSet を作成し、ReadXml メソッドを使用して、スキーマとデータを格納します。

Visual Basic
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)

    ' 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)

    ' 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 & " "
 & _
                    row(column).ToString())
             Next column
             Console.WriteLine()
         Next row
     Next table
  End Sub
C#
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);

    // 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);

    // 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("\table " + row[column] );
            }
            Console.WriteLine();
        }
    }
}
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (Stream, XmlReadMode)

指定した System.IO.Stream と XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    stream As Stream, _
    mode As XmlReadMode _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim stream As Stream
Dim mode As XmlReadMode
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(stream, mode)
C#
public XmlReadMode ReadXml (
    Stream stream,
    XmlReadMode mode
)
C++
public:
XmlReadMode ReadXml (
    Stream^ stream, 
    XmlReadMode mode
)
J#
public XmlReadMode ReadXml (
    Stream stream, 
    XmlReadMode mode
)
JScript
public function ReadXml (
    stream : Stream, 
    mode : XmlReadMode
) : XmlReadMode

パラメータ

stream

読み込み元の Stream。

mode

XmlReadMode 値の 1 つ。

戻り値
データを読み込むために使用する XmlReadMode。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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>
メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (String, XmlReadMode)

指定したファイルと XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    fileName As String, _
    mode As XmlReadMode _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim fileName As String
Dim mode As XmlReadMode
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(fileName, mode)
C#
public XmlReadMode ReadXml (
    string fileName,
    XmlReadMode mode
)
C++
public:
XmlReadMode ReadXml (
    String^ fileName, 
    XmlReadMode mode
)
J#
public XmlReadMode ReadXml (
    String fileName, 
    XmlReadMode mode
)
JScript
public function ReadXml (
    fileName : String, 
    mode : XmlReadMode
) : XmlReadMode

パラメータ

fileName

読み込み元の (パスを含む) ファイル名。

mode

XmlReadMode 値の 1 つ。

戻り値
データを読み込むために使用する XmlReadMode。

例外例外
例外の種類条件

SecurityException

FileIOPermission が Read に設定されていません。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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>
メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド (TextReader, XmlReadMode)

指定した System.IO.TextReader と XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文構文

Visual Basic (宣言)
Public Function ReadXml ( _
    reader As TextReader, _
    mode As XmlReadMode _
) As XmlReadMode
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As TextReader
Dim mode As XmlReadMode
Dim returnValue As XmlReadMode

returnValue = instance.ReadXml(reader, mode)
C#
public XmlReadMode ReadXml (
    TextReader reader,
    XmlReadMode mode
)
C++
public:
XmlReadMode ReadXml (
    TextReader^ reader, 
    XmlReadMode mode
)
J#
public XmlReadMode ReadXml (
    TextReader reader, 
    XmlReadMode mode
)
JScript
public function ReadXml (
    reader : TextReader, 
    mode : XmlReadMode
) : XmlReadMode

パラメータ

reader

読み込み元の TextReader。

mode

XmlReadMode 値の 1 つ。

戻り値
データを読み込むために使用する XmlReadMode。

解説解説

ReadXml メソッドを使用すると、XML ドキュメントから DataSet に、データだけ、またはデータとスキーマの両方を読み込むことができます。これに対して ReadXmlSchema メソッドは、スキーマだけを読み込みます。データとスキーマの両方を読み取るには、mode パラメータを含む ReadXML オーバーロードの 1 つを使用し、その値を ReadSchema に設定します。

WriteXml メソッドと WriteXmlSchema メソッドについても、それぞれ同様です。XML データ、またはスキーマとデータの両方を DataSet から書き込むには、WriteXml メソッドを使用します。スキーマだけを書き込むには、WriteXmlSchema メソッドを使用します。

インライン スキーマを指定した場合、そのインライン スキーマはデータを読み込む前に既存のリレーショナル構造を拡張するために使用されます。競合が存在する場合は (たとえば、異なるデータ型で定義された同じテーブルの同じ列)、例外が発生します。

インライン スキーマを指定しない場合、XML ドキュメントの構造に従い、必要に応じて、リレーショナル構造は推論によって拡張されます。すべてのデータを公開するために、推論によってスキーマを拡張できない場合は、例外が発生します。

メモメモ

シリアル化された XML で有効な XML 文字 ("_" など) がエスケープされている場合、DataSet は、XML 要素をその対応する DataColumn や DataTable に関連付けません。DataSet 自体は、XML 要素名の無効な XML 文字のみをエスケープするため、同じ要素名しか使用できません。XML 要素名の有効文字がエスケープされている場合、その要素は処理中に無視されます。

DataSet の XML スキーマに targetNamespace が含まれている場合、データを読み取ることができない可能性があります。また、ReadXml を呼び出して、名前空間の限定がない要素を含む XML で DataSet を読み込むと、例外が発生する可能性があります。限定されていない要素を読み取るには、次の例のように、XML スキーマで elementFormDefault を "qualified" に設定します。

 <xsd:schema 
    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>
メモメモ

DataSet のスキーマに、同じ名前空間で名前が同じであるが型が違う要素が含まれている場合、XmlReadMode.ReadSchema を指定してスキーマを ReadXml で DataSet に読み込もうとすると、例外がスローされます。この例外は、.NET Framework Version 1.0 を使用している場合は発生しません。

プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.ReadXml メソッド

XML スキーマとデータを DataSet に読み込みます。
オーバーロードの一覧オーバーロードの一覧

名前 説明
DataSet.ReadXml (Stream) 指定した System.IO.Stream を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (String) 指定したファイルを使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (TextReader) 指定した System.IO.TextReader を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (XmlReader) 指定した System.Xml.XmlReader を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (Stream, XmlReadMode) 指定した System.IO.Stream と XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (String, XmlReadMode) 指定したファイルと XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (TextReader, XmlReadMode) 指定した System.IO.TextReader と XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

DataSet.ReadXml (XmlReader, XmlReadMode) 指定した System.Xml.XmlReader と XmlReadMode を使用して、XML スキーマとデータを DataSet に読み込みます。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

DataSet クラス
DataSet メンバ
System.Data 名前空間
ReadXmlSchema
WriteXml
WriteXmlSchema

その他の技術情報

ADO.NET での DataSet の使用
ADO.NET での DataSet の使用
ADO.NET での DataSet の使用

急上昇のことば

フジテレビのアナウンサー一覧
とこしえ
インスパイア
木瓜
サンデーモーニング
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「DataSet.ReadXml メソッド」の関連用語

1
AdRotator.Render メソッド
.NET Framework クラス ライブラリ リファレンス
18% |||||

2
DataTable.ReadXml メソッド
.NET Framework クラス ライブラリ リファレンス
16% |||||

DataSet.ReadXml メソッドのお隣キーワード

DataSet.OnPropertyChanging メソッド

DataSet.OnRemoveRelation メソッド

DataSet.OnRemoveTable メソッド

DataSet.Prefix プロパティ

DataSet.RaisePropertyChanging メソッド

DataSet.ReadXml メソッド

DataSet.ReadXmlSchema メソッド

DataSet.ReadXmlSerializable メソッド

DataSet.RejectChanges メソッド

DataSet.Relations プロパティ

DataSet.RemotingFormat プロパティ

DataSet.Reset メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


DataSet.ReadXml メソッドのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2024 Microsoft.All rights reserved.

©2024 GRAS Group, Inc.RSS