Cliquez pour évaluer et commenter
MSDN
MSDN Library
Développement .NET
.NET Framework 3.5
.NET Framework
Bibliothèque de classes ....
System.Data, espace de noms
DataSet, classe
Réduire tout/Développer tout Réduire tout
Cette page est spécifique à
Microsoft Visual Studio 2008/.NET Framework 3.5

D'autres versions sont également disponibles pour :
Bibliothèque de classes .NET Framework
DataSet, classe

Mise à jour : novembre 2007

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

Espace de noms :  System.Data
Assembly :  System.Data (dans System.Data.dll)
Visual Basic (Déclaration)
<SerializableAttribute> _
Public Class DataSet _
    Inherits MarshalByValueComponent _
    Implements IListSource, IXmlSerializable, ISupportInitializeNotification, ISupportInitialize,  _
    ISerializable
Visual Basic (Utilisation)
Dim instance As DataSet
C#
[SerializableAttribute]
public class DataSet : MarshalByValueComponent, IListSource, 
    IXmlSerializable, ISupportInitializeNotification, ISupportInitialize, ISerializable
VisualC++
[SerializableAttribute]
public ref class DataSet : public MarshalByValueComponent, 
    IListSource, IXmlSerializable, ISupportInitializeNotification, ISupportInitialize, ISerializable
J#
/** @attribute SerializableAttribute */ 
public class DataSet extends MarshalByValueComponent implements IListSource, 
    IXmlSerializable, ISupportInitializeNotification, ISupportInitialize, ISerializable
JScript
public class DataSet extends MarshalByValueComponent implements IListSource, IXmlSerializable, ISupportInitializeNotification, ISupportInitialize, ISerializable

DataSet, qui est un cache en mémoire des données récupérées d'une source de données, est un composant important de l'architecture ADO.NET. DataSet est constitué d'une collection d'objets DataTable que vous pouvez lier entre eux à l'aide d'objets DataRelation. Vous pouvez également appliquer l'intégrité des données dans le DataSet à l'aide des objets UniqueConstraint et ForeignKeyConstraint. Pour plus d'informations sur l'utilisation d'objets DataSet, consultez Objets DataSet, DataTable et DataView (ADO.NET).

Tandis que les objets DataTable contiennent les données, DataRelationCollection vous permet de naviguer au sein de la hiérarchie des tables. Les tables sont contenues dans un DataTableCollection accessible à l'aide de la propriété Tables. Lorsque vous accédez à des objets DataTable, remarquez qu'ils respectent la casse dans certaines conditions. Par exemple, si DataTable est appelé "mydatatable" et un autre "Mydatatable", une chaîne utilisée pour rechercher une des deux tables est considérée comme respectant la casse. Cependant, si "mydatatable" existe, mais pas "Mydatatable", la chaîne recherchée est considérée comme ne respectant pas la casse. Pour plus d'informations sur l'utilisation d'objets DataTable, consultez Création d'un DataTable (ADO.NET).

DataSet peut lire et écrire les données et le schéma en tant que documents XML. Les données et le schéma peuvent ensuite être transportés au moyen de HTTP et utilisés par n'importe quelle application, sur toute plateforme compatible XML. Vous pouvez enregistrer le schéma en tant que schéma XML à l'aide de la méthode WriteXmlSchema. Il est également possible d'enregistrer le schéma et les données à l'aide de la méthode WriteXml. Pour lire un document XML comprenant à la fois un schéma et des données, utilisez la méthode ReadXml.

Lors d'une implémentation à plusieurs couches standard, la procédure de création et d'actualisation de DataSet, puis de mise à jour des données d'origine consiste à :

  1. générer et remplir chaque DataTable de DataSet avec des données provenant d'une source de données à l'aide de DataAdapter ;

  2. modifier les données dans les objets DataTable en ajoutant, mettant à jour ou supprimant des objets DataRow ;

  3. appeler la méthode GetChanges pour créer un deuxième DataSet qui représente uniquement les modifications apportées aux données ;

  4. appeler la méthode Update de DataAdapter, en passant le deuxième DataSet comme argument.

  5. Appelez la méthode Merge pour fusionner les modifications du deuxième DataSet dans le premier.

  6. Appelez AcceptChanges sur DataSet. Vous pouvez également appeler RejectChanges pour annuler les modifications.

bwy42y0e.alert_note(fr-fr,VS.90).gifRemarque :

Les objets DataSet et DataTable héritent de MarshalByValueComponent et prennent en charge l'interface ISerializable pour l'accès à distance. Il s'agit uniquement d'objets ADO.NET qui peuvent être distants.

bwy42y0e.alert_note(fr-fr,VS.90).gifRemarque :

Les classes héritées de DataSet ne sont pas finalisées par le garbage collector, car le finaliseur a été supprimé dans DataSet. La classe dérivée peut appeler la méthode ReRegisterForFinalize dans son constructeur pour permettre à la classe d'être finalisée par le garbage collector.

TopicLocation
Comment : créer un groupe de données typéAccès aux données dans Visual Studio
Comment : créer un groupe de données typéAccès aux données dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeViewGénération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : affichage de données hiérarchiques dans un contrôle TreeViewGénération d'applications Web ASP.NET dans Visual Studio

L'exemple suivant est constitué de plusieurs méthodes qui, une fois combinées, créent et remplissent un DataSet à partir de la base de données Northwind.

Visual Basic
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 SqlCommand = 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 DataSet = 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 SqlDataAdapter = _
                New SqlDataAdapter()
            productsAdapter.TableMappings.Add("Table", "Products")

            Dim productsCommand As SqlCommand = 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 DataRelation = New _
               System.Data.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
C#
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";
        }
    }
}

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

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 1.0
Contenu de la communauté   Qu'est-ce que le Contenu de la communauté ?
Ajouter du contenu RSS  Annotations
Processing
© 2009 Microsoft Corporation. Tous droits réservés. Conditions d'utilisation | Marques | Confidentialité
Page view tracker