DataSet DataSet DataSet DataSet Class

Définition

Représente un cache de données en mémoire.Represents an in-memory cache of data.

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.ISupportInitializeNotification, System.Runtime.Serialization.ISerializable, System.Xml.Serialization.IXmlSerializable
type DataSet = class
    inherit MarshalByValueComponent
    interface IListSource
    interface IXmlSerializable
    interface ISupportInitializeNotification
    interface ISerializable
    interface ISupportInitialize
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éer et remplir un DataSet à partir de la Northwind base de données.The following example consists of several methods that, combined, create and fill a DataSet from the Northwind database.

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

Remarques

Le DataSet, qui est un cache en mémoire des données récupérées à partir d’une source de données est un composant majeur de l’architecture ADO.NET.The DataSet, which is an in-memory cache of data retrieved from a data source, is a major component of the ADO.NET architecture. Le DataSet se compose d’une collection de DataTable les objets que vous pouvez associer à l’autre avec DataRelation objets.The DataSet consists of a collection of DataTable objects that you can relate to each other with DataRelation objects. Vous pouvez également appliquer l’intégrité des données dans le DataSet à l’aide de la UniqueConstraint et ForeignKeyConstraint objets.You can also enforce data integrity in the DataSet by using the UniqueConstraint and ForeignKeyConstraint objects. Pour plus d’informations sur l’utilisation de DataSet , consultez DataSets, DataTables et DataViews.For further details about working with DataSet objects, see DataSets, DataTables, and DataViews.

Tandis que DataTable objets contiennent les données, le DataRelationCollection vous permet de naviguer au sein de la hiérarchie de la table.Whereas DataTable objects contain the data, the DataRelationCollection allows you to navigate though the table hierarchy. Les tables sont contenus dans un DataTableCollection accessibles via le Tables propriété.The tables are contained in a DataTableCollection accessed through the Tables property. Lors de l’accès DataTable objets, notez qu’ils sont conditionnelle respectant la casse.When accessing DataTable objects, note that they are conditionally case sensitive. Par exemple, si un DataTable est appelé « mydatatable » et un autre nommé « Mydatatable », une chaîne utilisée pour rechercher une des tables est considérée comme respectant la casse.For example, if one DataTable is named "mydatatable" and another is named "Mydatatable", a string used to search for one of the tables is regarded as case sensitive. Cependant, si « mydatatable » existe et n’est pas le cas de « Mydatatable », la chaîne de recherche est considérée comme respectent pas la casse.However, if "mydatatable" exists and "Mydatatable" does not, the search string is regarded as case insensitive. Pour plus d’informations sur l’utilisation de DataTable , consultez création d’un DataTable.For more information about working with DataTable objects, see Creating a DataTable.

Un DataSet peuvent lire et écrire des données et le schéma en tant que documents XML.A DataSet can read and write data and schema as XML documents. Les données et le schéma peuvent ensuite être traversent HTTP et utilisés par n’importe quelle application, sur n’importe quelle plateforme qui prend en charge de XML.The data and schema can then be transported across HTTP and used by any application, on any platform that is XML-enabled. Vous pouvez enregistrer le schéma comme un schéma XML avec la WriteXmlSchema (méthode) et le schéma et les données peuvent être enregistrées à l’aide de la WriteXml (méthode).You can save the schema as an XML schema with the WriteXmlSchema method, and both schema and data can be saved using the WriteXml method. Pour lire un document XML qui inclut le schéma et les données, utilisez le ReadXml (méthode).To read an XML document that includes both schema and data, use the ReadXml method.

