DataSet Kelas

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

Sumber:

DataSet.cs

Mewakili cache data dalam memori.

public ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::ComponentModel::ISupportInitializeNotification, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable

public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable

type DataSet = class
    inherit MarshalByValueComponent
    interface IListSource
    interface ISupportInitialize
    interface ISupportInitializeNotification
    interface ISerializable
    interface IXmlSerializable

Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, ISupportInitializeNotification, IXmlSerializable

Warisan

Object

MarshalByValueComponent

DataSet

Penerapan

IListSource ISupportInitialize ISupportInitializeNotification ISerializable IXmlSerializable

Contoh

Contoh berikut terdiri dari beberapa metode yang, digabungkan, dibuat, dan diisi DataSet dari database Northwind .

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

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk Himpunan Data.

Konstruktor

DataSet()	Menginisialisasi instans baru kelas DataSet.
DataSet(SerializationInfo, StreamingContext)	Kedaluwarsa. Menginisialisasi instans DataSet baru kelas dengan data berseri.
DataSet(SerializationInfo, StreamingContext, Boolean)	Kedaluwarsa. Menginisialisasi instans DataSet baru kelas dengan data berseri.
DataSet(String)	Menginisialisasi instans DataSet baru kelas dengan nama yang diberikan.

Properti

CaseSensitive	Mendapatkan atau menetapkan nilai yang menunjukkan apakah perbandingan string dalam DataTable objek peka huruf besar/kecil.
Container	Mendapatkan kontainer untuk komponen. (Diperoleh dari MarshalByValueComponent)
DataSetName	Mendapatkan atau mengatur nama saat ini DataSet.
DefaultViewManager	Mendapatkan tampilan kustom data yang terkandung dalam DataSet untuk memungkinkan pemfilteran, pencarian, dan navigasi menggunakan kustom DataViewManager.
DesignMode	Mendapatkan nilai yang menunjukkan apakah komponen saat ini dalam mode desain. (Diperoleh dari MarshalByValueComponent)
EnforceConstraints	Mendapatkan atau menetapkan nilai yang menunjukkan apakah aturan batasan diikuti saat mencoba operasi pembaruan apa pun.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke komponen ini. (Diperoleh dari MarshalByValueComponent)
ExtendedProperties	Mendapatkan kumpulan informasi pengguna yang disesuaikan yang terkait dengan DataSet.
HasErrors	Mendapatkan nilai yang menunjukkan apakah ada kesalahan di salah DataTable satu objek dalam ini DataSet.
IsInitialized	Mendapatkan nilai yang menunjukkan apakah diinisialisasi DataSet .
Locale	Mendapatkan atau mengatur informasi lokal yang digunakan untuk membandingkan string dalam tabel.
Namespace	Mendapatkan atau mengatur namespace DataSetlayanan .
Prefix	Mendapatkan atau mengatur awalan XML yang alias namespace DataSetlayanan .
Relations	Mendapatkan kumpulan relasi yang menautkan tabel dan mengizinkan navigasi dari tabel induk ke tabel anak.
RemotingFormat	Mendapatkan atau mengatur format serialisasi untuk DataSet yang digunakan selama jarak jauh.
SchemaSerializationMode	Mendapatkan atau mengatur SchemaSerializationMode untuk DataSet.
Site	Mendapatkan atau mengatur ISite untuk DataSet.
Tables	Mendapatkan kumpulan tabel yang terkandung dalam DataSet.

Metode

