DataSet Classe

Définition

Représente un cache en mémoire des données.

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 ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, System::ComponentModel::ISupportInitialize, System::Runtime::Serialization::ISerializable, System::Xml::Serialization::IXmlSerializable
public ref class DataSet : System::ComponentModel::MarshalByValueComponent, System::ComponentModel::IListSource, 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
[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.IXmlSerializable
public class DataSet : System.ComponentModel.MarshalByValueComponent, System.ComponentModel.IListSource, 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
[<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
Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, ISupportInitializeNotification, IXmlSerializable
Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitialize, IXmlSerializable
Public Class DataSet
Inherits MarshalByValueComponent
Implements IListSource, ISerializable, ISupportInitializeNotification, IXmlSerializable
Héritage
Attributs
Implémente

Exemples

L’exemple suivant se compose de plusieurs méthodes qui, combinées, créent et remplissent un DataSet à partir de la base de données 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

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour DataSet.

Constructeurs

DataSet()

Initialise une nouvelle instance de la classe DataSet.

DataSet(SerializationInfo, StreamingContext)
Obsolète.

Initialise une nouvelle instance de la classe DataSet avec des données sérialisées.

DataSet(SerializationInfo, StreamingContext, Boolean)
Obsolète.

Initialise une nouvelle instance de la classe DataSet avec des données sérialisées.

DataSet(String)

Initialise une nouvelle instance de la classe DataSet avec le nom indiqué.

Propriétés

CaseSensitive

Obtient ou définit une valeur indiquant si les comparaisons de chaînes au sein d'objets DataTable respectent la casse.

Container

Obtient le conteneur du composant.

(Hérité de MarshalByValueComponent)
DataSetName

Obtient ou définit le nom du DataSet en cours.

DefaultViewManager

Obtient une vue personnalisée des données contenues dans le DataSet, permettant de filtrer, rechercher et naviguer à l'aide d'un DataViewManager personnalisé.

DesignMode

Obtient une valeur indiquant si le composant est actuellement en mode design.

(Hérité de MarshalByValueComponent)
EnforceConstraints

Obtient ou définit une valeur indiquant si les règles de contrainte doivent être respectées lorsque vous tentez une opération de mise à jour.

Events

Obtient la liste des gestionnaires d'événements attachés à ce composant.

(Hérité de MarshalByValueComponent)
ExtendedProperties

Obtient la collection d'informations utilisateur personnalisées associée au DataSet.

HasErrors

Obtient une valeur indiquant s'il existe des erreurs dans les objets DataTable de ce DataSet.

IsInitialized

Obtient une valeur qui indique si DataSet est initialisé.

Locale

Obtient ou définit les paramètres régionaux utilisés pour comparer des chaînes dans la table.

Namespace

Obtient ou définit l'espace de noms de DataSet.

Prefix

Obtient ou définit un préfixe XML qui associe un alias à l'espace de noms de DataSet.

Relations

Obtient la collection des relations qui relient les tables et permettent de naviguer des tables parentes aux tables enfants.

RemotingFormat

Obtient ou définit le format de sérialisation du utilisé lors de la DataSet communication à distance.

SchemaSerializationMode

Obtient ou définit un SchemaSerializationMode pour un DataSet.

Site

Obtient ou définit un élément ISite pour l'élément DataSet.

Tables

Obtient la collection des tables contenues dans le DataSet.

Méthodes

AcceptChanges()

Valide toutes les modifications apportées à ce DataSet depuis son chargement ou depuis le dernier appel à AcceptChanges().

BeginInit()

Commence l'initialisation d'un DataSet qui est utilisé dans un formulaire ou par un autre composant. L'initialisation se produit au moment de l'exécution.

Clear()

Efface toutes les données de DataSet en supprimant toutes les lignes de l'ensemble des tables.

Clone()

Copie la structure de DataSet, y compris tous les schémas, relations et contraintes DataTable. Ne copie aucune donnée.

Copy()

Copie à la fois la structure et les données de ce DataSet.

CreateDataReader()

Retourne un DataTableReader avec un jeu de résultats par DataTable, dans la même séquence que les tables dans la collection Tables.

CreateDataReader(DataTable[])

Retourne un DataTableReader avec un jeu de résultats par DataTable.

DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)

Détermine le SchemaSerializationMode pour un DataSet.

DetermineSchemaSerializationMode(XmlReader)

Détermine le SchemaSerializationMode pour un DataSet.

Dispose()

Libère toutes les ressources utilisées par MarshalByValueComponent.

(Hérité de MarshalByValueComponent)
Dispose(Boolean)

Libère les ressources non managées utilisées par MarshalByValueComponent et libère éventuellement les ressources managées.

(Hérité de MarshalByValueComponent)
EndInit()

Termine l'initialisation d'un DataSet qui est utilisé dans un formulaire ou par un autre composant. L'initialisation se produit au moment de l'exécution.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetChanges()

Obtient une copie du DataSet qui contient l'ensemble des modifications qui lui ont été apportées depuis son chargement ou depuis le dernier appel à AcceptChanges().

GetChanges(DataRowState)

Obtient une copie du DataSet contenant l'ensemble des modifications qui lui ont été apportées depuis son dernier chargement ou depuis l'appel à AcceptChanges(), filtrée par DataRowState.

GetDataSetSchema(XmlSchemaSet)

Obtient une copie de XmlSchemaSet pour le DataSet.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsolète.

Remplit un objet d’informations de sérialisation avec les données nécessaires pour sérialiser DataSet.

GetSchemaSerializable()

Retourne une instance sérialisable de XmlSchema.

GetSerializationData(SerializationInfo, StreamingContext)

Désérialise les données de table du flux binaire ou de données XML.

GetService(Type)

Obtient l'implémenteur du IServiceProvider.

(Hérité de MarshalByValueComponent)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetXml()

Retourne la représentation XML des données stockées dans le DataSet.

GetXmlSchema()

Retourne le schéma XML de la représentation XML des données stockées dans le DataSet.

HasChanges()

Obtient une valeur indiquant si DataSet contient des modifications, notamment des lignes nouvelles, supprimées ou modifiées.

HasChanges(DataRowState)

Obtient une valeur indiquant si DataSet contient des modifications, notamment des lignes nouvelles, supprimées ou modifiées, filtrées par DataRowState.

InferXmlSchema(Stream, String[])

Applique le schéma XML à partir du Stream spécifié à DataSet.

InferXmlSchema(String, String[])

Applique le schéma XML à partir du fichier spécifié du DataSet.

InferXmlSchema(TextReader, String[])

Applique le schéma XML à partir du TextReader spécifié à DataSet.

InferXmlSchema(XmlReader, String[])

Applique le schéma XML à partir du XmlReader spécifié à DataSet.

InitializeDerivedDataSet()

Désérialisez toutes les données de tables du DataSet du flux binaire ou de données XML.

IsBinarySerialized(SerializationInfo, StreamingContext)

Inspecte le format de la représentation sérialisée de DataSet.

Load(IDataReader, LoadOption, DataTable[])

Remplit un DataSet avec des valeurs issues d'une source de données, à l'aide du IDataReader fourni, en utilisant un tableau d'instances de DataTable pour fournir les informations de schéma et d'espace de noms.

Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])

