DataSet.Loadとは？ わかりやすく解説

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

DataSet.Load メソッド (IDataReader, LoadOption, DataTable[])

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した IDataReader を使用するデータ ソースの値を DataSet に格納し、DataTable インスタンスの配列を使用してスキーマ情報と名前空間情報を指定します。

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

Visual Basic (宣言)
Public Sub Load ( _
    reader As IDataReader, _
    loadOption As LoadOption, _
    ParamArray tables As DataTable() _
)
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As IDataReader
Dim loadOption As LoadOption
Dim tables As DataTable()

instance.Load(reader, loadOption, tables)
C#
public void Load (
    IDataReader reader,
    LoadOption loadOption,
    params DataTable[] tables
)
C++
public:
void Load (
    IDataReader^ reader, 
    LoadOption loadOption, 
    ... array<DataTable^>^ tables
)
J#
public void Load (
    IDataReader reader, 
    LoadOption loadOption, 
    DataTable[] tables
)
JScript
public function Load (
    reader : IDataReader, 
    loadOption : LoadOption, 
    ... tables : DataTable[]
)

パラメータ

reader

1 つ以上の結果セットを含む IDataReader。

loadOption

LoadOption 列挙体の値。DataSet 内の DataTable インスタンスに既に含まれている行を同じ主キーを持つ受信した行と結合する方法を示します。

tables

Load メソッドが名前と名前空間の情報を取得する、DataTable インスタンスの配列。これらのテーブルは、この DataSet に格納されている DataTableCollection のメンバである必要があります。

解説解説

Load メソッドは、単一の DataTable に、IDataReader のインスタンスから取得したデータを挿入する手段を提供します。このメソッドは同じ機能を提供しますが、複数の結果セットを IDataReader から読み込んで、DataSet 内の複数のテーブルに格納します。

loadOption パラメータを使用して、既存のデータに対してデータをインポートする方法を指定できます。このパラメータには、LoadOption 列挙体の任意の値を設定できます。このパラメータの使用方法の詳細については、DataTableLoad メソッドに関するドキュメントを参照してください。

tables パラメータを使用して DataTable インスタンスの配列を指定することで、リーダーによって読み込まれた結果セットにそれぞれ対応するテーブルの順序を指定できます。Load メソッドは、ソース データ リーダーから得た単一の結果セットのデータを指定した各 DataTable インスタンスに格納します。1 つの結果セットの操作が終わると、Load メソッドはリーダー内の次の結果セットを操作します。これをすべての結果セットについて行います。

このメソッドの名前解決スキームは、DbDataAdapter クラスの Fill メソッドで使用されるスキームと同じです。

使用例使用例

次に示す例では、新しい DataSet を作成し、2 つの DataTable インスタンスを DataSet に追加した後、Load メソッドを使用して DataSet に入力し、2 つの結果セットを含む DataTableReader からデータを取得します。最後に、コンソール ウィンドウにテーブルの内容を表示します。

Visual Basic
Sub Main()
    Dim dataSet As New DataSet

    Dim customerTable As New
 DataTable
    Dim productTable As New
 DataTable

    ' This information is cosmetic, only.
    customerTable.TableName = "Customers"
    productTable.TableName = "Products"

    ' Add the tables to the DataSet:
    dataSet.Tables.Add(customerTable)
    dataSet.Tables.Add(productTable)

    ' Load the data into the existing DataSet. 
    Dim reader As DataTableReader = GetReader()
    dataSet.Load(reader, LoadOption.OverwriteChanges, _
        customerTable, productTable)

    ' Print out the contents of each table:
    For Each table As DataTable
 In dataSet.Tables
        PrintColumns(table)
    Next

    Console.WriteLine("Press any key to continue.")
    Console.ReadKey()
End Sub

Private Function GetCustomers() As
 DataTable
    ' Create sample Customers table.
    Dim table As New DataTable
    table.TableName = "Customers"

    ' Create two columns, ID and Name.
    Dim idColumn As DataColumn = table.Columns.Add("ID",
 _
        GetType(Integer))
    table.Columns.Add("Name", GetType(String))

    ' Set the ID column as the primary key column.
    table.PrimaryKey = New DataColumn() {idColumn}

    table.Rows.Add(New Object() {0, "Mary"})
    table.Rows.Add(New Object() {1, "Andy"})
    table.Rows.Add(New Object() {2, "Peter"})
    table.AcceptChanges()
    Return table