AcceptChanges()	Menerapkan semua perubahan yang dilakukan pada ini DataSet sejak dimuat atau sejak terakhir kali AcceptChanges() dipanggil.
BeginInit()	Memulai inisialisasi DataSet yang digunakan pada formulir atau digunakan oleh komponen lain. Inisialisasi terjadi pada durasi.
Clear()	DataSet Menghapus data apa pun dengan menghapus semua baris di semua tabel.
Clone()	Menyalin struktur DataSet, termasuk semua DataTable skema, hubungan, dan batasan. Tidak menyalin data apa pun.
Copy()	Menyalin struktur dan data untuk ini DataSet.
CreateDataReader()	Mengembalikan DataTableReader dengan satu tataan hasil per DataTable, dalam urutan yang sama seperti tabel yang muncul dalam Tables koleksi.
CreateDataReader(DataTable[])	Mengembalikan DataTableReader dengan satu tataan hasil per DataTable.
DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)	SchemaSerializationMode Menentukan untuk DataSet.
DetermineSchemaSerializationMode(XmlReader)	SchemaSerializationMode Menentukan untuk DataSet.
Dispose()	Merilis semua sumber daya yang MarshalByValueComponentdigunakan oleh . (Diperoleh dari MarshalByValueComponent)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh MarshalByValueComponent dan secara opsional merilis sumber daya terkelola. (Diperoleh dari MarshalByValueComponent)
EndInit()	Mengakhiri inisialisasi DataSet yang digunakan pada formulir atau digunakan oleh komponen lain. Inisialisasi terjadi pada durasi.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetChanges()	Mendapatkan salinan DataSet yang berisi semua perubahan yang dilakukan padanya sejak dimuat atau sejak AcceptChanges() terakhir dipanggil.
GetChanges(DataRowState)	Mendapatkan salinan yang DataSet berisi semua perubahan yang dilakukan padanya sejak terakhir kali dimuat, atau sejak AcceptChanges() dipanggil, difilter oleh DataRowState.
GetDataSetSchema(XmlSchemaSet)	Mendapatkan salinan untuk Himpunan XmlSchemaSet Data.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. Mengisi objek informasi serialisasi dengan data yang diperlukan untuk membuat serialisasi DataSet.
GetSchemaSerializable()	Mengembalikan instans yang dapat diserialisasikan XmlSchema .
GetSerializationData(SerializationInfo, StreamingContext)	Mendeserialisasi data tabel dari aliran biner atau XML.
GetService(Type)	Mendapatkan pelaksana IServiceProvider. (Diperoleh dari MarshalByValueComponent)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetXml()	Mengembalikan representasi XML dari data yang disimpan di DataSet.
GetXmlSchema()	Mengembalikan Skema XML untuk representasi XML dari data yang disimpan di DataSet.
HasChanges()	Mendapatkan nilai yang menunjukkan apakah DataSet memiliki perubahan, termasuk baris baru, dihapus, atau dimodifikasi.
HasChanges(DataRowState)	Mendapatkan nilai yang menunjukkan apakah DataSet memiliki perubahan, termasuk baris baru, dihapus, atau diubah, difilter oleh DataRowState.
InferXmlSchema(Stream, String[])	Menerapkan skema XML dari yang ditentukan Stream ke DataSet.
InferXmlSchema(String, String[])	Menerapkan skema XML dari file yang ditentukan ke DataSet.
InferXmlSchema(TextReader, String[])	Menerapkan skema XML dari yang ditentukan TextReader ke DataSet.
InferXmlSchema(XmlReader, String[])	Menerapkan skema XML dari yang ditentukan XmlReader ke DataSet.
InitializeDerivedDataSet()	Deserialisasi semua data tabel Himpunan Data dari aliran biner atau XML.
IsBinarySerialized(SerializationInfo, StreamingContext)	Memeriksa format representasi serial dari DataSet.
Load(IDataReader, LoadOption, DataTable[])	DataSet Mengisi dengan nilai dari sumber data menggunakan yang disediakan IDataReader, menggunakan array DataTable instans untuk menyediakan informasi skema dan namespace.
Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])	DataSet Mengisi dengan nilai dari sumber data menggunakan yang disediakan IDataReader, menggunakan array DataTable instans untuk menyediakan informasi skema dan namespace.
Load(IDataReader, LoadOption, String[])	DataSet Mengisi dengan nilai dari sumber data menggunakan yang disediakan IDataReader, menggunakan array string untuk menyediakan nama untuk tabel dalam DataSet.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Merge(DataRow[])	Menggabungkan array DataRow objek ke dalam saat ini DataSet.
Merge(DataRow[], Boolean, MissingSchemaAction)	Menggabungkan array DataRow objek ke dalam saat ini DataSet, mempertahankan atau membuang perubahan dalam DataSet dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.
Merge(DataSet)	Menggabungkan skema yang ditentukan DataSet dan skemanya ke dalam .DataSet
Merge(DataSet, Boolean)	Menggabungkan skema yang ditentukan DataSet dan skemanya ke dalam saat ini DataSet, mempertahankan atau membuang perubahan apa pun dalam ini DataSet sesuai dengan argumen yang diberikan.
Merge(DataSet, Boolean, MissingSchemaAction)	Menggabungkan skema yang ditentukan DataSet dan skemanya dengan saat ini DataSet, mempertahankan atau membuang perubahan dalam saat ini DataSet dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.
Merge(DataTable)	Menggabungkan skema yang ditentukan DataTable dan skemanya ke dalam .DataSet
Merge(DataTable, Boolean, MissingSchemaAction)	Menggabungkan skema yang ditentukan DataTable dan skemanya ke dalam saat ini DataSet, mempertahankan atau membuang perubahan dalam DataSet dan menangani skema yang tidak kompatibel sesuai dengan argumen yang diberikan.
OnPropertyChanging(PropertyChangedEventArgs)	Memunculkan kejadian OnPropertyChanging(PropertyChangedEventArgs).
OnRemoveRelation(DataRelation)	Terjadi ketika DataRelation objek dihapus dari DataTable.
OnRemoveTable(DataTable)	Terjadi ketika DataTable dihapus dari DataSet.
RaisePropertyChanging(String)	Mengirim pemberitahuan bahwa properti yang ditentukan DataSet akan berubah.
ReadXml(Stream)	Membaca skema dan data XML ke DataSet dalam menggunakan yang ditentukan Stream.
ReadXml(Stream, XmlReadMode)	Membaca skema dan data XML ke DataSet dalam menggunakan dan XmlReadModeyang ditentukanStream.
ReadXml(String)	Membaca skema XML dan data ke DataSet dalam menggunakan file yang ditentukan.
ReadXml(String, XmlReadMode)	Membaca skema XML dan data ke DataSet dalam menggunakan file yang ditentukan dan XmlReadMode.
ReadXml(TextReader)	Membaca skema dan data XML ke DataSet dalam menggunakan yang ditentukan TextReader.
ReadXml(TextReader, XmlReadMode)	Membaca skema dan data XML ke DataSet dalam menggunakan dan XmlReadModeyang ditentukanTextReader.
ReadXml(XmlReader)	Membaca skema dan data XML ke DataSet dalam menggunakan yang ditentukan XmlReader.
ReadXml(XmlReader, XmlReadMode)	Membaca skema dan data XML ke DataSet dalam menggunakan dan XmlReadModeyang ditentukanXmlReader.
ReadXmlSchema(Stream)	Membaca skema XML dari yang ditentukan Stream ke DataSetdalam .
ReadXmlSchema(String)	Membaca skema XML dari file yang ditentukan ke DataSetdalam .
ReadXmlSchema(TextReader)	Membaca skema XML dari yang ditentukan TextReader ke DataSetdalam .
ReadXmlSchema(XmlReader)	Membaca skema XML dari yang ditentukan XmlReader ke DataSetdalam .
ReadXmlSerializable(XmlReader)	Mengabaikan atribut dan mengembalikan Himpunan Data kosong.
RejectChanges()	Mengembalikan semua perubahan yang dilakukan DataSet pada sejak dibuat, atau sejak terakhir kali AcceptChanges() dipanggil.
Reset()	Menghapus semua tabel dan menghapus semua hubungan, batasan asing, dan tabel dari DataSet. Subkelas harus mengambil Reset() alih untuk memulihkan DataSet ke keadaan semula.
ShouldSerializeRelations()	Mendapatkan nilai yang menunjukkan apakah Relations properti harus dipertahankan.
ShouldSerializeTables()	Mendapatkan nilai yang menunjukkan apakah Tables properti harus dipertahankan.
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari MarshalByValueComponent)
WriteXml(Stream)	Menulis data saat ini untuk DataSet menggunakan yang ditentukan Stream.
WriteXml(Stream, XmlWriteMode)	Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan Stream dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(String)	Menulis data saat ini untuk ke DataSet file yang ditentukan.
WriteXml(String, XmlWriteMode)	Menulis data saat ini, dan secara opsional skema, untuk DataSet ke file yang ditentukan menggunakan yang ditentukan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(TextWriter)	Menulis data saat ini untuk DataSet menggunakan yang ditentukan TextWriter.
WriteXml(TextWriter, XmlWriteMode)	Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan TextWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXml(XmlWriter)	Menulis data saat ini untuk DataSet ke yang ditentukan XmlWriter.
WriteXml(XmlWriter, XmlWriteMode)	Menulis data saat ini, dan secara opsional skema, untuk DataSet menggunakan yang ditentukan XmlWriter dan XmlWriteMode. Untuk menulis skema, atur nilai untuk parameter ke modeWriteSchema.
WriteXmlSchema(Stream)	DataSet Menulis struktur sebagai skema XML ke objek yang ditentukanStream.
WriteXmlSchema(Stream, Converter<Type,String>)	DataSet Menulis struktur sebagai skema XML ke objek yang ditentukanStream.
WriteXmlSchema(String)	DataSet Menulis struktur sebagai skema XML ke file.
WriteXmlSchema(String, Converter<Type,String>)	DataSet Menulis struktur sebagai skema XML ke file.
WriteXmlSchema(TextWriter)	DataSet Menulis struktur sebagai skema XML ke objek yang ditentukanTextWriter.
WriteXmlSchema(TextWriter, Converter<Type,String>)	DataSet Menulis struktur sebagai skema XML ke yang ditentukanTextWriter.
WriteXmlSchema(XmlWriter)	DataSet Menulis struktur sebagai skema XML ke XmlWriter objek.
WriteXmlSchema(XmlWriter, Converter<Type,String>)	DataSet Menulis struktur sebagai skema XML ke yang ditentukanXmlWriter.

