DataSet クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データのメモリ内キャッシュを表します。
public ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializablepublic ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable[System.Serializable]
public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable[System.Serializable]
public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializablepublic class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable[<System.Serializable>]
type DataSet = class
inherit MarshalByValueComponent
interface IListSource
interface IXmlSerializable
interface ISupportInitialize
interface ISerializable[<System.Serializable>]
type DataSet = class
inherit MarshalByValueComponent
interface IListSource
interface IXmlSerializable
interface ISupportInitializeNotification
interface ISupportInitialize
interface ISerializabletype DataSet = class
inherit MarshalByValueComponent
interface IListSource
interface ISupportInitialize
interface ISupportInitializeNotification
interface ISerializable
interface IXmlSerializablePublic Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, IXmlSerializablePublic Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable- 継承
- 属性
- 実装
例
次の例は、Northwind データベースからDataSetを組み合わせ、作成して塗りつぶすいくつかのメソッドで構成されています。
using System;
using System.Data;
using System.Data.SqlClient;
namespace Microsoft.AdoNet.DataSetDemo
{
class NorthwindDataSet
{
static void Main()
{
string connectionString = GetConnectionString();
ConnectToData(connectionString);
}
private static void ConnectToData(string connectionString)
{
//Create a SqlConnection to the Northwind database.
using (SqlConnection connection =
new SqlConnection(connectionString))
{
//Create a SqlDataAdapter for the Suppliers table.
SqlDataAdapter adapter = new SqlDataAdapter();
// A table mapping names the DataTable.
adapter.TableMappings.Add("Table", "Suppliers");
// Open the connection.
connection.Open();
Console.WriteLine("The SqlConnection is open.");
// Create a SqlCommand to retrieve Suppliers data.
SqlCommand command = new SqlCommand(
"SELECT SupplierID, CompanyName FROM dbo.Suppliers;",
connection);
command.CommandType = CommandType.Text;
// Set the SqlDataAdapter's SelectCommand.
adapter.SelectCommand = command;
// Fill the DataSet.
DataSet dataSet = new DataSet("Suppliers");
adapter.Fill(dataSet);
// Create a second Adapter and Command to get
// the Products table, a child table of Suppliers.
SqlDataAdapter productsAdapter = new SqlDataAdapter();
productsAdapter.TableMappings.Add("Table", "Products");
SqlCommand productsCommand = new SqlCommand(
"SELECT ProductID, SupplierID FROM dbo.Products;",
connection);
productsAdapter.SelectCommand = productsCommand;
// Fill the DataSet.
productsAdapter.Fill(dataSet);
// Close the connection.
connection.Close();
Console.WriteLine("The SqlConnection is closed.");
// Create a DataRelation to link the two tables
// based on the SupplierID.
DataColumn parentColumn =
dataSet.Tables["Suppliers"].Columns["SupplierID"];
DataColumn childColumn =
dataSet.Tables["Products"].Columns["SupplierID"];
DataRelation relation =
new System.Data.DataRelation("SuppliersProducts",
parentColumn, childColumn);
dataSet.Relations.Add(relation);
Console.WriteLine(
"The {0} DataRelation has been created.",
relation.RelationName);
}
}
static private string GetConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file.
return "Data Source=(local);Initial Catalog=Northwind;"
+ "Integrated Security=SSPI";
}
}
}
Option Explicit On
Option Strict On
Imports System.Data
Imports system.Data.SqlClient
Public Class NorthwindDataSet
Public Shared Sub Main()
Dim connectionString As String = _
GetConnectionString()
ConnectToData(connectionString)
End Sub
Private Shared Sub ConnectToData( _
ByVal connectionString As String)
' Create a SqlConnection to the Northwind database.
Using connection As SqlConnection = New SqlConnection( _
connectionString)
' Create a SqlDataAdapter for the Suppliers table.
Dim suppliersAdapter As SqlDataAdapter = _
New SqlDataAdapter()
' A table mapping names the DataTable.
suppliersAdapter.TableMappings.Add("Table", "Suppliers")
' Open the connection.
connection.Open()
Console.WriteLine("The SqlConnection is open.")
' Create a SqlCommand to retrieve Suppliers data.
Dim suppliersCommand As New SqlCommand( _
"SELECT SupplierID, CompanyName FROM dbo.Suppliers;", _
connection)
suppliersCommand.CommandType = CommandType.Text
' Set the SqlDataAdapter's SelectCommand.
suppliersAdapter.SelectCommand = suppliersCommand
' Fill the DataSet.
Dim dataSet As New DataSet("Suppliers")
suppliersAdapter.Fill(dataSet)
' Create a second SqlDataAdapter and SqlCommand to get
' the Products table, a child table of Suppliers.
Dim productsAdapter As New SqlDataAdapter()
productsAdapter.TableMappings.Add("Table", "Products")
Dim productsCommand As New SqlCommand( _
"SELECT ProductID, SupplierID FROM dbo.Products;", _
connection)
productsAdapter.SelectCommand = productsCommand
' Fill the DataSet.
productsAdapter.Fill(dataSet)
' Close the connection.
connection.Close()
Console.WriteLine("The SqlConnection is closed.")
' Create a DataRelation to link the two tables
' based on the SupplierID.
Dim parentColumn As DataColumn = _
dataSet.Tables("Suppliers").Columns("SupplierID")
Dim childColumn As DataColumn = _
dataSet.Tables("Products").Columns("SupplierID")
Dim relation As New DataRelation("SuppliersProducts", _
parentColumn, childColumn)
dataSet.Relations.Add(relation)
Console.WriteLine( _
"The {0} DataRelation has been created.", _
relation.RelationName)
End Using
End Sub
Private Shared Function GetConnectionString() As String
' To avoid storing the connection string in your code,
' you can retrieve it from a configuration file.
Return "Data Source=(local);Initial Catalog=Northwind;" _
& "Integrated Security=SSPI;"
End Function
End Class
注釈
この API の詳細については、「 DataSet の補足 API 解説」を参照してください。
コンストラクター
| 名前 | 説明 |
|---|---|
| DataSet() |
DataSet クラスの新しいインスタンスを初期化します。 |
| DataSet(SerializationInfo, StreamingContext, Boolean) |
シリアル化されたデータを使用して、 DataSet クラスの新しいインスタンスを初期化します。 |
| DataSet(SerializationInfo, StreamingContext) |
シリアル化されたデータを使用して、 DataSet クラスの新しいインスタンスを初期化します。 |
| DataSet(String) |
指定した名前を使用して、 DataSet クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| CaseSensitive |
DataTable オブジェクト内の文字列比較で大文字と小文字が区別されるかどうかを示す値を取得または設定します。 |
| Container |
コンポーネントのコンテナーを取得します。 (継承元 MarshalByValueComponent) |
| DataSetName |
現在の DataSetの名前を取得または設定します。 |
| DefaultViewManager |
カスタム DataSetを使用してフィルター処理、検索、および移動できるように、DataViewManagerに含まれるデータのカスタム ビューを取得します。 |
| DesignMode |
コンポーネントが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 MarshalByValueComponent) |
| EnforceConstraints |
更新操作を試行するときに制約規則に従うかどうかを示す値を取得または設定します。 |
| Events |
このコンポーネントにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 MarshalByValueComponent) |
| ExtendedProperties |
|
| HasErrors | |
| IsInitialized |
DataSetが初期化されているかどうかを示す値を取得します。 |
| Locale |
テーブル内の文字列を比較するために使用するロケール情報を取得または設定します。 |
| Namespace |
DataSetの名前空間を取得または設定します。 |
| Prefix |
DataSetの名前空間にエイリアスを設定する XML プレフィックスを取得または設定します。 |
| Relations |
テーブルをリンクし、親テーブルから子テーブルへのナビゲーションを許可するリレーションのコレクションを取得します。 |
| RemotingFormat |
リモート処理中に使用される DataSet のシリアル化形式を取得または設定します。 |
| SchemaSerializationMode |
SchemaSerializationModeのDataSetを取得または設定します。 |
| Site | |
| Tables |
DataSetに含まれるテーブルのコレクションを取得します。 |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| Disposed |
コンポーネントの Disposed イベントをリッスンするイベント ハンドラーを追加します。 (継承元 MarshalByValueComponent) |
| Initialized |
DataSetが初期化された後に発生します。 |
| MergeFailed |
ターゲットとソースの DataRow が同じ主キー値を持ち、 EnforceConstraints が true に設定されている場合に発生します。 |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IListSource.ContainsListCollection |
このメンバーの説明については、 ContainsListCollectionを参照してください。 |
| IListSource.GetList() |
このメンバーの説明については、 GetList()を参照してください。 |
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
シリアル化情報オブジェクトに、 DataSetをシリアル化するために必要なデータを設定します。 |
| IXmlSerializable.GetSchema() |
このメンバーの説明については、 GetSchema()を参照してください。 |
| IXmlSerializable.ReadXml(XmlReader) |
このメンバーの説明については、 ReadXml(XmlReader)を参照してください。 |
| IXmlSerializable.WriteXml(XmlWriter) |
このメンバーの説明については、 WriteXml(XmlWriter)を参照してください。 |
適用対象
スレッド セーフ
この型は、マルチスレッド読み取り操作に安全です。 すべての書き込み操作を同期する必要があります。