End Function

Private Function GetProducts() As
 DataTable
    ' Create sample Products table, in order
    ' to demonstrate the behavior of the DataTableReader.
    Dim table As New DataTable
    table.TableName = "Products"

    ' Create two columns, ID and Name.
    Dim idColumn As DataColumn = table.Columns.Add("ID",
 _
        GetType(Integer))
    table.Columns.Add("Name", GetType(String))

    ' Set the ID column as the primary key column.
    table.PrimaryKey = New DataColumn() {idColumn}

    table.Rows.Add(New Object() {0, "Wireless
 Network Card"})
    table.Rows.Add(New Object() {1, "Hard
 Drive"})
    table.Rows.Add(New Object() {2, "Monitor"})
    table.Rows.Add(New Object() {3, "CPU"})
    Return table
End Function

Private Function GetReader() As
 DataTableReader
    ' Return a DataTableReader containing multiple
    ' result sets, just for the sake of this demo.
    Dim dataSet As New DataSet
    dataSet.Tables.Add(GetCustomers())
    dataSet.Tables.Add(GetProducts())
    Return dataSet.CreateDataReader()
End Function

Private Sub PrintColumns( _
   ByVal table As DataTable)

    Console.WriteLine()
    Console.WriteLine(table.TableName)
    Console.WriteLine("=========================")
    ' Loop through all the rows in the table.
    For Each row As DataRow
 In table.Rows
        For Each col As
 DataColumn In table.Columns
            Console.Write(row(col).ToString() & " ")
        Next
        Console.WriteLine()
    Next
End Sub
C#
static void Main()
{
    DataSet dataSet = new DataSet();

    DataTable customerTable = new DataTable();
    DataTable productTable = new DataTable();

    // This information is cosmetic, only.
    customerTable.TableName = "Customers";
    productTable.TableName = "Products";

    // Add the tables to the DataSet:
    dataSet.Tables.Add(customerTable);
    dataSet.Tables.Add(productTable);

    // Load the data into the existing DataSet. 
    DataTableReader reader = GetReader();
    dataSet.Load(reader, LoadOption.OverwriteChanges,
        customerTable, productTable);

    // Print out the contents of each table:
    foreach (DataTable table in dataSet.Tables)
    {
        PrintColumns(table);
    }

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table.
    DataTable table = new DataTable();
    table.TableName = "Customers";

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));
    table.Columns.Add("Name", typeof(string));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 0, "Mary" });
    table.Rows.Add(new object[] { 1, "Andy" });
    table.Rows.Add(new object[] { 2, "Peter" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetProducts()
{
    // Create sample Products table.
    DataTable table = new DataTable();
    table.TableName = "Products";

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID",
        typeof(int));
    table.Columns.Add("Name", typeof(string));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 0, "Wireless Network Card"
 });
    table.Rows.Add(new object[] { 1, "Hard Drive" });
    table.Rows.Add(new object[] { 2, "Monitor" });
    table.Rows.Add(new object[] { 3, "CPU" });
    table.AcceptChanges();
    return table;
}

private static void PrintColumns(DataTable
 table)
{
    Console.WriteLine();
    Console.WriteLine(table.TableName);
    Console.WriteLine("=========================");
    // Loop through all the rows in the table:
    foreach (DataRow row in table.Rows)
    {
        for (int i = 0; i < table.Columns.Count;
 i++)
        {
            Console.Write(row[i] + " ");
        }
        Console.WriteLine();
    }
}

private static DataTableReader GetReader()
{
    // Return a DataTableReader containing multiple
    // result sets, just for the sake of this demo.
    DataSet dataSet = new DataSet();
    dataSet.Tables.Add(GetCustomers());
    dataSet.Tables.Add(GetProducts());
    return dataSet.CreateDataReader();
}

この例では、コンソール ウィンドウに次の出力を表示します。

Customers
=========================
0 Mary
1 Andy
2 Peter