Acara

Disposed	Menambahkan penanganan aktivitas untuk mendengarkan Disposed peristiwa pada komponen. (Diperoleh dari MarshalByValueComponent)
Initialized	Terjadi setelah diinisialisasi DataSet .
MergeFailed	Terjadi ketika target dan sumber DataRow memiliki nilai kunci primer yang sama, dan EnforceConstraints diatur ke true.

Implementasi Antarmuka Eksplisit

IListSource.ContainsListCollection	Untuk deskripsi anggota ini, lihat ContainsListCollection.
IListSource.GetList()	Untuk deskripsi anggota ini, lihat GetList().
IXmlSerializable.GetSchema()	Untuk deskripsi anggota ini, lihat GetSchema().
IXmlSerializable.ReadXml(XmlReader)	Untuk deskripsi anggota ini, lihat ReadXml(XmlReader).
IXmlSerializable.WriteXml(XmlWriter)	Untuk deskripsi anggota ini, lihat WriteXml(XmlWriter).

Metode Ekstensi

GetKeyedService<T>(IServiceProvider, Object)	Mendapatkan layanan jenis T dari IServiceProvider.
GetKeyedServices(IServiceProvider, Type, Object)	Mendapatkan enumerasi layanan jenis serviceType dari IServiceProvider.
GetKeyedServices<T>(IServiceProvider, Object)	Mendapatkan enumerasi layanan jenis T dari IServiceProvider.
GetRequiredKeyedService(IServiceProvider, Type, Object)	Mendapatkan layanan jenis serviceType dari IServiceProvider.
GetRequiredKeyedService<T>(IServiceProvider, Object)	Mendapatkan layanan jenis T dari IServiceProvider.
CreateAsyncScope(IServiceProvider)	Membuat baru AsyncServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.
CreateScope(IServiceProvider)	Membuat baru IServiceScope yang dapat digunakan untuk mengatasi layanan terlingkup.
GetRequiredService(IServiceProvider, Type)	Dapatkan layanan jenis serviceType dari IServiceProvider.
GetRequiredService<T>(IServiceProvider)	Dapatkan layanan jenis T dari IServiceProvider.
GetService<T>(IServiceProvider)	Dapatkan layanan jenis T dari IServiceProvider.
GetServices(IServiceProvider, Type)	Dapatkan enumerasi layanan jenis serviceType dari IServiceProvider.
GetServices<T>(IServiceProvider)	Dapatkan enumerasi layanan jenis T dari IServiceProvider.
GetFakeLogCollector(IServiceProvider)	Mendapatkan objek yang mengumpulkan rekaman log yang dikirim ke pencatat palsu.
GetFakeRedactionCollector(IServiceProvider)	Mendapatkan instans pengumpul redactor palsu dari kontainer injeksi dependensi.

Keamanan Thread

Jenis ini aman untuk operasi baca multithreaded. Anda harus menyinkronkan operasi tulis apa pun.

Lihat juga

• Menggunakan Himpunan Data di ADO.NET