Dans une implémentation classique à plusieurs niveaux, les étapes de création et d’actualisation un DataSet, et à son tour, la mise à jour les données d’origine :In a typical multiple-tier implementation, the steps for creating and refreshing a DataSet, and in turn, updating the original data are to:

  1. Générer et remplir chaque DataTable dans un DataSet avec des données à partir d’une source de données à l’aide un DataAdapter.Build and fill each DataTable in a DataSet with data from a data source using a DataAdapter.

  2. Modifier les données dans les DataTable les objets par ajout, la mise à jour ou la suppression DataRow objets.Change the data in individual DataTable objects by adding, updating, or deleting DataRow objects.

  3. Appeler le GetChanges méthode pour créer un second DataSet qui propose uniquement les modifications aux données.Invoke the GetChanges method to create a second DataSet that features only the changes to the data.

  4. Appelez le Update méthode de la DataAdapter, en passant le deuxième DataSet en tant qu’argument.Call the Update method of the DataAdapter, passing the second DataSet as an argument.

  5. Appeler le Merge méthode pour fusionner les modifications de la seconde DataSet dans la première.Invoke the Merge method to merge the changes from the second DataSet into the first.

  6. Appeler le AcceptChanges sur le DataSet.Invoke the AcceptChanges on the DataSet. Vous pouvez également appeler RejectChanges pour annuler les modifications.Alternatively, invoke RejectChanges to cancel the changes.

Notes

Le DataSet et DataTable objets héritent MarshalByValueComponentet prennent en charge la ISerializable interface pour la communication à distance.The DataSet and DataTable objects inherit from MarshalByValueComponent, and support the ISerializable interface for remoting. Ce sont les seuls objets ADO.NET qui peuvent être exécutés à distance.These are the only ADO.NET objects that can be remoted.

Notes

Classes héritées de DataSet ne sont pas finalisés par le garbage collector, car le finaliseur a été supprimé dans DataSet.Classes inherited from DataSet are not finalized by the garbage collector, because the finalizer has been suppressed in DataSet. La classe dérivée peut appeler le ReRegisterForFinalize méthode dans son constructeur pour permettre à la classe de finalisation par le garbage collector.The derived class can call the ReRegisterForFinalize method in its constructor to allow the class to be finalized by the garbage collector.

Constructeurs

DataSet() DataSet() DataSet() DataSet()

Initialise une nouvelle instance de la classe DataSet.Initializes a new instance of the DataSet class.

DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext) DataSet(SerializationInfo, StreamingContext)

Initialise une nouvelle instance d'une classe DataSet qui contient les informations de sérialisation et le contexte donnés.Initializes a new instance of a DataSet class that has the given serialization information and context.

DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean) DataSet(SerializationInfo, StreamingContext, Boolean)

Initialise une nouvelle instance de la classe DataSet.Initializes a new instance of the DataSet class.

DataSet(String) DataSet(String) DataSet(String) DataSet(String)

Initialise une nouvelle instance d'une classe DataSet portant le nom donné.Initializes a new instance of a DataSet class with the given name.

Propriétés

CaseSensitive CaseSensitive CaseSensitive CaseSensitive

Obtient ou définit une valeur indiquant si les comparaisons de chaînes au sein d'objets DataTable respectent la casse.Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.

Container Container Container Container

Obtient le conteneur du composant.Gets the container for the component.

(Inherited from MarshalByValueComponent)
DataSetName DataSetName DataSetName DataSetName

Obtient ou définit le nom du DataSet en cours.Gets or sets the name of the current DataSet.

DefaultViewManager DefaultViewManager DefaultViewManager 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é.Gets a custom view of the data contained in the DataSet to allow filtering, searching, and navigating using a custom DataViewManager.

DesignMode DesignMode DesignMode DesignMode

Obtient une valeur indiquant si le composant est actuellement en mode design.Gets a value indicating whether the component is currently in design mode.

(Inherited from MarshalByValueComponent)
EnforceConstraints EnforceConstraints EnforceConstraints 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.Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.

Events Events Events Events

Obtient la liste des gestionnaires d'événements attachés à ce composant.Gets the list of event handlers that are attached to this component.

(Inherited from MarshalByValueComponent)
ExtendedProperties ExtendedProperties ExtendedProperties ExtendedProperties