Products
=========================
0 Wireless Network Card
1 Hard Drive
2 Monitor
3 CPU
プラットフォームプラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.Load メソッド (IDataReader, LoadOption, FillErrorEventHandler, DataTable[])

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した IDataReader を使用するデータ ソースの値を DataSet に格納し、DataTable インスタンスの配列を使用してスキーマ情報と名前空間情報を指定します。

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

Visual Basic (宣言)
Public Overridable Sub Load
 ( _
    reader As IDataReader, _
    loadOption As LoadOption, _
    errorHandler As FillErrorEventHandler, _
    ParamArray tables As DataTable() _
)
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As IDataReader
Dim loadOption As LoadOption
Dim errorHandler As FillErrorEventHandler
Dim tables As DataTable()

instance.Load(reader, loadOption, errorHandler, tables)
C#
public virtual void Load (
    IDataReader reader,
    LoadOption loadOption,
    FillErrorEventHandler errorHandler,
    params DataTable[] tables
)
C++
public:
virtual void Load (
    IDataReader^ reader, 
    LoadOption loadOption, 
    FillErrorEventHandler^ errorHandler, 
    ... array<DataTable^>^ tables
)
J#
public void Load (
    IDataReader reader, 
    LoadOption loadOption, 
    FillErrorEventHandler errorHandler, 
    DataTable[] tables
)
JScript
public function Load (
    reader : IDataReader, 
    loadOption : LoadOption, 
    errorHandler : FillErrorEventHandler, 
    ... tables : DataTable[]
)

パラメータ

reader

1 つ以上の結果セットを含む IDataReader。

loadOption

LoadOption 列挙体の値。DataSet 内の DataTable インスタンスに既に含まれている行を同じ主キーを持つ受信した行と結合する方法を示します。

errorHandler

データの読み込み中にエラーが発生した場合に呼び出される FillErrorEventHandler デリゲート。

tables

Load メソッドが名前と名前空間の情報を取得する、DataTable インスタンスの配列。

解説解説

Load メソッドは、単一の DataTable に、IDataReader のインスタンスから取得したデータを挿入する手段を提供します。このメソッドは同じ機能を提供しますが、複数の結果セットを IDataReader から読み込んで、DataSet 内の複数のテーブルに格納します。

loadOption パラメータを使用して、既存のデータに対してデータをインポートする方法を指定できます。このパラメータには、LoadOption 列挙体の任意の値を設定できます。このパラメータの使用方法の詳細については、DataTableLoad メソッドに関するドキュメントを参照してください。

errorHandler パラメータは、データの読み込み中にエラーが発生した場合に呼び出されるプロシージャを参照する FillErrorEventHandler デリゲートです。プロシージャに FillErrorEventArgs パラメータを渡すことで得られるプロパティを使用して、発生したエラー、データの現在の行、入力先の DataTable に関する情報を取得できます。単純な try/catch ブロックを使用せず、このデリゲート機構を使用することで、エラーの特定と状況の処理を行い、さらに必要であれば処理を続行できます。FillErrorEventArgs パラメータには Continue プロパティがあります。エラーの処理後に処理を続行することを指定するには、このプロパティを true に設定します。処理を停止するには、このプロパティを false に設定します。このプロパティを false に設定すると、問題の原因となったコードによって例外がスローされるので注意してください。

tables パラメータを使用して DataTable インスタンスの配列を指定することで、リーダーによって読み込まれた結果セットにそれぞれ対応するテーブルの順序を指定できます。Load メソッドは、ソース データ リーダーから得た単一の結果セットのデータを指定した各 DataTable インスタンスに格納します。1 つの結果セットの操作が終わると、Load メソッドはリーダー内の次の結果セットを操作します。これをすべての結果セットについて行います。

このメソッドの名前解決スキームは、DbDataAdapter クラスの Fill メソッドで使用されるスキームと同じです。

使用例使用例

次に示す例では、テーブルを DataSet に追加した後、Load メソッドを使用して、互換性のないスキーマを含む DataTableReader からデータを読み込みます。この例ではエラーをトラップするのではなく、FillErrorEventHandler デリゲートを使用してエラーを調査し、処理します。

