DataSet クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データのメモリ内キャッシュを表します。
public ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializablepublic 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::IXmlSerializablepublic class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, 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.IXmlSerializabletype DataSet = class
inherit MarshalByValueComponent
interface IListSource
interface ISupportInitialize
interface ISupportInitializeNotification
interface ISerializable
interface 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 ISerializable[<System.Serializable>]
type DataSet = class
inherit MarshalByValueComponent
interface IListSource
interface IXmlSerializable
interface ISupportInitializeNotification
interface ISerializable
interface ISupportInitializePublic Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, ISupportInitializeNotification, IXmlSerializablePublic Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, IXmlSerializablePublic Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable- 継承
- 属性
- 実装
例
次の例は、Northwind データベースから a 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
注釈
これは DataSet、データ ソースから取得されたデータのメモリ内キャッシュであり、ADO.NET アーキテクチャの主要なコンポーネントです。 このオブジェクトは DataSet 、オブジェクトと相互に関連付けることができるオブジェクトの DataTable コレクションで DataRelation 構成されます。 およびオブジェクトを使用して、データ整合性を DataSet UniqueConstraint ForeignKeyConstraint 適用することもできます。 オブジェクトの DataSet 操作の詳細については、「 DataSets、DataTables、DataViews」を参照してください。
オブジェクトにはデータが含まれているのにDataRelationCollection対DataTableし、テーブル階層を使用して移動できます。 テーブルは、プロパティを DataTableCollection 介してアクセスされるテーブルに Tables 含まれています。 オブジェクトにアクセスするときは DataTable 、条件付きで大文字と小文字が区別されることに注意してください。 たとえば、1 つが DataTable "mydatatable" という名前で、もう 1 つが "Mydatatable" という名前の場合、テーブルの 1 つを検索するために使用される文字列は大文字と小文字が区別されます。 ただし、"mydatatable" が存在し、"Mydatatable" が存在しない場合、検索文字列は大文字と小文字を区別しないと見なされます。 オブジェクトの DataTable 操作の詳細については、「 DataTable の作成」を参照してください。
A DataSet は、データとスキーマを XML ドキュメントとして読み書きできます。 その後、データとスキーマを HTTP 経由で転送し、XML 対応の任意のプラットフォーム上の任意のアプリケーションで使用できます。 スキーマはメソッドを使用 WriteXmlSchema して XML スキーマとして保存でき、スキーマとデータの両方をメソッドを WriteXml 使用して保存できます。 スキーマとデータの両方を含む XML ドキュメントを読み取る場合は、メソッドを使用します ReadXml 。
一般的な複数層の実装では、元のデータを作成して更新 DataSetする手順は次のとおりです。
を使用して、データ ソースのデータを作成してDataAdapter入力します。DataTable DataSet
オブジェクトを追加、更新、または削除して、個々 DataTable のオブジェクトのデータを DataRow 変更します。
メソッドを GetChanges 呼び出して、データの変更のみを特徴とする秒 DataSet を作成します。
Update引数として 2 つ目DataSetをDataAdapter渡す、のメソッドを呼び出します。
を呼び出しますAcceptChangesDataSet。 または、呼び出 RejectChanges して変更を取り消します。
注意
オブジェクトはDataSetDataTableリモート処理のインターフェイスをMarshalByValueComponent継承し、サポートISerializableします。 これらは、リモート処理ができる唯一の ADO.NET オブジェクトです。
注意
ファイナライザーが抑制されているため、継承された DataSet クラスは DataSetガベージ コレクターによって終了されません。 派生クラスは、コンストラクター内のメソッドを ReRegisterForFinalize 呼び出して、ガベージ コレクターによってクラスを終了させることができます。
セキュリティの考慮事項
DataSet と DataTable のセキュリティの詳細については、 セキュリティ ガイダンスを参照してください。
コンストラクター
| DataSet() |
DataSet クラスの新しいインスタンスを初期化します。 |
| DataSet(SerializationInfo, StreamingContext) |
シリアル化したデータを使用して、DataSet クラスの新しいインスタンスを初期化します。 |
| DataSet(SerializationInfo, StreamingContext, Boolean) |
シリアル化したデータを使用して、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 に格納されているテーブルのコレクションを取得します。 |
メソッド
events
| 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)」をご覧ください。 |
適用対象
スレッド セーフ
この型は、マルチスレッド読み取り操作では安全です。 すべての書き込み操作を同期する必要があります。