Obtient la collection d'informations utilisateur personnalisées associée au DataSet.Gets the collection of customized user information associated with the DataSet.

HasErrors HasErrors HasErrors HasErrors

Obtient une valeur indiquant s'il existe des erreurs dans les objets DataTable de ce DataSet.Gets a value indicating whether there are errors in any of the DataTable objects within this DataSet.

IsInitialized IsInitialized IsInitialized IsInitialized

Obtient une valeur qui indique si DataSet est initialisé.Gets a value that indicates whether the DataSet is initialized.

Locale Locale Locale Locale

Obtient ou définit les paramètres régionaux utilisés pour comparer des chaînes dans la table.Gets or sets the locale information used to compare strings within the table.

Namespace Namespace Namespace Namespace

Obtient ou définit l'espace de noms de DataSet.Gets or sets the namespace of the DataSet.

Prefix Prefix Prefix Prefix

Obtient ou définit un préfixe XML qui associe un alias à l'espace de noms de DataSet.Gets or sets an XML prefix that aliases the namespace of the DataSet.

Relations Relations Relations Relations

Obtient la collection des relations qui relient les tables et permettent de naviguer des tables parentes aux tables enfants.Gets the collection of relations that link tables and allow navigation from parent tables to child tables.

RemotingFormat RemotingFormat RemotingFormat RemotingFormat

Obtient ou définit un SerializationFormat pour le DataSet utilisé pendant la communication à distance.Gets or sets a SerializationFormat for the DataSet used during remoting.

SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode SchemaSerializationMode

Obtient ou définit un SchemaSerializationMode pour un DataSet.Gets or sets a SchemaSerializationMode for a DataSet.

Site Site Site Site

Obtient ou définit un élément ISite pour l'élément DataSet.Gets or sets an ISite for the DataSet.

Tables Tables Tables Tables

Obtient la collection des tables contenues dans le DataSet.Gets the collection of tables contained in the DataSet.

Méthodes

AcceptChanges() AcceptChanges() AcceptChanges() AcceptChanges()

Valide toutes les modifications apportées à ce DataSet depuis son chargement ou depuis le dernier appel à AcceptChanges().Commits all the changes made to this DataSet since it was loaded or since the last time AcceptChanges() was called.

BeginInit() BeginInit() BeginInit() BeginInit()

Commence l'initialisation d'un DataSet qui est utilisé dans un formulaire ou par un autre composant.Begins the initialization of a DataSet that is used on a form or used by another component. L'initialisation se produit au moment de l'exécution.The initialization occurs at run time.

Clear() Clear() Clear() Clear()

Efface toutes les données de DataSet en supprimant toutes les lignes de l'ensemble des tables.Clears the DataSet of any data by removing all rows in all tables.

Clone() Clone() Clone() Clone()

Copie la structure de DataSet, y compris tous les schémas, relations et contraintes DataTable.Copies the structure of the DataSet, including all DataTable schemas, relations, and constraints. Ne copie aucune donnée.Does not copy any data.

Copy() Copy() Copy() Copy()

Copie à la fois la structure et les données de ce DataSet.Copies both the structure and data for this DataSet.

CreateDataReader() CreateDataReader() CreateDataReader() 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.Returns a DataTableReader with one result set per DataTable, in the same sequence as the tables appear in the Tables collection.

CreateDataReader(DataTable[]) CreateDataReader(DataTable[]) CreateDataReader(DataTable[]) CreateDataReader(DataTable[])

Retourne un DataTableReader avec un jeu de résultats par DataTable.Returns a DataTableReader with one result set per DataTable.

DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext) DetermineSchemaSerializationMode(SerializationInfo, StreamingContext)

Détermine le SchemaSerializationMode pour un DataSet.Determines the SchemaSerializationMode for a DataSet.

DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader) DetermineSchemaSerializationMode(XmlReader)