Visual Basic
Sub Main()
  Dim dataSet As New DataSet
  Dim table As New DataTable()

  ' Attempt to load data from a data reader in which
  ' the schema is incompatible with the current schema.
  ' If you use exception handling, you won't get the chance
  ' to examine each row, and each individual table,
  ' as the Load method progresses.
  ' By taking advantage of the FillErrorEventHandler delegate,
  ' you can interact with the Load process as an error occurs,
  ' attempting to fix the problem, or simply continuing or quitting
  ' the Load process.:
  dataSet = New DataSet()
  table = GetIntegerTable()
  dataSet.Tables.Add(table)
  Dim reader As New DataTableReader(GetStringTable())
  dataSet.Load(reader, LoadOption.OverwriteChanges, _
      AddressOf FillErrorHandler, table)

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Sub FillErrorHandler(ByVal
 sender As Object, _
  ByVal e As FillErrorEventArgs)
  ' You can use the e.Errors value to determine exactly what
  ' went wrong.
  If e.Errors.GetType Is GetType(System.FormatException)
 Then
    Console.WriteLine("Error when attempting to update the value:
 {0}", _
      e.Values(0))
  End If

  ' Setting e.Continue to True tells the Load
  ' method to continue trying. Setting it to False
  ' indicates that an error has occurred, and the 
  ' Load method raises the exception that got 
  ' you here.
  e.Continue = True
End Sub

Private Function GetIntegerTable() As
 DataTable
  ' Create sample table with a single Int32 column.
  Dim table As New DataTable

  Dim idColumn As DataColumn = table.Columns.Add("ID",
 _
      GetType(Integer))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {4})
  table.Rows.Add(New Object() {5})
  table.TableName = "IntegerTable"
  table.AcceptChanges()
  Return table
End Function

Private Function GetStringTable() As
 DataTable
  ' Create sample table with a single String column.
  Dim table As New DataTable

  Dim idColumn As DataColumn = table.Columns.Add("ID",
 _
      GetType(String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {"Mary"})
  table.Rows.Add(New Object() {"Andy"})
  table.Rows.Add(New Object() {"Peter"})
  table.AcceptChanges()
  Return table
End Function

Private Sub PrintColumns( _
   ByVal table As DataTable)

  ' Loop through all the rows in the DataTableReader.
  For Each row As DataRow
 In table.Rows
    For Each col As DataColumn
 In table.Columns
      Console.Write(row(col).ToString() & " ")
    Next
    Console.WriteLine()
  Next
End Sub
C#
static void Main()
{
    // Attempt to load data from a data reader in which
    // the schema is incompatible with the current schema.
    // If you use exception handling, you won't get the chance
    // to examine each row, and each individual table,
    // as the Load method progresses.
    // By taking advantage of the FillErrorEventHandler delegate,
    // you can interact with the Load process as an error occurs,
    // attempting to fix the problem, or simply continuing or quitting
    // the Load process.:
    DataSet dataSet = new DataSet();
    DataTable table = GetIntegerTable();
    dataSet.Tables.Add(table);
    DataTableReader reader = new DataTableReader(GetStringTable());
    dataSet.Load(reader, LoadOption.OverwriteChanges, 
        FillErrorHandler, table);

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetIntegerTable()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 4 });
    table.Rows.Add(new object[] { 5 });
    table.AcceptChanges();
    return table;
}

private static DataTable GetStringTable()
{
    // Create sample Customers table, in order
    // to demonstrate the behavior of the DataTableReader.
    DataTable table = new DataTable();

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(string));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { "Mary" });
    table.Rows.Add(new object[] { "Andy" });
    table.Rows.Add(new object[] { "Peter" });
    table.AcceptChanges();
    return table;
}

static void FillErrorHandler(object sender,
 FillErrorEventArgs e)
{
    // You can use the e.Errors value to determine exactly what
    // went wrong.
    if (e.Errors.GetType() == typeof(System.FormatException))
    {
        Console.WriteLine("Error when attempting to update the value: {0}",
 
            e.Values[0]);
    }

    // Setting e.Continue to True tells the Load
    // method to continue trying. Setting it to False
    // indicates that an error has occurred, and the 
    // Load method raises the exception that got 
    // you here.
    e.Continue = true;
}

