DataAdapter DataAdapter DataAdapter DataAdapter Class

Définition

Représente un ensemble de commandes SQL et une connexion de base de données qui sont utilisées pour remplir DataSet et mettre à jour la source de données.Represents a set of SQL commands and a database connection that are used to fill the DataSet and update the data source.

public ref class DataAdapter : System::ComponentModel::Component, System::Data::IDataAdapter
public class DataAdapter : System.ComponentModel.Component, System.Data.IDataAdapter
type DataAdapter = class
    inherit Component
    interface IDataAdapter
Public Class DataAdapter
Inherits Component
Implements IDataAdapter
Héritage
Dérivé
Implémente

Remarques

Le DataAdapter fait Office de pont entre une DataSet et une source de données pour la récupération et l’enregistrement des données.The DataAdapter serves as a bridge between a DataSet and a data source for retrieving and saving data. Le DataAdapter fournit ce pont en mappant Fill, qui modifie les données dans le DataSet faire correspondre les données dans la source de données, et Update, ce qui modifie les données dans la source de données pour faire correspondre les données dans le DataSet.The DataAdapter provides this bridge by mapping Fill, which changes the data in the DataSet to match the data in the data source, and Update, which changes the data in the data source to match the data in the DataSet.

Si vous vous connectez à une base de données SQL Server, vous pouvez augmenter les performances globales à l’aide de la SqlDataAdapter associés SqlCommand et SqlConnection objets.If you are connecting to a SQL Server database, you can increase overall performance by using the SqlDataAdapter along with its associated SqlCommand and SqlConnection objects. Pour les sources de données pris en charge OLE DB, utilisez le DataAdapter avec associées OleDbCommand et OleDbConnection objets.For OLE DB-supported data sources, use the DataAdapter with its associated OleDbCommand and OleDbConnection objects. Pour les sources de données pris en charge par ODBC, utilisez le DataAdapter avec associées OdbcCommand et OdbcConnection objets.For ODBC-supported data sources, use the DataAdapter with its associated OdbcCommand and OdbcConnection objects. Pour les bases de données Oracle, utilisez le DataAdapter avec associées OracleCommand et OracleConnection objets.For Oracle databases, use the DataAdapter with its associated OracleCommand and OracleConnection objects.

Lorsqu’une instance de DataAdapter est créé, la lecture/écriture propriétés sont définies sur les valeurs initiales.When an instance of DataAdapter is created, the read/write properties are set to initial values. Pour obtenir la liste de ces valeurs, consultez le DataAdapter constructeur.For a list of these values, see the DataAdapter constructor.

Constructeurs

DataAdapter() DataAdapter() DataAdapter() DataAdapter()

Initialise une nouvelle instance d'une classe DataAdapter.Initializes a new instance of a DataAdapter class.

DataAdapter(DataAdapter) DataAdapter(DataAdapter) DataAdapter(DataAdapter) DataAdapter(DataAdapter)

Initialise une nouvelle instance d’un DataAdapter classe à partir d’un objet existant du même type.Initializes a new instance of a DataAdapter class from an existing object of the same type.

Propriétés

AcceptChangesDuringFill AcceptChangesDuringFill AcceptChangesDuringFill AcceptChangesDuringFill

Obtient ou définit une valeur indiquant si AcceptChanges() est appelé sur un DataRow après son ajout à DataTable au cours de l’une des opérations Fill.Gets or sets a value indicating whether AcceptChanges() is called on a DataRow after it is added to the DataTable during any of the Fill operations.

AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate AcceptChangesDuringUpdate

Obtient ou définit si AcceptChanges() est appelé pendant un Update(DataSet).Gets or sets whether AcceptChanges() is called during a Update(DataSet).

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtient le IContainer qui contient Component.Gets the IContainer that contains the Component.

(Inherited from Component)
ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError ContinueUpdateOnError

Obtient ou définit une valeur qui spécifie si pour générer une exception lorsqu’une erreur survient pendant une mise à jour de la ligne.Gets or sets a value that specifies whether to generate an exception when an error is encountered during a row update.

DesignMode DesignMode DesignMode DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

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

(Inherited from Component)
FillLoadOption FillLoadOption FillLoadOption FillLoadOption

Obtient ou définit le LoadOption qui détermine comment l’adaptateur remplit le DataTable à partir de la DbDataReader.Gets or sets the LoadOption that determines how the adapter fills the DataTable from the DbDataReader.

MissingMappingAction MissingMappingAction MissingMappingAction MissingMappingAction

Détermine l’action à entreprendre lorsque les données entrantes ne dispose pas d’une table ou une colonne correspondante.Determines the action to take when incoming data does not have a matching table or column.