Remplit un DataSet avec des valeurs issues d'une source de données, à l'aide du IDataReader fourni, en utilisant un tableau d'instances de DataTable pour fournir les informations de schéma et d'espace de noms.

Load(IDataReader, LoadOption, String[])

Remplit un DataSet avec des valeurs issues d'une source de données, à l'aide du IDataReader fourni, en utilisant un tableau de chaînes pour fournir les noms des tables dans le DataSet.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
Merge(DataRow[])

Fusionne un tableau d'objets DataRow dans le DataSet en cours.

Merge(DataRow[], Boolean, MissingSchemaAction)

Fusionne un tableau d'objets DataRow dans le DataSet en cours, en préservant ou en supprimant les modifications apportées au DataSet et en traitant tout schéma incompatible conformément aux arguments donnés.

Merge(DataSet)

Fusionne un DataSet spécifié et son schéma dans le DataSet en cours.

Merge(DataSet, Boolean)

Fusionne un DataSet spécifié et son schéma dans le DataSet en cours, en préservant ou en supprimant les modifications effectuées dans ce DataSet conformément à l'argument donné.

Merge(DataSet, Boolean, MissingSchemaAction)

Fusionne un DataSet spécifié et son schéma avec le DataSet en cours, en préservant ou en supprimant les modifications apportées au DataSet en cours, et en traitant un schéma incompatible conformément aux arguments donnés.

Merge(DataTable)

Fusionne un DataTable spécifié et son schéma dans le DataSet en cours.

Merge(DataTable, Boolean, MissingSchemaAction)

Fusionne un DataTable spécifié et son schéma dans le DataSet en cours, en préservant ou en supprimant les modifications apportées au DataSet et en traitant un schéma incompatible conformément aux arguments donnés.

OnPropertyChanging(PropertyChangedEventArgs)

Déclenche l’événement OnPropertyChanging(PropertyChangedEventArgs).

OnRemoveRelation(DataRelation)

Se produit lorsqu'un objet DataRelation est supprimé de DataTable.

OnRemoveTable(DataTable)

Se produit lorsqu'un DataTable est supprimé de DataSet.

RaisePropertyChanging(String)

Envoie une notification indiquant que la propriété DataSet spécifiée est sur le point d'être modifiée.

ReadXml(Stream)

Lit le schéma et les données XML dans le DataSet à l'aide du Stream spécifié.

