System.Data Espace de noms

Permet d’accéder à des classes qui représentent l’architecture ADO.NET. ADO.NET vous permet de construire des composants qui gèrent efficacement les données provenant de plusieurs sources.

Classes

Constraint

Représente une contrainte qui peut être appliquée à un ou plusieurs objets DataColumn.

ConstraintCollection

Représente une collection de contraintes pour DataTable.

ConstraintException

Représente l’exception qui est levée en tentant une action qui viole une contrainte.

DataColumn

Représente le schéma d'une colonne dans un DataTable.

DataColumnChangeEventArgs

Fournit des données pour l'événement ColumnChanging.

DataColumnCollection

Représente une collection d'objets DataColumn pour DataTable.

DataException

Représente l'exception levée lorsque des erreurs sont générées à l'aide de composants ADO.NET.

DataReaderExtensions

Fournit des méthodes d'extension pour DbDataReader.

DataRelation

Représente une relation de parent/enfant entre deux objets DataTable.

DataRelationCollection

Représente la collection d'objets DataRelation de ce DataSet.

DataRow

Représente une ligne de données dans un DataTable.

DataRowBuilder

Le type DataRowBuilder prend en charge l’infrastructure .NET. Il n’est pas destiné à être utilisé directement à partir de votre code.

DataRowChangeEventArgs

Fournit les données des événements RowChanged, RowChanging, OnRowDeleting(DataRowChangeEventArgs) et OnRowDeleted(DataRowChangeEventArgs).

DataRowCollection

Représente une collection de lignes pour DataTable.

DataRowComparer

Retourne une instance singleton de la classe DataRowComparer<TRow>.

DataRowComparer<TRow>

Compare deux objets DataRow pour vérifier leur équivalence à l'aide de la comparaison basée sur les valeurs.

DataRowExtensions

Définit les méthodes d'extension à la classe DataRow. C'est une classe statique.

DataRowView

Représente une vue personnalisée d’un DataRow.

DataSet

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

DataSetSchemaImporterExtension

Ce membre prend en charge l'infrastructure .NET Framework et n'est pas destiné à être utilisé directement à partir de votre code.

DataSysDescriptionAttribute

Marque une propriété, un événement ou un extendeur avec une description. Les concepteurs visuels peuvent afficher cette description quand ils référencent le membre.

DataTable

Représente une table de données en mémoire.

DataTableClearEventArgs

Fournit des données pour la méthode Clear().

DataTableCollection

Représente la collection de tables de DataSet.

DataTableExtensions

Définit les méthodes d'extension à la classe DataTable. DataTableExtensions est une classe statique.

DataTableNewRowEventArgs

Fournit des données pour la méthode NewRow().

DataTableReader

L'objet DataTableReader obtient le contenu d'un ou plusieurs objets DataTable sous la forme d'un ou plusieurs jeux de résultats en lecture seule et en avant uniquement.

DataView

Représente une vue personnalisée et pouvant être liée à des données de DataTable. Cette vue autorise le tri, le filtrage, la recherche, les modifications et la navigation. DataView ne stocke pas de données. Au lieu de cela, il offre une vue connectée de son DataTable correspondant. Les changements apportés aux données de DataView affectent DataTable. Les changements apportés aux données de DataTable affectent l’ensemble des DataView associés.

DataViewManager

Contient un DataViewSettingCollection par défaut pour chaque DataTable dans DataSet.

DataViewSetting

Représente les paramètres par défaut pour ApplyDefaultSort, DataViewManager, RowFilter, RowStateFilter, Sort et Table pour les DataViews créés à partir de DataViewManager.

DataViewSettingCollection

Contient une collection en lecture seule d'objets DataViewSetting pour chaque DataTable de DataSet.

DBConcurrencyException

Exception levée par DataAdapter pendant une opération d'insertion, de mise à jour ou de suppression si le nombre de lignes affectées est égal à zéro.

DeletedRowInaccessibleException

Représente l'exception levée lorsqu'une action est tentée sur un DataRow qui a été supprimé.

DuplicateNameException

Représente l'exception levée lorsqu'un nom d'objet de base de données dupliqué est détecté pendant une opération d'ajout dans un objet lié à DataSet.

EntityCommandCompilationException

Représente les erreurs qui se produisent pendant la compilation de commande, lorsqu’une arborescence de commandes n’a pas pu être produite afin de représenter le texte de commande.

EntityCommandExecutionException

Représente les erreurs qui se produisent lorsque le fournisseur de stockage sous-jacent n'a pas pu exécuter la commande spécifiée. Cette exception encapsule habituellement une exception spécifique au fournisseur.