MissingSchemaAction MissingSchemaAction MissingSchemaAction MissingSchemaAction

Détermine l’action à entreprendre lorsque le schéma DataSet schéma ne correspond pas aux données entrantes.Determines the action to take when existing DataSet schema does not match incoming data.

ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes ReturnProviderSpecificTypes

Obtient ou définit si le Fill méthode doit retourner des valeurs spécifiques au fournisseur ou des valeurs communes conformes CLS.Gets or sets whether the Fill method should return provider-specific values or common CLS-compliant values.

Site Site Site Site

Obtient ou définit le ISite de Component.Gets or sets the ISite of the Component.

(Inherited from Component)
TableMappings TableMappings TableMappings TableMappings

Obtient une collection qui fournit le mappage principal entre une table source et un DataTable.Gets a collection that provides the master mapping between a source table and a DataTable.

Méthodes

CloneInternals() CloneInternals() CloneInternals() CloneInternals()

Crée une copie de cette instance de DataAdapter.Creates a copy of this instance of DataAdapter.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateTableMappings() CreateTableMappings() CreateTableMappings() CreateTableMappings()

Crée un DataTableMappingCollection.Creates a new DataTableMappingCollection.

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

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

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)
Fill(DataSet) Fill(DataSet) Fill(DataSet) Fill(DataSet)

Ajoute ou actualise des lignes dans le DataSet correspondre à ceux de la source de données.Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée dans le DataSet correspondre à ceux de la source de données en utilisant le DataSet et DataTable noms.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)

Ajoute ou actualise des lignes dans le DataTable correspondre à ceux de la source de données en utilisant le DataTable spécifié et nom IDataReader.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée dans la collection de DataTable objets correspondent à celles de la source de données.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType) FillSchema(DataSet, SchemaType)

Ajoute un DataTable spécifié DataSet et configure le schéma pour correspondre à celui de la source de données en fonction spécifié SchemaType.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader) FillSchema(DataSet, SchemaType, String, IDataReader)

Ajoute un DataTable spécifié DataSet.Adds a DataTable to the specified DataSet.

FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader) FillSchema(DataTable, SchemaType, IDataReader)

Ajoute un DataTable spécifié DataSet.Adds a DataTable to the specified DataSet.

GetFillParameters() GetFillParameters() GetFillParameters() GetFillParameters()

Obtient les paramètres définis par l’utilisateur lors de l’exécution d’une instruction SQL SELECT.Gets the parameters set by the user when executing an SQL SELECT statement.

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

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
HasTableMappings() HasTableMappings() HasTableMappings() HasTableMappings()

Indique si un DataTableMappingCollection a été créé.Indicates whether a DataTableMappingCollection has been created.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
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)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs) OnFillError(FillErrorEventArgs)

Appelé lorsqu’une erreur se produit pendant une Fill.Invoked when an error occurs during a Fill.

ResetFillLoadOption() ResetFillLoadOption() ResetFillLoadOption() ResetFillLoadOption()

Réinitialise FillLoadOption à son état par défaut et les causes Fill(DataSet) d’honorer AcceptChangesDuringFill.Resets FillLoadOption to its default state and causes Fill(DataSet) to honor AcceptChangesDuringFill.

ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill() ShouldSerializeAcceptChangesDuringFill()

Détermine si le AcceptChangesDuringFill propriété doit être persistante.Determines whether the AcceptChangesDuringFill property should be persisted.

ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption() ShouldSerializeFillLoadOption()

Détermine si le FillLoadOption propriété doit être persistante.Determines whether the FillLoadOption property should be persisted.

ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings() ShouldSerializeTableMappings()

Détermine si un ou plusieurs DataTableMapping objets existent et qu’ils doivent être persistants.Determines whether one or more DataTableMapping objects exist and they 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 Component)
Update(DataSet) Update(DataSet) Update(DataSet) Update(DataSet)

Appelle les instructions INSERT, UPDATE ou DELETE respectives pour chaque inséré, mis à jour ou supprimé la ligne dans le texte spécifié DataSet à partir d’un DataTable nommé « Table ».Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified DataSet from a DataTable named "Table."

Événements

Disposed Disposed Disposed Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
FillError FillError FillError FillError

Retourné lorsqu’une erreur se produit pendant une opération de remplissage.Returned when an error occurs during a fill operation.

Implémentations d’interfaces explicites

IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings IDataAdapter.TableMappings

Indique comment une table source est mappée à une table de dataset.Indicates how a source table is mapped to a dataset table.

S’applique à

Voir aussi