DataSet Klasa

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Źródło:

DataSet.cs

Reprezentuje pamięć podręczną danych w pamięci.

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

Dziedziczenie

Object

MarshalByValueComponent

DataSet

Implementuje

IListSource ISupportInitialize ISupportInitializeNotification ISerializable IXmlSerializable

Przykłady

Poniższy przykład składa się z kilku metod, które w połączeniu tworzą i wypełniają dane DataSet z bazy danych 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

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz dodatkowe uwagi dotyczące interfejsu API dla zestawu danych.

Konstruktory

DataSet()	Inicjuje nowe wystąpienie klasy DataSet.
DataSet(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje nowe wystąpienie klasy DataSet z zserializowanymi danymi.
DataSet(SerializationInfo, StreamingContext, Boolean)	Przestarzałe. Inicjuje nowe wystąpienie klasy DataSet z zserializowanymi danymi.
DataSet(String)	Inicjuje DataSet nowe wystąpienie klasy o podanej nazwie.

Właściwości

CaseSensitive	Pobiera lub ustawia wartość wskazującą, czy porównania ciągów w DataTable obiektach są uwzględniane wielkość liter.
Container	Pobiera kontener dla składnika. (Odziedziczone po MarshalByValueComponent)
DataSetName	Pobiera lub ustawia nazwę bieżącego DataSetelementu .
DefaultViewManager	Pobiera niestandardowy widok danych zawartych w elemecie DataSet , aby umożliwić filtrowanie, wyszukiwanie i nawigowanie przy użyciu niestandardowego DataViewManagerelementu .
DesignMode	Pobiera wartość wskazującą, czy składnik jest obecnie w trybie projektowania. (Odziedziczone po MarshalByValueComponent)
EnforceConstraints	Pobiera lub ustawia wartość wskazującą, czy reguły ograniczeń są przestrzegane podczas próby wykonania dowolnej operacji aktualizacji.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego składnika. (Odziedziczone po MarshalByValueComponent)
ExtendedProperties	Pobiera kolekcję dostosowanych informacji o użytkowniku skojarzonych z elementem DataSet.
HasErrors	Pobiera wartość wskazującą, czy występują błędy w dowolnym obiekcie DataTable w tym DataSetobiekcie .
IsInitialized	Pobiera wartość wskazującą, czy DataSet element jest inicjowany.
Locale	Pobiera lub ustawia informacje regionalne używane do porównywania ciągów w tabeli.
Namespace	Pobiera lub ustawia przestrzeń nazw elementu DataSet.
Prefix	Pobiera lub ustawia prefiks XML, który aliasuje przestrzeń nazw elementu DataSet.
Relations	Pobiera kolekcję relacji, które łączą tabele i umożliwiają nawigację z tabel nadrzędnych do tabel podrzędnych.
RemotingFormat	Pobiera lub ustawia format serializacji używanego DataSet podczas komunikacji zdalnie.
SchemaSerializationMode	Pobiera lub ustawia element SchemaSerializationMode dla parametru DataSet.
Site	Pobiera lub ustawia element ISite dla elementu DataSet.
Tables	Pobiera kolekcję tabel zawartych w obiekcie DataSet.

Metody

AcceptChanges()	Zatwierdza wszystkie zmiany wprowadzone w tym DataSet celu, ponieważ zostały załadowane lub od czasu ostatniego AcceptChanges() wywołania.
BeginInit()	Rozpoczyna inicjowanie elementu używanego DataSet w formularzu lub używanego przez inny składnik. Inicjowanie odbywa się w czasie wykonywania.
Clear()	Czyści DataSet wszystkie dane, usuwając wszystkie wiersze we wszystkich tabelach.
Clone()	Kopiuje strukturę obiektu DataSet, w tym wszystkie DataTable schematy, relacje i ograniczenia. Nie kopiuje żadnych danych.
Copy()	Kopiuje zarówno strukturę, jak i dane dla tego obiektu DataSet.
CreateDataReader()	DataTableReader Zwraca element z jednym zestawem wyników na DataTable, w tej samej sekwencji co tabele wyświetlane w kolekcjiTables.
CreateDataReader(DataTable[])	Zwraca element DataTableReader z jednym zestawem wyników na DataTablewartość .
DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)	Określa element SchemaSerializationMode dla .DataSet
DetermineSchemaSerializationMode(XmlReader)	Określa element SchemaSerializationMode dla .DataSet
Dispose()	Zwalnia wszelkie zasoby używane przez element MarshalByValueComponent. (Odziedziczone po MarshalByValueComponent)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element MarshalByValueComponent i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po MarshalByValueComponent)
EndInit()	Kończy inicjowanie DataSet elementu, który jest używany w formularzu lub używany przez inny składnik. Inicjowanie odbywa się w czasie wykonywania.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetChanges()	Pobiera kopię elementu zawierającego DataSet wszystkie zmiany wprowadzone w nim od momentu załadowania lub od AcceptChanges() ostatniego wywołania.
GetChanges(DataRowState)	Pobiera kopię DataSet zawierającą wszystkie zmiany wprowadzone w nim od czasu ostatniego załadowania lub od AcceptChanges() wywołania filtrowanego przez DataRowStateelement .
GetDataSetSchema(XmlSchemaSet)	Pobiera kopię XmlSchemaSet zestawu danych.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Przestarzałe. Wypełnia obiekt informacji o serializacji danymi wymaganymi do serializacji DataSet.
GetSchemaSerializable()	Zwraca wystąpienie z możliwością XmlSchema serializacji.
GetSerializationData(SerializationInfo, StreamingContext)	Deserializuje dane tabeli ze strumienia binarnego lub XML.
GetService(Type)	Pobiera implementator obiektu IServiceProvider. (Odziedziczone po MarshalByValueComponent)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetXml()	Zwraca reprezentację XML danych przechowywanych w obiekcie DataSet.
GetXmlSchema()	Zwraca schemat XML dla reprezentacji XML danych przechowywanych w obiekcie DataSet.
HasChanges()	Pobiera wartość wskazującą, czy ma DataSet zmiany, w tym nowe, usunięte lub zmodyfikowane wiersze.
HasChanges(DataRowState)	Pobiera wartość wskazującą, czy ma DataSet zmiany, w tym nowe, usunięte lub zmodyfikowane wiersze, filtrowane według DataRowState.
InferXmlSchema(Stream, String[])	Stosuje schemat XML z określonego Stream elementu do .DataSet
InferXmlSchema(String, String[])	Stosuje schemat XML z określonego pliku do pliku DataSet.
InferXmlSchema(TextReader, String[])	Stosuje schemat XML z określonego TextReader elementu do .DataSet
InferXmlSchema(XmlReader, String[])	Stosuje schemat XML z określonego XmlReader elementu do .DataSet
InitializeDerivedDataSet()	Deserializuj wszystkie dane tabel zestawu danych z strumienia binarnego lub XML.
IsBinarySerialized(SerializationInfo, StreamingContext)	Sprawdza format serializowanej reprezentacji obiektu DataSet.
Load(IDataReader, LoadOption, DataTable[])	Wypełnia element DataSet wartościami ze źródła danych przy użyciu podanego IDataReaderelementu , używając tablicy DataTable wystąpień w celu podania informacji o schemacie i przestrzeni nazw.
Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])	Wypełnia element DataSet wartościami ze źródła danych przy użyciu podanego IDataReaderelementu , używając tablicy DataTable wystąpień w celu podania informacji o schemacie i przestrzeni nazw.
Load(IDataReader, LoadOption, String[])	Wypełnia element DataSet wartościami ze źródła danych przy użyciu podanej IDataReadermetody , używając tablicy ciągów w celu podania nazw tabel w obiekcie DataSet.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Merge(DataRow[])	Scala tablicę DataRow obiektów z bieżącym DataSetelementem .
Merge(DataRow[], Boolean, MissingSchemaAction)	Scala tablicę DataRow obiektów z bieżącym DataSet, zachowując lub odrzucając zmiany w DataSet schemacie i obsługując niezgodny schemat zgodnie z podanymi argumentami.
Merge(DataSet)	Scala określony DataSet i jego schemat z bieżącym DataSet.
Merge(DataSet, Boolean)	Scala określony DataSet i jego schemat z bieżącym DataSet, zachowując lub odrzucając wszelkie zmiany w tym DataSet elemencie zgodnie z danym argumentem.
Merge(DataSet, Boolean, MissingSchemaAction)	Scala określony DataSet i jego schemat z bieżącym DataSet, zachowywanie lub odrzucanie zmian w bieżącym i DataSet obsługa niezgodnego schematu zgodnie z podanymi argumentami.
Merge(DataTable)	Scala określony DataTable i jego schemat z bieżącym DataSet.
Merge(DataTable, Boolean, MissingSchemaAction)	Scala określony DataTable i jego schemat z bieżącym DataSet, zachowując lub odrzucając zmiany w DataSet schemacie i obsługując niezgodny schemat zgodnie z podanymi argumentami.
OnPropertyChanging(PropertyChangedEventArgs)	OnPropertyChanging(PropertyChangedEventArgs) Zgłasza zdarzenie.
OnRemoveRelation(DataRelation)	Występuje, gdy DataRelation obiekt zostanie usunięty z obiektu DataTable.
OnRemoveTable(DataTable)	Występuje, gdy element DataTable zostanie usunięty z obiektu DataSet.
RaisePropertyChanging(String)	Wysyła powiadomienie o zmianie określonej DataSet właściwości.
ReadXml(Stream)	Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego Streamelementu .
ReadXml(Stream, XmlReadMode)	Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego Stream i XmlReadMode.
ReadXml(String)	Odczytuje schemat XML i dane do DataSet pliku przy użyciu określonego pliku.
ReadXml(String, XmlReadMode)	Odczytuje schemat XML i dane do DataSet pliku przy użyciu określonego pliku i XmlReadMode.
ReadXml(TextReader)	Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego TextReaderelementu .
ReadXml(TextReader, XmlReadMode)	Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego TextReader i XmlReadMode.
ReadXml(XmlReader)	Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego XmlReaderelementu .
ReadXml(XmlReader, XmlReadMode)	Odczytuje schemat XML i dane do DataSet elementu przy użyciu określonego XmlReader i XmlReadMode.
ReadXmlSchema(Stream)	Odczytuje schemat XML z określonego Stream elementu do elementu DataSet.
ReadXmlSchema(String)	Odczytuje schemat XML z określonego pliku do pliku DataSet.
ReadXmlSchema(TextReader)	Odczytuje schemat XML z określonego TextReader elementu do elementu DataSet.
ReadXmlSchema(XmlReader)	Odczytuje schemat XML z określonego XmlReader elementu do elementu DataSet.
ReadXmlSerializable(XmlReader)	Ignoruje atrybuty i zwraca pusty zestaw danych.
RejectChanges()	Przywraca wszystkie zmiany wprowadzone do DataSet elementu od momentu jego utworzenia lub od czasu AcceptChanges() ostatniego wywołania.
Reset()	Czyści wszystkie tabele i usuwa wszystkie relacje, ograniczenia obce i tabele z tabeli DataSet. Podklasy powinny przesłonić Reset() , aby przywrócić DataSet element do stanu pierwotnego.
ShouldSerializeRelations()	Pobiera wartość wskazującą, czy Relations właściwość powinna być utrwalone.
ShouldSerializeTables()	Pobiera wartość wskazującą, czy Tables właściwość powinna być utrwalone.
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po MarshalByValueComponent)
WriteXml(Stream)	Zapisuje bieżące dane dla DataSet elementu przy użyciu określonego Streamelementu .
WriteXml(Stream, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat przy DataSet użyciu określonych Stream parametrów i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na WriteSchemawartość .
WriteXml(String)	Zapisuje bieżące dane dla elementu do DataSet określonego pliku.
WriteXml(String, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat dla DataSet określonego pliku przy użyciu określonego XmlWriteModepliku . Aby zapisać schemat, ustaw wartość parametru mode na WriteSchemawartość .
WriteXml(TextWriter)	Zapisuje bieżące dane dla DataSet elementu przy użyciu określonego TextWriterelementu .
WriteXml(TextWriter, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat przy DataSet użyciu określonych TextWriter parametrów i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na WriteSchemawartość .
WriteXml(XmlWriter)	Zapisuje bieżące dane dla elementu DataSet do określonego XmlWriterelementu .
WriteXml(XmlWriter, XmlWriteMode)	Zapisuje bieżące dane i opcjonalnie schemat przy DataSet użyciu określonych XmlWriter parametrów i XmlWriteMode. Aby zapisać schemat, ustaw wartość parametru mode na WriteSchemawartość .
WriteXmlSchema(Stream)	DataSet Zapisuje strukturę jako schemat XML do określonego Stream obiektu.
WriteXmlSchema(Stream, Converter<Type,String>)	DataSet Zapisuje strukturę jako schemat XML do określonego Stream obiektu.
WriteXmlSchema(String)	DataSet Zapisuje strukturę jako schemat XML w pliku.
WriteXmlSchema(String, Converter<Type,String>)	DataSet Zapisuje strukturę jako schemat XML w pliku.
WriteXmlSchema(TextWriter)	DataSet Zapisuje strukturę jako schemat XML do określonego TextWriter obiektu.
WriteXmlSchema(TextWriter, Converter<Type,String>)	DataSet Zapisuje strukturę jako schemat XML do określonego TextWriterelementu .
WriteXmlSchema(XmlWriter)	DataSet Zapisuje strukturę jako schemat XML do XmlWriter obiektu.
WriteXmlSchema(XmlWriter, Converter<Type,String>)	DataSet Zapisuje strukturę jako schemat XML do określonego XmlWriterelementu .

Zdarzenia

Disposed	Dodaje procedurę obsługi zdarzeń do nasłuchiwania Disposed zdarzenia w składniku. (Odziedziczone po MarshalByValueComponent)
Initialized	Występuje po zainicjowaniu DataSet .
MergeFailed	Występuje, gdy element docelowy i źródło DataRow mają taką samą wartość klucza podstawowego i EnforceConstraints jest ustawiona na wartość true.

Jawne implementacje interfejsu

IListSource.ContainsListCollection	Aby uzyskać opis tego elementu członkowskiego, zobacz ContainsListCollection.
IListSource.GetList()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetList().
IXmlSerializable.GetSchema()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetSchema().
IXmlSerializable.ReadXml(XmlReader)	Aby uzyskać opis tego elementu członkowskiego, zobacz ReadXml(XmlReader).
IXmlSerializable.WriteXml(XmlWriter)	Aby uzyskać opis tego członka, zobacz WriteXml(XmlWriter).

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny dla operacji odczytu wielowątkowego. Należy zsynchronizować wszystkie operacje zapisu.

Zobacz też

• Używanie zestawów danych w ADO.NET