EntityException

Représente les erreurs liées à Entity Framework qui se produisent dans l’espace de noms EntityClient. EntityException est la classe de base de toutes les exceptions Entity Framework levées par la classe EntityClient.

EntityKey

Fournit une référence durable à un objet qui est une instance d'un type d'entité.

EntityKeyMember

Représente une paire nom/valeur de clé qui fait partie de cet objet EntityKey.

EntitySqlException

Représente les erreurs qui se produisent lors de l'analyse du texte de commande Entity SQL. Cette exception est levée lorsque des règles syntaxiques ou sémantiques sont enfreintes.

EnumerableRowCollection

Représente une collection d’objets DataRow retournée par une requête LINQ to DataSet. Cette API prend en charge l’infrastructure .NET et n’est pas destinée à être utilisée directement à partir de votre code.

EnumerableRowCollection<TRow>

Représente une collection d’objets DataRow retournée par une requête.

EnumerableRowCollectionExtensions

Contient les méthodes d'extension pour les classes de collection de ligne de données.

EvaluateException

Représente l'exception levée lorsque la propriété Expression de DataColumn ne peut pas être évaluée.

FillErrorEventArgs

Fournit des données pour l'événement FillError de DbDataAdapter.

ForeignKeyConstraint

Représente une restriction d'action appliquée à un jeu de colonnes dans une relation de clé primaire/clé étrangère lorsqu'une valeur ou une ligne est supprimée ou mise à jour.

InRowChangingEventException

Représente l'exception qui est levée lorsque vous appelez la méthode EndEdit() au sein de l'événement RowChanging.

InternalDataCollectionBase

Fournit les fonctionnalités de base pour la création de collections.

InvalidCommandTreeException

Exception levée pour indiquer qu'une arborescence de commandes n'est pas valide. Actuellement, cette exception n’est levée nulle part dans Entity Framework.

InvalidConstraintException

Représente l'exception levée lorsque vous essayez de créer une relation ou d'y accéder de manière incorrecte.

InvalidExpressionException

Représente l'exception qui est levée lorsque vous tentez d'ajouter un DataColumn qui contient un Expression non valide à un DataColumnCollection.

MappingException

Exception levée lors de l'échec du mappage de demandes de service connexes.

MergeFailedEventArgs

Se produit quand des DataRow cible et source ont la même valeur de clé primaire et que la propriété EnforceConstraints est définie sur true.

MetadataException

Exception levée lors de l'échec de demandes de service liées à des métadonnées.

MissingPrimaryKeyException

Représente l'exception levée lorsque vous essayez d'accéder à une ligne d'une table qui ne possède aucune clé primaire.

NoNullAllowedException

Représente l’exception qui est levée lors d’une tentative d’insertion d’une valeur Null dans une colonne où AllowDBNull a la valeur false.

ObjectNotFoundException

Exception levée lorsqu'un objet n'est pas présent.

OperationAbortedException

Cette exception est levée quand une opération en cours est abandonnée par l’utilisateur.

OptimisticConcurrencyException

Exception levée lors d'une violation d'accès concurrentiel optimiste.

OrderedEnumerableRowCollection<TRow>

Représente une collection d’objets DataRow ordonnés renvoyés par une requête.

PropertyCollection

Représente une collection de propriétés qui peuvent être ajoutées à DataColumn, DataSet, ou DataTable.

PropertyConstraintException

Classe d'exception de contrainte de propriété. Notez que cette classe a un état. Si vous modifiez même ses éléments internes, ce peut être une modification avec rupture.

ProviderIncompatibleException

Exception levée lorsque le fournisseur de données sous-jacent est incompatible avec Entity Framework.

ReadOnlyException

Représente l'exception qui est levée lorsque vous essayez de modifier la valeur d'une colonne en lecture seule.

RowNotInTableException

Représente l'exception levée lorsque vous essayez d'effectuer une opération sur un DataRow qui ne se trouve pas dans DataTable.

StateChangeEventArgs

Fournit les données de l’événement de changement d’état d’un fournisseur de données .NET.

StatementCompletedEventArgs

Fournit des informations supplémentaires pour l’événement StatementCompleted.

StrongTypingException

Exception levée par un DataSet fortement typé lorsque l'utilisateur accède à une valeur DBNull.

SyntaxErrorException

Représente l'exception levée lorsque la propriété Expression de DataColumn contient une erreur de syntaxe.

TypedDataSetGenerator

Permet de créer un DataSet fortement typé.

TypedDataSetGeneratorException

Exception levée en cas de conflit des noms lors de la génération d'un DataSet fortement typé.