この例では、コンソール ウィンドウに次の出力を表示します。

Error when attempting to update the value: Mary
Error when attempting to update the value: Andy
Error when attempting to update the value: Peter
プラットフォームプラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用
ADO.NET での DataSet の使用

DataSet.Load メソッド (IDataReader, LoadOption, String[])

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した IDataReader を使用するデータ ソースの値を DataSet に格納し、文字列の配列を使用して DataSet 内のテーブルの名前を指定します。

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

Visual Basic (宣言)
Public Sub Load ( _
    reader As IDataReader, _
    loadOption As LoadOption, _
    ParamArray tables As String()
 _
)
Visual Basic (使用法)
Dim instance As DataSet
Dim reader As IDataReader
Dim loadOption As LoadOption
Dim tables As String()

instance.Load(reader, loadOption, tables)
C#
public void Load (
    IDataReader reader,
    LoadOption loadOption,
    params string[] tables
)
C++
public:
void Load (
    IDataReader^ reader, 
    LoadOption loadOption, 
    ... array<String^>^ tables
)
J#
public void Load (
    IDataReader reader, 
    LoadOption loadOption, 
    String[] tables
)
JScript
public function Load (
    reader : IDataReader, 
    loadOption : LoadOption, 
    ... tables : String[]
)

パラメータ

reader

1 つ以上の結果セットを含む IDataReader。

loadOption

LoadOption 列挙体の値。DataSet 内の DataTable インスタンスに既に含まれている行を同じ主キーを持つ受信した行と結合する方法を示します。

tables

Load メソッドがテーブル名の情報を取得する、文字列の配列。

解説解説

Load メソッドは、単一の DataTable に、IDataReader のインスタンスから取得したデータを挿入する手段を提供します。このメソッドは同じ機能を提供しますが、複数の結果セットを IDataReader から読み込んで、DataSet 内の複数のテーブルに格納します。

loadOption パラメータを使用して、既存のデータに対してデータをインポートする方法を指定できます。このパラメータには、LoadOption 列挙体の任意の値を設定できます。このパラメータの使用方法の詳細については、Load メソッドに関するドキュメントを参照してください。

tables パラメータを使用してテーブル名の配列を指定することで、リーダーによって読み込まれた結果セットにそれぞれ対応するテーブルの順序を指定できます。Load メソッドは、テーブル名の配列に含まれている名前を順番に DataSet 内で検索し、一致するテーブルを探します。一致するテーブルが見つかると、そのテーブルに現在の結果セットの内容が読み込まれます。一致するテーブルが見つからない場合、テーブル名の配列で指定されている名前を使用してテーブルが作成されます。新しいテーブルのスキーマは、結果セットから推測されます。1 つの結果セットの操作が終わると、Load メソッドはリーダー内の次の結果セットを操作します。これをすべての結果セットについて行います。

DataSet に既定の名前空間が関連付けられている場合、新しく作成された DataTable にはその名前空間が関連付けられます。このメソッドの名前解決スキームは、DbDataAdapter クラスの Fill メソッドで使用されるスキームと同じです。

使用例使用例

次に示すコンソール アプリケーションの例では、最初にテーブルを作成し、Load メソッドを使用してリーダーのデータを DataSet に読み込みます。次に、DataSet にテーブルを追加し、そのテーブルに DataTableReader のデータを格納します。この例では、存在しないテーブルの名前を示すパラメータを Load メソッドに渡すため、パラメータとして渡された名前に一致する新しいテーブルが Load メソッドによって作成されます。データが読み込まれた後、すべてのテーブルの内容がコンソール ウィンドウに表示されます。

