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.
Fournit l’accès aux classes qui représentent l’architecture ADO.NET. ADO.NET vous permet de créer des composants qui gèrent efficacement les données à partir de plusieurs sources de données.
Classes
| Nom | Description |
|---|---|
| Constraint |
Représente une contrainte qui peut être appliquée sur un ou plusieurs DataColumn objets. |
| ConstraintCollection |
Représente une collection de contraintes pour un DataTable. |
| ConstraintException |
Représente l’exception levée lors d’une tentative d’action qui enfreint 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 un 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 parent/enfant entre deux DataTable objets. |
| DataRelationCollection |
Représente la collection d’objets DataRelation pour cet objet DataSet. |
| DataRow |
Représente une ligne de données dans un DataTable. |
| DataRowBuilder |
Le |
| DataRowChangeEventArgs |
Fournit des données pour les événements et les RowChangedévénements. RowChangingOnRowDeleting(DataRowChangeEventArgs)OnRowDeleted(DataRowChangeEventArgs) |
| DataRowCollection |
Représente une collection de lignes pour un DataTable. |
| DataRowComparer |
Retourne une instance singleton de la DataRowComparer<TRow> classe. |
| DataRowComparer<TRow> |
Compare deux DataRow objets pour l’équivalence à l’aide de la comparaison basée sur des valeurs. |
| DataRowExtensions |
Définit les méthodes d’extension à la DataRow classe. Il s’agit d’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 lors du référencement du membre. |
| DataTable |
Représente une table de données en mémoire. |
| DataTableClearEventArgs |
Fournit des données pour la Clear() méthode. |
| DataTableCollection |
Représente la collection de tables pour le DataSet. |
| DataTableExtensions |
Définit les méthodes d’extension à la DataTable classe. DataTableExtensions est une classe statique. |
| DataTableNewRowEventArgs |
Fournit des données pour la NewRow() méthode. |
| 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, accessible en liaison de données, pour le DataTable tri, le filtrage, la recherche, la modification et la navigation. Il DataView ne stocke pas de données, mais représente plutôt une vue connectée de ses données correspondantes DataTable. Les modifications apportées aux DataViewdonnées affecteront le DataTable. Les modifications apportées aux DataTabledonnées des données affectent tous les DataViewéléments associés. |
| DataViewManager |
Contient une valeur par défaut DataViewSettingCollection pour chacun DataTable d’eux dans un DataSet. |
| DataViewSetting |
Représente les paramètres par défaut pour ApplyDefaultSort, , RowStateFilterDataViewManagerRowFilter, , Sortet Table pour DataViews créés à partir du DataViewManager. |
| DataViewSettingCollection |
Contient une collection d’objets en lecture seule pour chacun d’eux DataViewSettingDataTable dans un DataSet. |
| DBConcurrencyException |
Exception levée par l’opération DataAdapter 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 une DataRow action qui a été supprimée. |
| DuplicateNameException |
Représente l’exception levée lorsqu’un nom d’objet de base de données en double est rencontré lors d’une opération d’ajout dans un DataSet objet -related. |
| EntityCommandCompilationException |
Représente les erreurs qui se produisent pendant la compilation de commandes ; lorsqu’une arborescence de commandes n’a pas pu être générée pour représenter le texte de la 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 généralement une exception spécifique au fournisseur. |
| EntityException |
Représente les erreurs liées à Entity Framework qui se produisent dans l’espace |
| EntityKey |
Fournit une référence durable à un objet qui est une instance d’un type d’entité. |
| EntityKeyMember |
Représente un nom de clé et une paire valeur qui fait partie d’un 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 violées. |
| EnumerableRowCollection |
Représente une collection d’objets DataRow retournés à partir d’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és à partir d’une requête. |
| EnumerableRowCollectionExtensions |
Contient les méthodes d’extension pour les classes de collection de lignes de données. |
| EvaluateException |
Représente l’exception levée lorsque la Expression propriété d’un DataColumn objet ne peut pas être évaluée. |
| FillErrorEventArgs |
Fournit des données pour l’événement FillError d’un DbDataAdapter. |
| ForeignKeyConstraint |
Représente une restriction d’action appliquée à un ensemble de colonnes dans une relation clé primaire/clé étrangère lorsqu’une valeur ou une ligne est supprimée ou mise à jour. |
| InRowChangingEventException |
Représente l’exception levée lorsque vous appelez la EndEdit() méthode dans l’événement RowChanging . |
| InternalDataCollectionBase |
Fournit les fonctionnalités de base pour la création de regroupements. |
| InvalidCommandTreeException |
Exception levée pour indiquer qu’une arborescence de commandes n’est pas valide. Cette exception n’est actuellement levée nulle part dans Entity Framework. |
| InvalidConstraintException |
Représente l’exception levée lors d’une tentative incorrecte de création ou d’accès à une relation. |
| InvalidExpressionException |
Représente l’exception levée lorsque vous essayez d’ajouter un DataColumn qui contient un non valide Expression à un DataColumnCollection. |
| MappingException |
Exception levée lors de l’échec du mappage des demandes de service associées. |
| MergeFailedEventArgs |
Se produit lorsqu’une cible et une source |
| MetadataException |
Exception levée lorsque les requêtes de service associées aux métadonnées échouent. |
| MissingPrimaryKeyException |
Représente l’exception levée lorsque vous essayez d’accéder à une ligne d’une table qui n’a pas de clé primaire. |
| NoNullAllowedException |
Représente l’exception levée lorsque vous essayez d’insérer une valeur Null dans une colonne sur laquelle AllowDBNull la valeur est définie |
| ObjectNotFoundException |
Exception levée lorsqu’un objet n’est pas présent. |
| OperationAbortedException |
Cette exception est levée lorsqu’une opération en cours est abandonnée par l’utilisateur. |
| OptimisticConcurrencyException |
Exception levée lorsqu’une violation d’accès concurrentiel optimiste se produit. |
| OrderedEnumerableRowCollection<TRow> |
Représente une collection d’objets ordonnés DataRow retournés à partir d’une requête. |
| PropertyCollection |
Représente une collection de propriétés qui peuvent être ajoutées à DataColumn, DataSetou DataTable. |
| PropertyConstraintException |
Classe d’exception de contrainte de propriété. Notez que cette classe a un état. Par conséquent, si vous modifiez même ses éléments internes, il peut s’agir d’un changement cassant. |
| ProviderIncompatibleException |
Exception levée lorsque le fournisseur de données sous-jacent est incompatible avec Entity Framework. |
| ReadOnlyException |
Représente l’exception 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 élément qui n’est pas dans un DataTable. |
| StateChangeEventArgs |
Fournit des données pour l’événement de modification 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 type fortement typé DataSet lorsque l’utilisateur accède à une |
| SyntaxErrorException |
Représente l’exception levée lorsque la Expression propriété d’un DataColumn objet contient une erreur de syntaxe. |
| TypedDataSetGenerator |
Utilisé pour créer un type fortement typé DataSet. |
| TypedDataSetGeneratorException |
Exception levée lorsqu’un conflit de noms se produit lors de la génération d’un type fortement typé DataSet. |
| TypedTableBase<T> |
Ce type est utilisé comme classe de base pour la génération d’objets typésDataTable par Visual Studio et l’outil .NET Framework XSD.exe et n’est pas destiné à être utilisé directement à partir de votre code. |
| TypedTableBaseExtensions |
Contient les méthodes d’extension de la TypedTableBase<T> classe. |
| UniqueConstraint |
Représente une restriction sur un ensemble de colonnes dans lequel toutes les valeurs doivent être uniques. |
| UpdateException |
Exception levée lorsque les modifications apportées aux instances d’objet ne peuvent pas être conservées dans la source de données. |
| VersionNotFoundException |
Représente l’exception levée lorsque vous essayez de retourner une version d’un DataRow qui a été supprimée. |
Interfaces
| Nom | Description |
|---|---|
| IColumnMapping |
Associe une colonne de source de données à une DataSet colonne et est implémentée par la DataColumnMapping classe, qui est utilisée en commun par les fournisseurs de données .NET. |
| IColumnMappingCollection |
Contient une collection d’objets DataColumnMapping et est implémentée par le DataColumnMappingCollection, qui est utilisé en commun par les fournisseurs de données .NET. |
| IDataAdapter |
Permet à un objet d’implémenter un DataAdapter et représente un ensemble de méthodes et de propriétés liées à l’action de mappage utilisées pour remplir et mettre à jour une DataSet source de données et la mettre à jour. IDbDataAdapter les instances 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), tandis que IDataAdapter les instances peuvent utiliser n’importe quel type de source de données. |
| IDataParameter |
Représente un paramètre pour un objet Command, et éventuellement, son mappage aux DataSet colonnes ; et est implémenté par les fournisseurs de données .NET qui accèdent aux sources de données. |
| IDataParameterCollection |
Collecte tous les paramètres pertinents pour un objet Command et leurs mappages aux DataSet colonnes, et 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 de résultats avant uniquement obtenus en exécutant une commande à une source de données et implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles. |
| IDataRecord |
Fournit l’accès aux valeurs de colonne dans chaque ligne d’un |
| IDbCommand |
Représente une instruction SQL exécutée lors de la connexion à une source de données et implémentée 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 et est implémentée par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles. |
| IDbDataAdapter |
Représente un ensemble de propriétés liées à la commande utilisées pour remplir et DataSet mettre à jour une source de données et 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 .NET Visual Basic pour représenter un paramètre à un objet Command, et éventuellement, son mappage aux DataSet colonnes. |
| IDbTransaction |
Représente une transaction à effectuer à une source de données et est implémentée par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles. |
| IExtendedDataRecord |
Fournit l’accès aux valeurs de colonne dans chaque ligne d’un DbDataRecord pour un DbDataReader. |
| ITableMapping |
Associe une table source à une table dans un DataSet, et est implémentée par la DataTableMapping classe, qui est utilisée en commun par les fournisseurs de données .NET. |
| ITableMappingCollection |
Contient une collection d’objets TableMapping et est implémentée par le DataTableMappingCollection, qui est utilisé en commun par les fournisseurs de données .NET. |
Énumérations
| Nom | Description |
|---|---|
| AcceptRejectRule |
Détermine l’action qui se produit lorsque la méthode AcceptChanges() ou RejectChanges() est appelée sur un DataTable avec un ForeignKeyConstraint. |
| CommandBehavior |
Fournit une description des résultats de la requête et de son effet 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 la façon dont les modifications conflictuelles apportées à la source de données sont 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 effectuée sur un DataRow. |
| DataRowState |
Obtient l’état d’un objet DataRow. |
| DataRowVersion |
Décrit la version d’un DataRow. |
| DataSetDateTime |
Décrit le format de sérialisation des colonnes DateTime dans un DataSet. |
| DataViewRowState |
Décrit la version des données dans un 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 d’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 comment une DataColumn est mappée. |
| MissingMappingAction |
Détermine l’action qui se produit lorsqu’un mappage est manquant à partir d’une table source ou d’une colonne source. |
| MissingSchemaAction |
Spécifie l’action à entreprendre lors de l’ajout de données au DataSet et le DataTable ou DataColumn requis est manquant. |
| ParameterDirection |
Spécifie le type d’un paramètre dans une requête par rapport au DataSet. |
| PropertyAttributes |
Spécifie les attributs d’une propriété. |
| Rule |
Indique l’action qui se produit lorsqu’une ForeignKeyConstraint est appliquée. |
| SchemaSerializationMode |
Indique le mode de sérialisation du schéma pour un DataSettypé . |
| SchemaType |
Spécifie comment gérer les mappages de schémas existants lors de l’exécution d’une opération de FillSchema(DataSet, SchemaType). |
| SerializationFormat |
Détermine le format de sérialisation d’un DataSet. |
| SqlDbType |
Spécifie le type de données spécifique à SQL Server d’un champ, d’une propriété, à utiliser dans un SqlParameter. |
| StatementType |
Spécifie le type de requête SQL à utiliser par la classe OleDbRowUpdatedEventArgs, OleDbRowUpdatingEventArgs, SqlRowUpdatedEventArgsou SqlRowUpdatingEventArgs. |
| UpdateRowSource |
Spécifie comment les résultats de la commande de requête sont appliqués à la ligne mise à jour. |
| UpdateStatus |
Spécifie l’action à entreprendre en ce qui concerne les lignes actuelles et restantes pendant une Update(DataSet). |
| XmlReadMode |
Spécifie comment lire des données XML et un schéma relationnel dans un DataSet. |
| XmlWriteMode |
Spécifie comment écrire des données XML et un schéma relationnel à partir d’un DataSet. |
Délégués
| Nom | Description |
|---|---|
| DataColumnChangeEventHandler |
Représente la méthode qui gère l’événement ColumnChanging . |
| DataRowChangeEventHandler |
Représente la méthode qui gère les RowChangingévénements , et RowDeletingRowChangedRowDeleted les événements d’un DataTable. |
| DataTableClearEventHandler |
Représente la méthode qui gère la Clear() méthode. |
| DataTableNewRowEventHandler |
Représente la méthode qui gère la NewRow() méthode. |
| FillErrorEventHandler |
Représente la méthode qui gère l’événement FillError . |
| MergeFailedEventHandler |
Représente la méthode qui gère l’événement MergeFailed . |
| StateChangeEventHandler |
Représente la méthode qui gère l’événement StateChange . |
| StatementCompletedEventHandler |
Type de délégué pour les gestionnaires d’événements de l’événement StatementCompleted . |
Remarques
Dans un scénario déconnecté comme Internet, ADO.NET fournit les outils permettant de demander, de mettre à jour et de rapprocher les données dans plusieurs systèmes de niveau. 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.
La pièce centrale de l’architecture ADO.NET est la DataSet classe. Chacun DataSet peut contenir plusieurs DataTable objets, chacun DataTable contenant des données provenant d’une seule source de données, comme SQL Server.
Chacun DataTable contient une DataColumnCollectioncollection d’objets DataColumn - qui détermine le schéma de chaque DataTableobjet . La DataType propriété détermine le type de données détenues par le DataColumn. Les ReadOnly propriétés et AllowDBNull les propriétés vous permettent de garantir davantage l’intégrité des données. La Expression propriété vous permet de construire des colonnes calculées.
Si un DataTable membre participe à une relation parent/enfant avec un autre DataTable, la relation est construite en ajoutant un DataRelation à l’objet DataRelationCollectionDataSet . Lorsqu’une telle relation est ajoutée, une UniqueConstraint et une ForeignKeyConstraint sont créées automatiquement, en fonction des paramètres du constructeur. Les UniqueConstraint garanties que les valeurs contenues dans une colonne sont uniques. Détermine ForeignKeyConstraint l’action qui arrivera à la ligne ou à la colonne enfant lorsqu’une valeur de clé primaire est modifiée ou supprimée.
À l’aide de l’espace System.Data.SqlClient de noms (the.NET Framework Data Provider for SQL Server), de l’espace System.Data.Odbc de noms (the.NET Framework Data Provider for ODBC), de l’espace System.Data.OleDb de noms (the.NET Framework Data Provider for OLE DB) ou de l’espace System.Data.OracleClient de noms (le fournisseur de données .NET Framework pour Oracle), vous pouvez accéder à une source de données à utiliser avec un 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.