TypedTableBase<T>

Ce type est utilisé comme classe de base pour la génération d’objets DataTable typés par Visual Studio et l’outil .NET Framework XSD.exe. Il n’est pas destiné à être utilisé directement à partir de votre code.

TypedTableBaseExtensions

Contient les méthodes d'extension pour la classe TypedTableBase<T>.

UniqueConstraint

Représente une restriction sur un ensemble de colonnes dans lesquelles toutes les valeurs doivent être uniques.

UpdateException

Exception levée lorsque des modifications apportées à des instances d'objet ne peuvent pas être rendues persistantes dans la source de données.

VersionNotFoundException

Représente l'exception qui est levée lorsque vous essayez de retourner une version d'un DataRow déjà supprimé.

Interfaces

IColumnMapping

Associe une colonne source de données à une colonne DataSet ; est implémenté par la classe DataColumnMapping, qui est utilisée en commun par les fournisseurs de données .NET.

IColumnMappingCollection

Contient une collection d’objets DataColumnMapping ; est implémenté par la DataColumnMappingCollection, qui est utilisée en commun par les fournisseurs de données .NET.

IDataAdapter

Permet à un objet d'implémenter DataAdapter et représente un jeu de méthodes ainsi que de propriétés liées au mappage servant à remplir et à mettre à jour DataSet ainsi qu'à mettre à jour une source de données.

Les instances IDbDataAdapter sont destinées aux sources de données qui sont (ou ressemblent à) des bases de données relationnelles avec des commandes textuelles (comme Transact-SQL) alors que les instances IDataAdapter peuvent utiliser n’importe quel type de source de données.

IDataParameter

Représente un paramètre associé à un objet Command et éventuellement son mappage avec les colonnes DataSet ; est implémenté par les fournisseurs de données .NET qui accèdent aux sources de données.

IDataParameterCollection

Collecte tous les paramètres relatifs à un objet Command et leur mappage avec les colonnes DataSet ; est implémenté par les fournisseurs de données .NET qui accèdent aux sources de données.

IDataReader

Fournit un moyen de lire un ou plusieurs flux avant uniquement de jeux de résultats obtenus en exécutant une commande sur une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

IDataRecord

Donne accès aux valeurs de colonnes de chaque ligne d’un DataReader ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

IDbCommand

Représente une instruction SQL exécutée dans le cadre de la connexion à une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

IDbConnection

Représente une connexion ouverte à une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

IDbDataAdapter

Représente un jeu de propriétés liées à des commandes qui servent à remplir le DataSet et à mettre à jour une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

IDbDataParameter

Utilisé par les concepteurs de données Visual Basic .NET pour représenter un paramètre d’un objet Command et éventuellement son mappage aux colonnes DataSet.

IDbTransaction

Représente une transaction à effectuer sur une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

IExtendedDataRecord

Permet d'accéder aux valeurs de colonne de chaque ligne de DbDataRecord pour DbDataReader.

ITableMapping

Associe une table source à une table d’un DataSet ; est implémenté par la classe DataTableMapping, qui est utilisée en commun par les fournisseurs de données .NET.

ITableMappingCollection

Contient une collection d’objets TableMapping ; est implémenté par la DataTableMappingCollection, qui est utilisée en commun par les fournisseurs de données .NET.

Énumérations

AcceptRejectRule

Détermine l’action qui se produit quand la méthode AcceptChanges() ou RejectChanges() est appelée sur DataTable avec un ForeignKeyConstraint.

CommandBehavior

Fournit une description des résultats de la requête et de ses effets sur la base de données.

CommandType

Spécifie la façon dont une chaîne de commande est interprétée.

ConflictOption

Spécifie comment les modifications en conflit avec la source de données seront détectées et résolues.

ConnectionState

Décrit l'état actuel de la connexion à une source de données.

DataRowAction

Décrit une action exécutée sur DataRow.

DataRowState

Obtient l'état d'un objet DataRow.

DataRowVersion

Décrit la version d’une DataRow.

DataSetDateTime

Décrit le format de sérialisation pour les colonnes DateTime dans DataSet.

DataViewRowState

Décrit la version des données de DataRow.

DbType

Spécifie le type de données d’un champ, d’une propriété ou d’un objet Parameter d’un fournisseur de données .NET.

EntityState

État d'un objet entité.

IsolationLevel

Spécifie le comportement de verrouillage des transactions pour la connexion.

KeyRestrictionBehavior

Identifie une liste des paramètres de chaîne de connexion identifiés par la propriété KeyRestrictions qui sont autorisés ou pas.

LoadOption