Détermine le SchemaSerializationMode pour un DataSet.Determines the SchemaSerializationMode for a DataSet.

Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par MarshalByValueComponent.Releases all resources used by the MarshalByValueComponent.

(Inherited from MarshalByValueComponent)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources non managées utilisées par MarshalByValueComponent et libère éventuellement les ressources managées.Releases the unmanaged resources used by the MarshalByValueComponent and optionally releases the managed resources.

(Inherited from MarshalByValueComponent)
EndInit() EndInit() EndInit() EndInit()

Termine l'initialisation d'un DataSet qui est utilisé dans un formulaire ou par un autre composant.Ends the initialization of a DataSet that is used on a form or used by another component. L'initialisation se produit au moment de l'exécution.The initialization occurs at run time.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChanges() GetChanges() GetChanges() 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().Gets a copy of the DataSet that contains all changes made to it since it was loaded or since AcceptChanges() was last called.

GetChanges(DataRowState) GetChanges(DataRowState) GetChanges(DataRowState) 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.Gets a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges() was called, filtered by DataRowState.

GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet) GetDataSetSchema(XmlSchemaSet)

Obtient une copie de XmlSchemaSet pour le DataSet.Gets a copy of XmlSchemaSet for the DataSet.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Remplit un objet d’informations de sérialisation avec les données nécessaires pour sérialiser DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

GetSchemaSerializable() GetSchemaSerializable() GetSchemaSerializable() GetSchemaSerializable()

Retourne une instance sérialisable de XmlSchema.Returns a serializable XmlSchema instance.

GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext) GetSerializationData(SerializationInfo, StreamingContext)

Désérialise les données de table du flux binaire ou de données XML.Deserializes the table data from the binary or XML stream.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Obtient l'implémenteur du IServiceProvider.Gets the implementer of the IServiceProvider.

(Inherited from MarshalByValueComponent)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetXml() GetXml() GetXml() GetXml()

Retourne la représentation XML des données stockées dans le DataSet.Returns the XML representation of the data stored in the DataSet.

GetXmlSchema() GetXmlSchema() GetXmlSchema() GetXmlSchema()

Retourne le schéma XML de la représentation XML des données stockées dans le DataSet.Returns the XML Schema for the XML representation of the data stored in the DataSet.

HasChanges() HasChanges() HasChanges() HasChanges()

Obtient une valeur indiquant si DataSet contient des modifications, notamment des lignes nouvelles, supprimées ou modifiées.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.

HasChanges(DataRowState) HasChanges(DataRowState) HasChanges(DataRowState) HasChanges(DataRowState)

Obtient une valeur indiquant si DataSet contient des modifications, notamment des lignes nouvelles, supprimées ou modifiées, filtrées par DataRowState.Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows, filtered by DataRowState.

InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[]) InferXmlSchema(Stream, String[])

Applique le schéma XML à partir du Stream spécifié à DataSet.Applies the XML schema from the specified Stream to the DataSet.

InferXmlSchema(String, String[]) InferXmlSchema(String, String[]) InferXmlSchema(String, String[]) InferXmlSchema(String, String[])

Applique le schéma XML à partir du fichier spécifié du DataSet.Applies the XML schema from the specified file to the DataSet.

InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[]) InferXmlSchema(TextReader, String[])

Applique le schéma XML à partir du TextReader spécifié à DataSet.Applies the XML schema from the specified TextReader to the DataSet.

InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[]) InferXmlSchema(XmlReader, String[])

Applique le schéma XML à partir du XmlReader spécifié à DataSet.Applies the XML schema from the specified XmlReader to the DataSet.

InitializeDerivedDataSet() InitializeDerivedDataSet() InitializeDerivedDataSet() InitializeDerivedDataSet()

Désérialisez toutes les données de tables du DataSet du flux binaire ou de données XML.Deserialize all of the tables data of the DataSet from the binary or XML stream.

IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext) IsBinarySerialized(SerializationInfo, StreamingContext)

