System.Data Espace de noms
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.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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é |
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. Each.NET fournisseur de données Framework a un DataAdapter correspondant que vous utilisez comme pont entre une source de données et un DataSet.