Contrôle la façon dont les valeurs de la source de données seront appliquées aux lignes existantes lors de l'utilisation de la méthode Load ou Load.

MappingType

Spécifie la façon dont un DataColumn est mappé.

MissingMappingAction

Détermine l’action qui se produit quand un mappage est manquant dans une table source ou une colonne source.

MissingSchemaAction

Spécifie l'action à effectuer lors de l'ajout de données à DataSet si le DataTable ou le DataColumn requis est absent.

ParameterDirection

Spécifie le type d’un paramètre dans une requête par rapport à DataSet.

PropertyAttributes

Spécifie les attributs d'une propriété.

Rule

Indique l’action qui se produit lors de l’application de ForeignKeyConstraint.

SchemaSerializationMode

Indique le mode de sérialisation de schéma pour un DataSet typé.

SchemaType

Spécifie la façon dont les mappages de schémas existants sont gérés lors de l’exécution d’une opération FillSchema(DataSet, SchemaType).

SerializationFormat

Détermine le format de sérialisation pour un DataSet.

SqlDbType

Spécifie le type de données spécifique à SQL Server d'un champ ou d'une propriété, à utiliser dans SqlParameter.

StatementType

Spécifie le type de requête SQL à utiliser par la classe OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgs ou SqlRowUpdatingEventArgs.

UpdateRowSource

Spécifie la façon dont les résultats des commandes de requêtes sont appliqués à la ligne en cours de mise à jour.

UpdateStatus

Spécifie l’action à effectuer concernant la ligne en cours et les lignes restantes au cours d’un Update(DataSet).

XmlReadMode

Spécifie la façon de lire les données XML et un schéma relationnel dans un DataSet.

XmlWriteMode

Spécifie la façon de lire des données XML et un schéma relationnel à partir de DataSet.

Délégués

DataColumnChangeEventHandler

Représente la méthode qui gérera l'événement ColumnChanging.

DataRowChangeEventHandler

Représente la méthode qui gérera les événements RowChanging, RowChanged, RowDeleting et RowDeleted d’un DataTable.

DataTableClearEventHandler

Représente la méthode qui gère la méthode Clear().

DataTableNewRowEventHandler

Représente la méthode qui gère la méthode NewRow().

FillErrorEventHandler

Représente la méthode qui gérera l'événement FillError.

MergeFailedEventHandler

Représente la méthode qui gérera l'événement MergeFailed.

StateChangeEventHandler

Représente la méthode qui gérera l'événement StateChange.

StatementCompletedEventHandler

Type délégué pour les gestionnaires d’événements de l’événement StatementCompleted.

Remarques

Dans un scénario déconnecté (tel qu'Internet), ADO.NET fournit les outils permettant de demander, mettre à jour et rapprocher les données de systèmes à plusieurs niveaux. L'architecture ADO.NET est également implémentée dans les applications clientes, telles que Windows Forms ou les pages HTML créées par ASP.NET.

L'élément central de l'architecture ADO.NET est la classe DataSet. Chaque DataSet peut contenir plusieurs objets DataTable (chaque DataTable contenant les données d'une source de données unique, telle que SQL Server).

Chaque DataTable contient DataColumnCollection (une collection d'objets DataColumn) qui détermine le schéma de chaque DataTable. La propriété DataType détermine le type de données contenues dans DataColumn. Les propriétés ReadOnly et AllowDBNull vous permettent de renforcer l'intégrité des données. La propriété Expression vous permet de construire des colonnes calculées.

Si DataTable participe à une relation parent/enfant avec un autre DataTable, la relation est construite en ajoutant DataRelation au DataRelationCollection d'un objet DataSet. Lorsque ce type de relation est ajouté, UniqueConstraint et ForeignKeyConstraint sont créés automatiquement, selon les paramètres du constructeur. UniqueConstraint garantit que les valeurs contenues dans une colonne sont uniques. ForeignKeyConstraint détermine l'action qui sera exécutée sur la ligne ou colonne enfant lors de la modification ou suppression de la valeur de clé primaire.

L'espace de noms System.Data.SqlClient (le fournisseur de données .NET Framework pour SQL Server), l'espace de noms System.Data.Odbc (le fournisseur de données .NET Framework pour ODBC), l'espace de noms System.Data.OleDb (le fournisseur de données .NET Framework pour OLE DB) ou l'espace de noms System.Data.OracleClient (le fournisseur de données .NET Framework pour Oracle) vous permettent d'accéder à une source de données à utiliser conjointement avec DataSet. Le fournisseur de données Each.NET Framework a un DataAdapter correspondant que vous utilisez comme pont entre une source de données et un DataSet .