Inspecte le format de la représentation sérialisée de DataSet.Inspects the format of the serialized representation of the DataSet.

Load(IDataReader, LoadOption, DataTable[]) Load(IDataReader, LoadOption, DataTable[]) Load(IDataReader, LoadOption, DataTable[]) 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.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of DataTable instances to supply the schema and namespace information.

Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) Load(IDataReader, LoadOption, FillErrorEventHandler, DataTable[]) 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.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of DataTable instances to supply the schema and namespace information.

Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[]) Load(IDataReader, LoadOption, String[]) 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.Fills a DataSet with values from a data source using the supplied IDataReader, using an array of strings to supply the names for the tables within the DataSet.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Merge(DataRow[]) Merge(DataRow[]) Merge(DataRow[]) Merge(DataRow[])

Fusionne un tableau d'objets DataRow dans le DataSet en cours.Merges an array of DataRow objects into the current DataSet.

Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction) Merge(DataRow[], Boolean, MissingSchemaAction) 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.Merges an array of DataRow objects into the current DataSet, preserving or discarding changes in the DataSet and handling an incompatible schema according to the given arguments.

Merge(DataSet) Merge(DataSet) Merge(DataSet) Merge(DataSet)

Fusionne un DataSet spécifié et son schéma dans le DataSet en cours.Merges a specified DataSet and its schema into the current DataSet.

Merge(DataSet, Boolean) Merge(DataSet, Boolean) Merge(DataSet, Boolean) 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é.Merges a specified DataSet and its schema into the current DataSet, preserving or discarding any changes in this DataSet according to the given argument.

Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction) Merge(DataSet, Boolean, MissingSchemaAction) 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.Merges a specified DataSet and its schema with the current DataSet, preserving or discarding changes in the current DataSet and handling an incompatible schema according to the given arguments.

Merge(DataTable) Merge(DataTable) Merge(DataTable) Merge(DataTable)

Fusionne un DataTable spécifié et son schéma dans le DataSet en cours.Merges a specified DataTable and its schema into the current DataSet.

Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) Merge(DataTable, Boolean, MissingSchemaAction) 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.Merges a specified DataTable and its schema into the current DataSet, preserving or discarding changes in the DataSet and handling an incompatible schema according to the given arguments.

OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs) OnPropertyChanging(PropertyChangedEventArgs)

Déclenche l'événement OnPropertyChanging(PropertyChangedEventArgs).Raises the OnPropertyChanging(PropertyChangedEventArgs) event.

OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation) OnRemoveRelation(DataRelation)

Se produit lorsqu'un objet DataRelation est supprimé de DataTable.Occurs when a DataRelation object is removed from a DataTable.

OnRemoveTable(DataTable) OnRemoveTable(DataTable) OnRemoveTable(DataTable) OnRemoveTable(DataTable)

Se produit lorsqu'un DataTable est supprimé de DataSet.Occurs when a DataTable is removed from a DataSet.

RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String) RaisePropertyChanging(String)

Envoie une notification indiquant que la propriété DataSet spécifiée est sur le point d'être modifiée.Sends a notification that the specified DataSet property is about to change.

ReadXml(Stream) ReadXml(Stream) ReadXml(Stream) ReadXml(Stream)

Lit le schéma et les données XML dans le DataSet à l'aide du Stream spécifié.Reads XML schema and data into the DataSet using the specified Stream.

ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode) ReadXml(Stream, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des Stream et XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified Stream and XmlReadMode.

ReadXml(String) ReadXml(String) ReadXml(String) ReadXml(String)

Lit le schéma et les données XML dans le DataSet à l'aide du fichier spécifié.Reads XML schema and data into the DataSet using the specified file.

ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) ReadXml(String, XmlReadMode) 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.Reads XML schema and data into the DataSet using the specified file and XmlReadMode.

ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader) ReadXml(TextReader)