ReadXml(Stream, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des Stream et XmlReadMode spécifiés.

ReadXml(String)

Lit le schéma et les données XML dans le DataSet à l'aide du fichier spécifié.

ReadXml(String, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide du fichier et du XmlReadMode spécifiés.

ReadXml(TextReader)

Lit le schéma et les données XML dans le DataSet à l'aide du TextReader spécifié.

ReadXml(TextReader, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des TextReader et XmlReadMode spécifiés.

ReadXml(XmlReader)

Lit le schéma et les données XML dans le DataSet à l'aide du XmlReader spécifié.

ReadXml(XmlReader, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des XmlReader et XmlReadMode spécifiés.

ReadXmlSchema(Stream)

Lit le schéma XML à partir du Stream spécifié dans le DataSet.

ReadXmlSchema(String)

Lit le schéma XML à partir du fichier spécifié dans le DataSet.

ReadXmlSchema(TextReader)

Lit le schéma XML à partir du TextReader spécifié dans le DataSet.

ReadXmlSchema(XmlReader)

Lit le schéma XML à partir du XmlReader spécifié dans le DataSet.

ReadXmlSerializable(XmlReader)

Ignore les attributs et retourne un DataSet vide.

RejectChanges()

Restaure toutes les modifications apportées à DataSet depuis sa création ou le dernier appel à AcceptChanges().

Reset()

Efface toutes les tables et supprime toutes les relations, contraintes étrangères et tables du DataSet. Les sous-classes doivent substituer Reset() pour rétablir l'état d'origine de DataSet.

ShouldSerializeRelations()

Obtient une valeur indiquant si la propriété Relations doit être rendue persistante.

ShouldSerializeTables()

Obtient une valeur indiquant si la propriété Tables doit être rendue persistante.

ToString()

Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée.

(Hérité de MarshalByValueComponent)
WriteXml(Stream)

Écrit les données en cours de DataSet à l'aide du Stream spécifié.

WriteXml(Stream, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des Stream et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(String)

Écrit les données en cours de DataSet dans le fichier spécifié.

WriteXml(String, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet dans le fichier spécifié à l'aide du XmlWriteMode spécifié. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(TextWriter)

Écrit les données en cours de DataSet à l'aide du TextWriter spécifié.

WriteXml(TextWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des TextWriter et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXml(XmlWriter)

Écrit les données en cours de DataSet dans le XmlWriter spécifié.

WriteXml(XmlWriter, XmlWriteMode)

Écrit les données en cours, et éventuellement le schéma, de DataSet à l'aide des XmlWriter et XmlWriteMode spécifiés. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.

WriteXmlSchema(Stream)

Écrit la structure DataSet en tant que schéma XML dans l’objet Stream spécifié.

WriteXmlSchema(Stream, Converter<Type,String>)

Écrit la structure DataSet en tant que schéma XML dans l’objet Stream spécifié.

WriteXmlSchema(String)

Écrit la structure DataSet sous la forme d'un schéma XML dans un fichier.

WriteXmlSchema(String, Converter<Type,String>)

Écrit la structure DataSet sous la forme d'un schéma XML dans un fichier.

WriteXmlSchema(TextWriter)

Écrit la structure DataSet en tant que schéma XML dans l’objet TextWriter spécifié.

WriteXmlSchema(TextWriter, Converter<Type,String>)

Écrit la structure de DataSet sous la forme d'un schéma XML dans le TextWriter spécifié.

WriteXmlSchema(XmlWriter)

Écrit la structure DataSet sous la forme d'un schéma XML dans un objet XmlWriter.

WriteXmlSchema(XmlWriter, Converter<Type,String>)

Écrit la structure de DataSet sous la forme d'un schéma XML dans le XmlWriter spécifié.

Événements

Disposed

Ajoute un gestionnaire d'événements pour écouter l'événement Disposed sur le composant.

(Hérité de MarshalByValueComponent)
Initialized

Se produit une fois que le DataSet est initialisé.

MergeFailed

Se produit lorsque des DataRow cible et source possèdent la même valeur de clé primaire et que EnforceConstraints a la valeur true.

Implémentations d’interfaces explicites

IListSource.ContainsListCollection

Pour obtenir une description de ce membre, consultez ContainsListCollection.

IListSource.GetList()

Pour obtenir une description de ce membre, consultez GetList().

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit un objet d’informations de sérialisation avec les données nécessaires pour sérialiser DataSet.

IXmlSerializable.GetSchema()

Pour obtenir une description de ce membre, consultez GetSchema().

IXmlSerializable.ReadXml(XmlReader)

Pour obtenir une description de ce membre, consultez ReadXml(XmlReader).

IXmlSerializable.WriteXml(XmlWriter)

Pour obtenir une description de ce membre, consultez WriteXml(XmlWriter).

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser toutes les opérations d’écriture.

Voir aussi