Visual Basic
Sub Main()
  Dim dataSet As New DataSet
  Dim table As DataTable

  Dim reader As DataTableReader = GetReader()

  ' The tables listed as parameters for the Load method 
  ' should be in the same order as the tables within the IDataReader.
  dataSet.Load(reader, LoadOption.Upsert, "Customers",
 "Products")
  For Each table In dataSet.Tables
    PrintColumns(table)
  Next

  ' Now try the example with the DataSet
  ' already filled with data:
  dataSet = New DataSet
  dataSet.Tables.Add(GetCustomers())
  dataSet.Tables.Add(GetProducts())

  ' Retrieve a data reader containing changed data:
  reader = GetReader()

  ' Load the data into the existing DataSet. Retrieve the order of the
  ' the data in the reader from the
  ' list of table names in the parameters. If you specify
  ' a new table name here, the Load method will create
  ' a corresponding new table.
  dataSet.Load(reader, LoadOption.Upsert, "NewCustomers",
 "Products")
  For Each table In dataSet.Tables
    PrintColumns(table)
  Next

  Console.WriteLine("Press any key to continue.")
  Console.ReadKey()
End Sub

Private Function GetCustomers() As
 DataTable
  ' Create sample Customers table.
  Dim table As New DataTable
  table.TableName = "Customers"

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID",
 GetType(Integer))
  table.Columns.Add("Name", GetType(String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {0, "Mary"})
  table.Rows.Add(New Object() {1, "Andy"})
  table.Rows.Add(New Object() {2, "Peter"})
  table.AcceptChanges()
  Return table
End Function

Private Function GetProducts() As
 DataTable
  ' Create sample Products table, in order
  ' to demonstrate the behavior of the DataTableReader.
  Dim table As New DataTable
  table.TableName = "Products"

  ' Create two columns, ID and Name.
  Dim idColumn As DataColumn = table.Columns.Add("ID",
 GetType(Integer))
  table.Columns.Add("Name", GetType(String))

  ' Set the ID column as the primary key column.
  table.PrimaryKey = New DataColumn() {idColumn}

  table.Rows.Add(New Object() {0, "Wireless
 Network Card"})
  table.Rows.Add(New Object() {1, "Hard
 Drive"})
  table.Rows.Add(New Object() {2, "Monitor"})
  table.Rows.Add(New Object() {3, "CPU"})
  Return table
End Function

Private Function GetReader() As
 DataTableReader
  ' Return a DataTableReader containing multiple
  ' result sets, just for the sake of this demo.
  Dim dataSet As New DataSet
  dataSet.Tables.Add(GetCustomers())
  dataSet.Tables.Add(GetProducts())
  Return dataSet.CreateDataReader()
End Function

Private Sub PrintColumns( _
   ByVal table As DataTable)

  Console.WriteLine()
  Console.WriteLine(table.TableName)
  Console.WriteLine("=========================")
  ' Loop through all the rows in the table.
  For Each row As DataRow
 In table.Rows
    For Each col As DataColumn
 In table.Columns
      Console.Write(row(col).ToString() & " ")
    Next
    Console.WriteLine()
  Next
End Sub
C#
static void Main()
{
    DataSet dataSet = new DataSet();

    DataTableReader reader = GetReader();

    // The tables listed as parameters for the Load method 
    // should be in the same order as the tables within the IDataReader.
    dataSet.Load(reader, LoadOption.Upsert, "Customers", "Products");
    foreach (DataTable table in dataSet.Tables)
    {
        PrintColumns(table);
    }

    // Now try the example with the DataSet
    // already filled with data:
    dataSet = new DataSet();
    dataSet.Tables.Add(GetCustomers());
    dataSet.Tables.Add(GetProducts());

    // Retrieve a data reader containing changed data:
    reader = GetReader();

    // Load the data into the existing DataSet. Retrieve the order of
 the
    // the data in the reader from the
    // list of table names in the parameters. If you specify
    // a new table name here, the Load method will create
    // a corresponding new table.
    dataSet.Load(reader, LoadOption.Upsert, 
        "NewCustomers", "Products");
    foreach (DataTable table in dataSet.Tables)
    {
        PrintColumns(table);
    }

    Console.WriteLine("Press any key to continue.");
    Console.ReadKey();
}

private static DataTable GetCustomers()
{
    // Create sample Customers table.
    DataTable table = new DataTable();
    table.TableName = "Customers";

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));
    table.Columns.Add("Name", typeof(string));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 0, "Mary" });
    table.Rows.Add(new object[] { 1, "Andy" });
    table.Rows.Add(new object[] { 2, "Peter" });
    table.AcceptChanges();
    return table;
}

private static DataTable GetProducts()
{
    // Create sample Products table.
    DataTable table = new DataTable();
    table.TableName = "Products";

    // Create two columns, ID and Name.
    DataColumn idColumn = table.Columns.Add("ID", typeof(int));
    table.Columns.Add("Name", typeof(string));

    // Set the ID column as the primary key column.
    table.PrimaryKey = new DataColumn[] { idColumn };

    table.Rows.Add(new object[] { 0, "Wireless Network Card"
 });
    table.Rows.Add(new object[] { 1, "Hard Drive" });
    table.Rows.Add(new object[] { 2, "Monitor" });
    table.Rows.Add(new object[] { 3, "CPU" });
    table.AcceptChanges();
    return table;
}

private static void PrintColumns(DataTable
 table)
{
    Console.WriteLine();
    Console.WriteLine(table.TableName);
    Console.WriteLine("=========================");
    // Loop through all the rows in the table:
    foreach (DataRow row in table.Rows)
    {
        for (int i = 0; i < table.Columns.Count;
 i++)
        {
            Console.Write(row[i] + " ");
        }
        Console.WriteLine();
    }
}

private static DataTableReader GetReader()
{
    // Return a DataTableReader containing multiple
    // result sets, just for the sake of this demo.
    DataSet dataSet = new DataSet();
    dataSet.Tables.Add(GetCustomers());
    dataSet.Tables.Add(GetProducts());
    return dataSet.CreateDataReader();
}

この例では、コンソール ウィンドウに次のテキストが表示されます。

Customers
=========================
0 Mary
1 Andy
2 Peter

Products
=========================
0 Wireless Network Card
1 Hard Drive
2 Monitor
3 CPU

Customers
=========================
0 Mary
1 Andy
2 Peter

Products
=========================
0 Wireless Network Card
1 Hard Drive
2 Monitor
3 CPU

NewCustomers
=========================
0 Mary
1 Andy
2 Peter
プラットフォームプラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
DataSet クラス
DataSet メンバ
System.Data 名前空間
その他の技術情報
ADO.NET での DataSet の使用

DataSet.Load メソッド

指定された IDataReader を使用し、DataSet にデータ ソースからの値を設定します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
DataSet.Load (IDataReader, LoadOption, DataTable[]) 指定した IDataReader を使用するデータ ソースの値を DataSet に格納し、DataTable インスタンスの配列を使用してスキーマ情報と名前空間情報を指定します。

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

DataSet.Load (IDataReader, LoadOption, String[]) 指定した IDataReader を使用するデータ ソースの値を DataSet に格納し、文字列の配列を使用して DataSet 内のテーブルの名前を指定します。

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

DataSet.Load (IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) 指定した IDataReader を使用するデータ ソースの値を DataSet に格納し、DataTable インスタンスの配列を使用してスキーマ情報と名前空間情報を指定します。

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

参照参照

関連項目

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

その他の技術情報

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

急上昇のことば

四宮ありす
救出
たまゆら
倫理観
残塁
このページでは「.NET Framework クラス ライブラリ リファレンス」からDataSet.Loadを検索した結果を表示しています。
Weblioに収録されているすべての辞書からDataSet.Loadを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からDataSet.Load を検索
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

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

Weblioのサービス

「DataSet.Load」の関連用語

1
DataSet.Load メソッド
.NET Framework クラス ライブラリ リファレンス
70% |||||

2
BindingSource.ResetBindings メソッド
.NET Framework クラス ライブラリ リファレンス
10% |||||

DataSet.Loadのお隣キーワード

DataSet.HasErrors プロパティ

DataSet.InferXmlSchema メソッド

DataSet.InitializeDerivedDataSet メソッド

DataSet.Initialized イベント

DataSet.IsBinarySerialized メソッド

DataSet.IsInitialized プロパティ

DataSet.Load

DataSet.Load メソッド

DataSet.Locale プロパティ

DataSet.Merge メソッド

DataSet.MergeFailed イベント

DataSet.Namespace プロパティ

DataSet.OnPropertyChanging メソッド

検索ランキング

   

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


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

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

©2025 GRAS Group, Inc.RSS