Lit le schéma et les données XML dans le DataSet à l'aide du TextReader spécifié.Reads XML schema and data into the DataSet using the specified TextReader.

ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode) ReadXml(TextReader, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des TextReader et XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified TextReader and XmlReadMode.

ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader) ReadXml(XmlReader)

Lit le schéma et les données XML dans le DataSet à l'aide du XmlReader spécifié.Reads XML schema and data into the DataSet using the specified XmlReader.

ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode) ReadXml(XmlReader, XmlReadMode)

Lit le schéma et les données XML dans le DataSet à l'aide des XmlReader et XmlReadMode spécifiés.Reads XML schema and data into the DataSet using the specified XmlReader and XmlReadMode.

ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream) ReadXmlSchema(Stream)

Lit le schéma XML à partir du Stream spécifié dans le DataSet.Reads the XML schema from the specified Stream into the DataSet.

ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String) ReadXmlSchema(String)

Lit le schéma XML à partir du fichier spécifié dans le DataSet.Reads the XML schema from the specified file into the DataSet.

ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader) ReadXmlSchema(TextReader)

Lit le schéma XML à partir du TextReader spécifié dans le DataSet.Reads the XML schema from the specified TextReader into the DataSet.

ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader) ReadXmlSchema(XmlReader)

Lit le schéma XML à partir du XmlReader spécifié dans le DataSet.Reads the XML schema from the specified XmlReader into the DataSet.

ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader) ReadXmlSerializable(XmlReader)

Ignore les attributs et retourne un DataSet vide.Ignores attributes and returns an empty DataSet.

RejectChanges() RejectChanges() RejectChanges() RejectChanges()

Restaure toutes les modifications apportées à DataSet depuis sa création ou le dernier appel à AcceptChanges().Rolls back all the changes made to the DataSet since it was created, or since the last time AcceptChanges() was called.

Reset() Reset() Reset() Reset()

Efface toutes les tables et supprime toutes les relations, contraintes étrangères et tables du DataSet.Clears all tables and removes all relations, foreign constraints, and tables from the DataSet. Les sous-classes doivent substituer Reset() pour rétablir l'état d'origine de DataSet.Subclasses should override Reset() to restore a DataSet to its original state.

ShouldSerializeRelations() ShouldSerializeRelations() ShouldSerializeRelations() ShouldSerializeRelations()

Obtient une valeur indiquant si la propriété Relations doit être rendue persistante.Gets a value indicating whether Relations property should be persisted.

ShouldSerializeTables() ShouldSerializeTables() ShouldSerializeTables() ShouldSerializeTables()

Obtient une valeur indiquant si la propriété Tables doit être rendue persistante.Gets a value indicating whether Tables property should be persisted.

ToString() ToString() ToString() ToString()

Retourne un String contenant le nom du Component, s’il en existe un.Returns a String containing the name of the Component, if any. Cette méthode ne doit pas être remplacée.This method should not be overridden.

(Inherited from MarshalByValueComponent)
WriteXml(Stream) WriteXml(Stream) WriteXml(Stream) WriteXml(Stream)

Écrit les données en cours de DataSet à l'aide du Stream spécifié.Writes the current data for the DataSet using the specified Stream.

WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) WriteXml(Stream, XmlWriteMode) 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.Writes the current data, and optionally the schema, for the DataSet using the specified Stream and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(String) WriteXml(String) WriteXml(String) WriteXml(String)

Écrit les données en cours de DataSet dans le fichier spécifié.Writes the current data for the DataSet to the specified file.

WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) WriteXml(String, XmlWriteMode) 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é.Writes the current data, and optionally the schema, for the DataSet to the specified file using the specified XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter) WriteXml(TextWriter)

Écrit les données en cours de DataSet à l'aide du TextWriter spécifié.Writes the current data for the DataSet using the specified TextWriter.

WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) WriteXml(TextWriter, XmlWriteMode) 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.Writes the current data, and optionally the schema, for the DataSet using the specified TextWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter) WriteXml(XmlWriter)

