DataSet Classe

Définition

Espace de noms:: System.Data

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

[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

[<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

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

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

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

Héritage: Object

MarshalByValueComponent
DataSet

Attributs: SerializableAttribute

Implémente: IListSource ISupportInitialize ISerializable IXmlSerializable ISupportInitializeNotification

Exemples

L’exemple suivant se compose de plusieurs méthodes qui, combinées, créent et remplissent une 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 les remarques d’API supplémentaires pour DataSet.

Constructeurs

Nom	Description
DataSet()	Initialise une nouvelle instance de la classe DataSet.
DataSet(SerializationInfo, StreamingContext, Boolean)	Initialise une nouvelle instance de la classe DataSet avec des données sérialisées.
DataSet(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe DataSet avec des données sérialisées.
DataSet(String)	Initialise une nouvelle instance de la DataSet classe avec le nom donné.

Propriétés

Nom	Description
CaseSensitive	Obtient ou définit une valeur indiquant si les comparaisons de chaînes dans DataTable les objets respectent la casse.
Container	Obtient le conteneur du composant. (Hérité de MarshalByValueComponent)
DataSetName	Obtient ou définit le nom du fichier actif DataSet.
DefaultViewManager	Obtient une vue personnalisée des données contenues dans la DataSet zone pour autoriser le filtrage, la recherche et la navigation à l’aide d’une vue personnalisée DataViewManager.
DesignMode	Obtient une valeur indiquant si le composant est actuellement en mode création. (Hérité de MarshalByValueComponent)
EnforceConstraints	Obtient ou définit une valeur indiquant si les règles de contrainte sont suivies lors de la tentative d’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ées au `DataSet`.
HasErrors	Obtient une valeur indiquant s’il existe des erreurs dans l’un DataTable des objets dans cet DataSetobjet .
IsInitialized	Obtient une valeur qui indique si l’initialisation DataSet est initialisée.
Locale	Obtient ou définit les informations de paramètres régionaux utilisées pour comparer des chaînes dans la table.
Namespace	Obtient ou définit l’espace de noms du DataSet.
Prefix	Obtient ou définit un préfixe XML qui alias l’espace de noms du DataSet.
Relations	Obtient la collection de relations qui lient des tables et autorisent la navigation entre les tables parentes et les tables enfants.
RemotingFormat	Obtient ou définit le format de sérialisation pour celui utilisé lors de la DataSet communication à distance.
SchemaSerializationMode	Obtient ou définit un SchemaSerializationMode pour un DataSet.
Site	Obtient ou définit un ISite pour le DataSet.
Tables	Obtient la collection de tables contenues dans le DataSet.

Méthodes

Nom	Description
AcceptChanges()	Valide toutes les modifications apportées à ce DataSet paramètre depuis son chargement ou depuis l’appel de la dernière fois AcceptChanges() .
BeginInit()	Commence l’initialisation d’un DataSet qui est utilisé sur un formulaire ou utilisé par un autre composant. L’initialisation se produit au moment de l’exécution.
Clear()	Efface toutes DataSet les données en supprimant toutes les lignes de toutes les tables.
Clone()	Copie la structure du DataSetschéma, y compris tous les DataTable schémas, relations et contraintes. Ne copie aucune donnée.
Copy()	Copie à la fois la structure et les données pour cela DataSet.
CreateDataReader()	Retourne un DataTableReader jeu de résultats avec un jeu de résultats par DataTable, dans la même séquence que les tables apparaissent dans la Tables collection.
CreateDataReader(DataTable[])	Retourne un DataTableReader jeu de résultats avec un jeu de résultats par DataTable.
DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)	Détermine la valeur d’un SchemaSerializationMode DataSet.
DetermineSchemaSerializationMode(XmlReader)	Détermine la valeur d’un SchemaSerializationMode DataSet.
Dispose()	Libère toutes les ressources utilisées par le MarshalByValueComponent. (Hérité de MarshalByValueComponent)
Dispose(Boolean)	Libère les ressources non managées utilisées par les MarshalByValueComponent ressources gérées et libère éventuellement les ressources managées. (Hérité de MarshalByValueComponent)
EndInit()	Termine l’initialisation d’un DataSet formulaire ou utilisé 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 fichier qui contient toutes les modifications apportées à celui-ci depuis son chargement ou depuis AcceptChanges() son dernier appel.
GetChanges(DataRowState)	Obtient une copie de la DataSet copie contenant toutes les modifications apportées à celui-ci depuis son dernier chargement, ou depuis AcceptChanges() son appel, filtrée par DataRowState.
GetDataSetSchema(XmlSchemaSet)	Obtient une copie du XmlSchemaSet DataSet.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Remplit un objet d’informations de sérialisation avec les données nécessaires pour sérialiser le DataSet.
GetSchemaSerializable()	Retourne une instance sérialisable XmlSchema .
GetSerializationData(SerializationInfo, StreamingContext)	Désérialise les données de table à partir du flux binaire ou XML.
GetService(Type)	Obtient l’implémenteur du IServiceProvider. (Hérité de MarshalByValueComponent)
GetType()	Obtient la 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 pour la représentation XML des données stockées dans le DataSet.
HasChanges()	Obtient une valeur indiquant si les DataSet modifications ont été apportées, y compris les lignes nouvelles, supprimées ou modifiées.
HasChanges(DataRowState)	Obtient une valeur indiquant si les DataSet modifications, y compris les lignes nouvelles, supprimées ou modifiées, sont filtrées par DataRowState.
InferXmlSchema(Stream, String[])	Applique le schéma XML du fichier spécifié Stream au DataSet.
InferXmlSchema(String, String[])	Applique le schéma XML du fichier spécifié au DataSetfichier .
InferXmlSchema(TextReader, String[])	Applique le schéma XML du fichier spécifié TextReader au DataSet.
InferXmlSchema(XmlReader, String[])	Applique le schéma XML du fichier spécifié XmlReader au DataSet.
InitializeDerivedDataSet()	Désérialisez toutes les données de tables du DataSet à partir du flux binaire ou XML.
IsBinarySerialized(SerializationInfo, StreamingContext)	Inspecte le format de la représentation sérialisée du `DataSet`.
Load(IDataReader, LoadOption, DataTable[])	Remplit une DataSet valeur à partir d’une source de données à l’aide du tableau d’instances fourni IDataReaderpour fournir les informations de schéma et d’espace de DataTable noms.
Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[])	Remplit une DataSet valeur à partir d’une source de données à l’aide du tableau d’instances fourni IDataReaderpour fournir les informations de schéma et d’espace de DataTable noms.
Load(IDataReader, LoadOption, String[])	Remplit une DataSet valeur à partir d’une source de données à l’aide du tableau de chaînes fourni IDataReaderpour fournir les noms des tables dans le `DataSet`.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Merge(DataRow[], Boolean, MissingSchemaAction)	Fusionne un tableau d’objets DataRow dans le DataSetactuel, en préservant ou en ignorant les modifications dans le `DataSet` et en gérant un schéma incompatible en fonction des arguments donnés.
Merge(DataRow[])	Fusionne un tableau d’objets DataRow dans la DataSetactuelle.
Merge(DataSet, Boolean, MissingSchemaAction)	Fusionne un DataSet spécifié et son schéma avec le `DataSet`actuel, en conservant ou en ignorant les modifications dans le `DataSet` actuel et en gérant un schéma incompatible en fonction des arguments donnés.
Merge(DataSet, Boolean)	Fusionne une DataSet spécifiée et son schéma dans la `DataSet`actuelle, en conservant ou en ignorant les modifications apportées à cette `DataSet` en fonction de l’argument donné.
Merge(DataSet)	Fusionne un DataSet spécifié et son schéma dans la `DataSet`actuelle.
Merge(DataTable, Boolean, MissingSchemaAction)	Fusionne un DataTable spécifié et son schéma dans le `DataSet`actuel, en conservant ou en ignorant les modifications dans le `DataSet` et en gérant un schéma incompatible en fonction des arguments donnés.
Merge(DataTable)	Fusionne un DataTable spécifié et son schéma dans la DataSetactuelle.
OnPropertyChanging(PropertyChangedEventArgs)	Déclenche l’événement OnPropertyChanging(PropertyChangedEventArgs).
OnRemoveRelation(DataRelation)	Se produit lorsqu’un DataRelation objet est supprimé d’un DataTable.
OnRemoveTable(DataTable)	Se produit lorsqu’un DataTable élément est supprimé d’un DataSet.
RaisePropertyChanging(String)	Envoie une notification indiquant que la propriété spécifiée DataSet est sur le point de changer.
ReadXml(Stream, XmlReadMode)	Lit le schéma XML et les données dans l’utilisation DataSet de l’élément spécifié Stream et XmlReadMode.
ReadXml(Stream)	Lit le schéma XML et les données dans l’utilisation DataSet de l’élément spécifié Stream.
ReadXml(String, XmlReadMode)	Lit le schéma XML et les données dans le DataSet fichier spécifié et XmlReadMode.
ReadXml(String)	Lit le schéma XML et les données dans le DataSet fichier spécifié.
ReadXml(TextReader, XmlReadMode)	Lit le schéma XML et les données dans l’utilisation DataSet de l’élément spécifié TextReader et XmlReadMode.
ReadXml(TextReader)	Lit le schéma XML et les données dans l’utilisation DataSet de l’élément spécifié TextReader.
ReadXml(XmlReader, XmlReadMode)	Lit le schéma XML et les données dans l’utilisation DataSet de l’élément spécifié XmlReader et XmlReadMode.
ReadXml(XmlReader)	Lit le schéma XML et les données dans l’utilisation DataSet de l’élément spécifié XmlReader.
ReadXmlSchema(Stream)	Lit le schéma XML à partir du fichier spécifié Stream dans le DataSetfichier .
ReadXmlSchema(String)	Lit le schéma XML du fichier spécifié dans le DataSetfichier .
ReadXmlSchema(TextReader)	Lit le schéma XML à partir du fichier spécifié TextReader dans le DataSetfichier .
ReadXmlSchema(XmlReader)	Lit le schéma XML à partir du fichier spécifié XmlReader dans le DataSetfichier .
ReadXmlSerializable(XmlReader)	Ignore les attributs et retourne un DataSet vide.
RejectChanges()	Annule toutes les modifications apportées à la DataSet date de création, ou depuis le dernier AcceptChanges() appel.
Reset()	Efface toutes les tables et supprime toutes les relations, contraintes étrangères et tables de l’objet DataSet. Les sous-classes doivent remplacer Reset() pour restaurer un DataSet état d’origine.
ShouldSerializeRelations()	Obtient une valeur indiquant si Relations la propriété doit être conservée.
ShouldSerializeTables()	Obtient une valeur indiquant si Tables la propriété doit être conservée.
ToString()	Retourne un String nom contenant le nom du Component, le cas échéant. Cette méthode ne doit pas être remplacée. (Hérité de MarshalByValueComponent)
WriteXml(Stream, XmlWriteMode)	Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées Stream et XmlWriteMode. Pour écrire le schéma, définissez la valeur du `mode` paramètre sur `WriteSchema`.
WriteXml(Stream)	Écrit les données actuelles pour l’utilisation DataSet de l’élément Streamspécifié.
WriteXml(String, XmlWriteMode)	Écrit les données actuelles, et éventuellement le schéma, pour le DataSet fichier spécifié à l’aide du fichier spécifié XmlWriteMode. Pour écrire le schéma, définissez la valeur du `mode` paramètre sur `WriteSchema`.
WriteXml(String)	Écrit les données actuelles du DataSet fichier spécifié.
WriteXml(TextWriter, XmlWriteMode)	Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées TextWriter et XmlWriteMode. Pour écrire le schéma, définissez la valeur du `mode` paramètre sur `WriteSchema`.
WriteXml(TextWriter)	Écrit les données actuelles pour l’utilisation DataSet de l’élément TextWriterspécifié.
WriteXml(XmlWriter, XmlWriteMode)	Écrit les données actuelles, et éventuellement le schéma, pour l’utilisation des DataSet données spécifiées XmlWriter et XmlWriteMode. Pour écrire le schéma, définissez la valeur du `mode` paramètre sur `WriteSchema`.
WriteXml(XmlWriter)	Écrit les données actuelles pour le DataSet fichier spécifié XmlWriter.
WriteXmlSchema(Stream, Converter<Type,String>)	Écrit la DataSet structure en tant que schéma XML dans l’objet spécifié Stream .
WriteXmlSchema(Stream)	Écrit la DataSet structure en tant que schéma XML dans l’objet spécifié Stream .
WriteXmlSchema(String, Converter<Type,String>)	Écrit la DataSet structure en tant que schéma XML dans un fichier.
WriteXmlSchema(String)	Écrit la DataSet structure en tant que schéma XML dans un fichier.
WriteXmlSchema(TextWriter, Converter<Type,String>)	Écrit la DataSet structure en tant que schéma XML dans le fichier spécifié TextWriter.
WriteXmlSchema(TextWriter)	Écrit la DataSet structure en tant que schéma XML dans l’objet spécifié TextWriter .
WriteXmlSchema(XmlWriter, Converter<Type,String>)	Écrit la DataSet structure en tant que schéma XML dans le fichier spécifié XmlWriter.
WriteXmlSchema(XmlWriter)	Écrit la DataSet structure en tant que schéma XML dans un XmlWriter objet.

Événements

Nom	Description
Disposed	Ajoute un gestionnaire d’événements pour écouter l’événement Disposed sur le composant. (Hérité de MarshalByValueComponent)
Initialized	Se produit après l’initialisation DataSet .
MergeFailed	Se produit lorsqu’une cible et une source DataRow ont la même valeur de clé primaire et EnforceConstraints est définie sur true.

Implémentations d’interfaces explicites

Nom	Description
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 le 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

Using DataSets dans ADO.NET

Commentaires

Cette page a-t-elle été utile ?