Partager via


System.Data Espace de noms

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 DataRowBuilder type prend en charge l’infrastructure .NET et n’est pas destiné à être utilisé directement à partir de votre code.

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 EntityClient de noms. Il EntityException s’agit de la classe de base pour toutes les exceptions Entity Framework levées par le EntityClient.

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 DataRow ont la même valeur de clé primaire et que la propriété a la EnforceConstraints valeur true.

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

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 DBNull valeur.

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 DataReader, et 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 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 Parameter d’un fournisseur de données .NET.

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é KeyRestrictions autorisée ou non autorisée.

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.