Écrit les données en cours de DataSet dans le XmlWriter spécifié.Writes the current data for the DataSet to the specified XmlWriter.

WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) WriteXml(XmlWriter, XmlWriteMode) 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.Writes the current data, and optionally the schema, for the DataSet using the specified XmlWriter and XmlWriteMode. Pour écrire le schéma, affectez WriteSchema comme valeur du paramètre mode.To write the schema, set the value for the mode parameter to WriteSchema.

WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream) WriteXmlSchema(Stream)

Écrit la structure DataSet en tant que schéma XML dans l’objet Stream spécifié.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>) WriteXmlSchema(Stream, Converter<Type,String>)

Écrit la structure DataSet en tant que schéma XML dans l’objet Stream spécifié.Writes the DataSet structure as an XML schema to the specified Stream object.

WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String) WriteXmlSchema(String)

Écrit la structure DataSet sous la forme d'un schéma XML dans un fichier.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>) WriteXmlSchema(String, Converter<Type,String>)

Écrit la structure DataSet sous la forme d'un schéma XML dans un fichier.Writes the DataSet structure as an XML schema to a file.

WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter) WriteXmlSchema(TextWriter)

Écrit la structure DataSet en tant que schéma XML dans l’objet TextWriter spécifié.Writes the DataSet structure as an XML schema to the specified TextWriter object.

WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>) WriteXmlSchema(TextWriter, Converter<Type,String>)

Écrit la structure de DataSet sous la forme d'un schéma XML dans le TextWriter spécifié.Writes the DataSet structure as an XML schema to the specified TextWriter.

WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter) WriteXmlSchema(XmlWriter)

Écrit la structure DataSet sous la forme d'un schéma XML dans un objet XmlWriter.Writes the DataSet structure as an XML schema to an XmlWriter object.

WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>) WriteXmlSchema(XmlWriter, Converter<Type,String>)

Écrit la structure de DataSet sous la forme d'un schéma XML dans le XmlWriter spécifié.Writes the DataSet structure as an XML schema to the specified XmlWriter.

Événements

Disposed Disposed Disposed Disposed

Ajoute un gestionnaire d'événements qui doit écouter l'événement Disposed pour le composant.Adds an event handler to listen to the Disposed event on the component.

(Inherited from MarshalByValueComponent)
Initialized Initialized Initialized Initialized

Se produit une fois que le DataSet est initialisé.Occurs after the DataSet is initialized.

MergeFailed MergeFailed MergeFailed 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.Occurs when a target and source DataRow have the same primary key value, and EnforceConstraints is set to true.

Implémentations d’interfaces explicites

IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection

Pour obtenir une description de ce membre, consultez ContainsListCollection.For a description of this member, see ContainsListCollection.

IListSource.GetList() IListSource.GetList() IListSource.GetList() IListSource.GetList()

Pour obtenir une description de ce membre, consultez GetList().For a description of this member, see GetList().

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit un objet d’informations de sérialisation avec les données nécessaires pour sérialiser DataSet.Populates a serialization information object with the data needed to serialize the DataSet.

IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema() IXmlSerializable.GetSchema()

Pour obtenir une description de ce membre, consultez GetSchema().For a description of this member, see GetSchema().

IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader) IXmlSerializable.ReadXml(XmlReader)

Pour obtenir une description de ce membre, consultez ReadXml(XmlReader).For a description of this member, see ReadXml(XmlReader).

IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter) IXmlSerializable.WriteXml(XmlWriter)

Pour obtenir une description de ce membre, consultez WriteXml(XmlWriter).For a description of this member, see WriteXml(XmlWriter).

S’applique à

Cohérence de thread

Ce type est sécurisé pour les opérations de lecture multithreads.This type is safe for multithreaded read operations. Vous devez synchroniser des opérations d’écriture.You must synchronize any write operations.

Voir aussi