DataSet Třída

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Zdroj:

DataSet.cs

Představuje mezipaměť dat v paměti.

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

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, System.ComponentModel.ISupportInitialize, System.ComponentModel.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicConstructors | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
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

Dědičnost

Object

MarshalByValueComponent

DataSet

Atributy

DynamicallyAccessedMembersAttribute

Implementuje

IListSource ISupportInitialize ISupportInitializeNotification ISerializable IXmlSerializable

Příklady

Následující příklad se skládá z několika metod, které zkombinují, vytvoří a vyplní DataSet z databáze 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

Poznámky

Další informace o tomto rozhraní API naleznete v tématu Doplňkové poznámky k rozhraní API pro DataSet.

Konstruktory

Name	Description
DataSet()	Inicializuje novou instanci DataSet třídy.
DataSet(SerializationInfo, StreamingContext, Boolean)	Zastaralé. Inicializuje novou instanci DataSet třídy serializovanými daty.
DataSet(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci DataSet třídy serializovanými daty.
DataSet(String)	Inicializuje novou instanci DataSet třídy s daným názvem.

Vlastnosti

Name	Description
CaseSensitive	Získá nebo nastaví hodnotu určující, zda porovnání řetězců v DataTable objektech jsou rozlišovat malá a velká písmena.
Container	Získá kontejner pro komponentu. (Zděděno od MarshalByValueComponent)
DataSetName	Získá nebo nastaví název aktuálního DataSet.
DefaultViewManager	Získá vlastní zobrazení dat obsažených v objektu DataSet umožňující filtrování, vyhledávání a navigaci pomocí vlastní DataViewManager.
DesignMode	Získá hodnotu určující, zda komponenta je aktuálně v režimu návrhu. (Zděděno od MarshalByValueComponent)
EnforceConstraints	Získá nebo nastaví hodnotu určující, zda jsou pravidla omezení dodržena při pokusu o jakoukoli operaci aktualizace.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k této komponentě. (Zděděno od MarshalByValueComponent)
ExtendedProperties	Získá kolekci přizpůsobených informací o uživateli přidružených k objektu DataSet.
HasErrors	Získá hodnotu určující, zda existují chyby v některé z DataTable objektů v tomto DataSet.
IsInitialized	Získá hodnotu, která určuje, zda DataSet je inicializován.
Locale	Získá nebo nastaví informace o národním prostředí použité k porovnání řetězců v tabulce.
Namespace	Získá nebo nastaví obor názvů DataSet.
Prefix	Získá nebo nastaví předponu XML, která aliasy oboru názvů DataSet.
Relations	Získá kolekci relací, které propojuje tabulky a umožňuje navigaci z nadřazených tabulek do podřízených tabulek.
RemotingFormat	Získá nebo nastaví serializační formát, DataSet který se používá během vzdálené komunikace.
SchemaSerializationMode	Získá nebo nastaví SchemaSerializationMode pro DataSet.
Site	Získá nebo nastaví ISite pro DataSet.
Tables	Získá kolekci tabulek obsažených v objektu DataSet.

Metody

Name	Description
AcceptChanges()	Potvrdí všechny změny provedené v tomto DataSet stavu od jeho načtení nebo od posledního AcceptChanges() zavolání.
BeginInit()	Začíná inicializace inicializace DataSet , která se používá ve formuláři nebo používá jinou komponentou. Inicializace probíhá za běhu.
Clear()	Vymaže DataSet všechna data odebráním všech řádků ve všech tabulkách.
Clone()	Zkopíruje strukturu objektu DataSet, včetně všech DataTable schémat, relací a omezení. Nekopíruje žádná data.
Copy()	Zkopíruje strukturu i data pro toto DataSet.
CreateDataReader()	DataTableReader Vrátí s jednou sadou výsledků pro DataTablekaždou , ve stejné sekvenci jako tabulky se zobrazí v kolekciTables.
CreateDataReader(DataTable[])	DataTableReader Vrátí hodnotu s jednou sadou výsledků na .DataTable
DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)	SchemaSerializationMode Určuje pro .DataSet
DetermineSchemaSerializationMode(XmlReader)	SchemaSerializationMode Určuje pro .DataSet
Dispose()	Uvolní všechny prostředky používané nástrojem MarshalByValueComponent. (Zděděno od MarshalByValueComponent)
Dispose(Boolean)	Uvolní nespravované prostředky používané MarshalByValueComponent a volitelně uvolní spravované prostředky. (Zděděno od MarshalByValueComponent)
EndInit()	Ukončí inicializaci DataSet formuláře nebo používaného jinou komponentou. Inicializace probíhá za běhu.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetChanges()	Získá kopii DataSet obsahující všechny změny provedené v něm od jeho načtení nebo od AcceptChanges() posledního zavolání.
GetChanges(DataRowState)	Získá kopii DataSet obsahující všechny změny provedené od posledního načtení, nebo od AcceptChanges() jeho zavolání, filtrované podle DataRowState.
GetDataSetSchema(XmlSchemaSet)	Získá kopii XmlSchemaSet datové sady.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Naplní objekt informací o serializaci dat potřebnými k serializaci objektu DataSet.
GetSchemaSerializable()	Vrátí serializovatelnou XmlSchema instanci.
GetSerializationData(SerializationInfo, StreamingContext)	Deserializuje data tabulky z binárního nebo XML datového proudu.
GetService(Type)	Získá implementátor .IServiceProvider (Zděděno od MarshalByValueComponent)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetXml()	Vrátí reprezentaci XML dat uložených v objektu DataSet.
GetXmlSchema()	Vrátí schéma XML pro reprezentaci XML dat uložených v souboru DataSet.
HasChanges()	Získá hodnotu označující, zda DataSet má změny, včetně nových, odstraněných nebo upravených řádků.
HasChanges(DataRowState)	Získá hodnotu určující, zda DataSet má změny, včetně nových, odstraněných nebo upravených řádků filtrovaných podle DataRowState.
InferXmlSchema(Stream, String[])	Použije schéma XML ze zadaného Stream objektu DataSet.
InferXmlSchema(String, String[])	Použije schéma XML ze zadaného souboru na DataSet.
InferXmlSchema(TextReader, String[])	Použije schéma XML ze zadaného TextReader objektu DataSet.
InferXmlSchema(XmlReader, String[])	Použije schéma XML ze zadaného XmlReader objektu DataSet.
InitializeDerivedDataSet()	Deserializujte všechna data tabulek datové sady z binárního nebo XML datového proudu.
IsBinarySerialized(SerializationInfo, StreamingContext)	Kontroluje formát serializované reprezentace DataSet.
Load(IDataReader, LoadOption, DataTable[])	DataSet Vyplní hodnoty ze zdroje dat pomocí zadaného IDataReaderpole DataTable instancí k zadání schématu a informací o oboru názvů.
Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])	DataSet Vyplní hodnoty ze zdroje dat pomocí zadaného IDataReaderpole DataTable instancí k zadání schématu a informací o oboru názvů.
Load(IDataReader, LoadOption, String[])	DataSet Vyplní hodnoty ze zdroje dat pomocí zadaného IDataReaderpole řetězců k zadání názvů tabulek v objektu DataSet.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Merge(DataRow[], Boolean, MissingSchemaAction)	Sloučí pole DataRow objektů do aktuálního DataSet, zachová nebo zahodí změny v DataSet a zpracovává nekompatibilní schéma podle zadaných argumentů.
Merge(DataRow[])	Sloučí pole DataRow objektů do aktuálního DataSet.
Merge(DataSet, Boolean, MissingSchemaAction)	Sloučí zadaný DataSet a jeho schéma s aktuálním DataSet, zachová nebo zahodí změny v aktuálním DataSet a zpracovává nekompatibilní schéma podle zadaných argumentů.
Merge(DataSet, Boolean)	Sloučí zadaný DataSet a jeho schéma do aktuálního DataSet, zachová nebo zahodí všechny změny v tomto DataSet podle daného argumentu.
Merge(DataSet)	Sloučí zadaný DataSet a jeho schéma do aktuálního DataSet.
Merge(DataTable, Boolean, MissingSchemaAction)	Sloučí zadaný DataTable a jeho schéma do aktuálního DataSet, zachová nebo zahodí změny v DataSet a zpracovává nekompatibilní schéma podle zadaných argumentů.
Merge(DataTable)	Sloučí zadaný DataTable a jeho schéma do aktuálního DataSet.
OnPropertyChanging(PropertyChangedEventArgs)	OnPropertyChanging(PropertyChangedEventArgs) Vyvolá událost.
OnRemoveRelation(DataRelation)	Nastane při DataRelation odebrání objektu z objektu DataTable.
OnRemoveTable(DataTable)	Nastane, když DataTable je odebrán z objektu DataSet.
RaisePropertyChanging(String)	Odešle oznámení, že se zadaná DataSet vlastnost chystá změnit.
ReadXml(Stream, XmlReadMode)	Načte schéma XML a data do DataSet zadaného Stream a XmlReadMode.
ReadXml(Stream)	Načte schéma XML a data do DataSet zadaného Stream.
ReadXml(String, XmlReadMode)	Načte schéma XML a data do zadaného DataSet souboru a XmlReadMode.
ReadXml(String)	Načte schéma XML a data do zadaného DataSet souboru.
ReadXml(TextReader, XmlReadMode)	Načte schéma XML a data do DataSet zadaného TextReader a XmlReadMode.
ReadXml(TextReader)	Načte schéma XML a data do DataSet zadaného TextReader.
ReadXml(XmlReader, XmlReadMode)	Načte schéma XML a data do DataSet zadaného XmlReader a XmlReadMode.
ReadXml(XmlReader)	Načte schéma XML a data do DataSet zadaného XmlReader.
ReadXmlSchema(Stream)	Načte schéma XML ze zadaného Stream souboru do objektu DataSet.
ReadXmlSchema(String)	Načte schéma XML ze zadaného souboru do DataSetsouboru .
ReadXmlSchema(TextReader)	Načte schéma XML ze zadaného TextReader souboru do objektu DataSet.
ReadXmlSchema(XmlReader)	Načte schéma XML ze zadaného XmlReader souboru do objektu DataSet.
ReadXmlSerializable(XmlReader)	Ignoruje atributy a vrátí prázdnou datovou sadu.
RejectChanges()	Vrátí zpět všechny změny provedené DataSet od jeho vytvoření nebo od posledního AcceptChanges() zavolání.
Reset()	Vymaže všechny tabulky a odebere všechny relace, cizí omezení a tabulky z DataSettabulky . Podtřídy by se měly přepsat Reset() , aby se obnovil DataSet původní stav.
ShouldSerializeRelations()	Získá hodnotu označující, zda Relations má být vlastnost zachována.
ShouldSerializeTables()	Získá hodnotu označující, zda Tables má být vlastnost zachována.
ToString()	String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od MarshalByValueComponent)
WriteXml(Stream, XmlWriteMode)	Zapíše aktuální data a volitelně schéma pro DataSet použití zadaného Stream a XmlWriteMode. Chcete-li napsat schéma, nastavte hodnotu parametru mode na WriteSchema.
WriteXml(Stream)	Zapíše aktuální data pro DataSet zadané Stream.
WriteXml(String, XmlWriteMode)	Zapíše aktuální data a volitelně schéma pro DataSet zadaný soubor pomocí zadaného XmlWriteModesouboru . Chcete-li napsat schéma, nastavte hodnotu parametru mode na WriteSchema.
WriteXml(String)	Zapíše aktuální data pro DataSet zadaný soubor.
WriteXml(TextWriter, XmlWriteMode)	Zapíše aktuální data a volitelně schéma pro DataSet použití zadaného TextWriter a XmlWriteMode. Chcete-li napsat schéma, nastavte hodnotu parametru mode na WriteSchema.
WriteXml(TextWriter)	Zapíše aktuální data pro DataSet zadané TextWriter.
WriteXml(XmlWriter, XmlWriteMode)	Zapíše aktuální data a volitelně schéma pro DataSet použití zadaného XmlWriter a XmlWriteMode. Chcete-li napsat schéma, nastavte hodnotu parametru mode na WriteSchema.
WriteXml(XmlWriter)	Zapíše aktuální data pro DataSet zadanou XmlWriter.
WriteXmlSchema(Stream, Converter<Type,String>)	Zapíše DataSet strukturu jako schéma XML do zadaného Stream objektu.
WriteXmlSchema(Stream)	Zapíše DataSet strukturu jako schéma XML do zadaného Stream objektu.
WriteXmlSchema(String, Converter<Type,String>)	Zapíše DataSet strukturu jako schéma XML do souboru.
WriteXmlSchema(String)	Zapíše DataSet strukturu jako schéma XML do souboru.
WriteXmlSchema(TextWriter, Converter<Type,String>)	Zapíše DataSet strukturu jako schéma XML do zadaného TextWriter.
WriteXmlSchema(TextWriter)	Zapíše DataSet strukturu jako schéma XML do zadaného TextWriter objektu.
WriteXmlSchema(XmlWriter, Converter<Type,String>)	Zapíše DataSet strukturu jako schéma XML do zadaného XmlWriter.
WriteXmlSchema(XmlWriter)	Zapíše DataSet strukturu jako schéma XML do objektu XmlWriter .

Událost

Name	Description
Disposed	Přidá obslužnou rutinu Disposed události pro naslouchání události v komponentě. (Zděděno od MarshalByValueComponent)
Initialized	Nastane po DataSet inicializaci.
MergeFailed	Nastane, když cíl a zdroj DataRow mají stejnou hodnotu primárního klíče a EnforceConstraints je nastavena na hodnotu true.

Explicitní implementace rozhraní

Name	Description
IListSource.ContainsListCollection	Popis tohoto člena naleznete v tématu ContainsListCollection.
IListSource.GetList()	Popis tohoto člena naleznete v tématu GetList().
IXmlSerializable.GetSchema()	Popis tohoto člena naleznete v tématu GetSchema().
IXmlSerializable.ReadXml(XmlReader)	Popis tohoto člena naleznete v tématu ReadXml(XmlReader).
IXmlSerializable.WriteXml(XmlWriter)	Popis tohoto člena naleznete v tématu WriteXml(XmlWriter).

Bezpečný přístup z více vláken

Tento typ je bezpečný pro operace čtení s více vlákny. Je nutné synchronizovat všechny operace zápisu.

Viz také

• Použití datových sad v ADO.NET