OdbcDataAdapter Classe
Définition
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.
Représente un ensemble de commandes de données et une connexion à une source de données qui sont utilisées pour remplir DataSet et mettre à jour la source de données. Cette classe ne peut pas être héritée.
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable, System::Data::IDbDataAdapter
public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable, System.Data.IDbDataAdapter
public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDbDataAdapter
interface IDataAdapter
interface ICloneable
type OdbcDataAdapter = class
inherit DbDataAdapter
interface IDataAdapter
interface IDbDataAdapter
interface ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable, IDbDataAdapter
Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
- Héritage
- Implémente
Exemples
L’exemple suivant utilise OdbcCommand, OdbcDataAdapteret OdbcConnection pour sélectionner des enregistrements et remplir un DataSet
avec les lignes sélectionnées.
public DataSet GetDataSetFromAdapter(
DataSet dataSet, string connectionString, string queryString)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
OdbcDataAdapter adapter =
new OdbcDataAdapter(queryString, connection);
// Open the connection and fill the DataSet.
try
{
connection.Open();
adapter.Fill(dataSet);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
return dataSet;
}
Public Function GetDataSetFromAdapter( _
ByVal dataSet As DataSet, ByVal connectionString As String, _
ByVal queryString As String) As DataSet
Using connection As New OdbcConnection(connectionString)
Dim adapter As New OdbcDataAdapter(queryString, connection)
' Open the connection and fill the DataSet.
Try
connection.Open()
adapter.Fill(dataSet)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
Return dataSet
End Function
Remarques
sert OdbcDataAdapter de pont entre une DataSet
source de données et pour récupérer et enregistrer des données. fournit OdbcDataAdapter ce pont en utilisant Fill pour charger des données de la source de données dans le DataSet, et en utilisant Update pour envoyer les modifications apportées dans le DataSet retour à la source de données.
Lorsque le OdbcDataAdapter remplit un DataSet, il crée les tables et les colonnes requises pour les données retournées s’ils n’existent pas déjà. Toutefois, les informations de clé primaire ne sont pas incluses dans le schéma créé implicitement, sauf si la propriété a la MissingSchemaAction valeur AddWithKey. Vous pouvez également créer le OdbcDataAdapter schéma de , y compris les informations de clé primaire, avant de le remplir de données à l’aide DataSetFillSchemade . Pour plus d’informations, consultez Ajout de contraintes existantes à un DataSet.
Notes
Lorsque vous appelez la Fill
méthode sur une source de données qui n’a pas de colonne clé primaire, le OdbcDataAdapter tente de promouvoir la colonne de contrainte unique sur la clé primaire. Dans le processus, marque OdbcDataAdapter la contrainte unique comme non nullable. Ce comportement fonctionne, sauf s’il existe une valeur null dans la colonne de contrainte unique. S’il existe une valeur null, la Fill
méthode échoue avec une violation de contrainte. Pour éviter cette situation, n’autorisez pas les valeurs null dans la colonne de contrainte unique.
Notes
En raison des limitations des pilotes ODBC natifs, un DataTable seul est retourné lorsque vous appelez FillSchema. Cela est vrai même lors de l’exécution d’instructions sql batch à partir desquelles plusieurs DataTable objets sont attendus.
inclut OdbcDataAdapter également les propriétés , InsertCommand, DeleteCommand, UpdateCommandet TableMappings
pour faciliter le SelectCommandchargement et la mise à jour des données.
Constructeurs
OdbcDataAdapter() |
Initialise une nouvelle instance de la classe OdbcDataAdapter. |
OdbcDataAdapter(OdbcCommand) |
Initialise une nouvelle instance de la classe OdbcDataAdapter avec l'instruction SQL SELECT spécifiée. |
OdbcDataAdapter(String, OdbcConnection) |
Initialise une nouvelle instance de la classe OdbcDataAdapter avec une instruction SQL SELECT et OdbcConnection. |
OdbcDataAdapter(String, String) |
Initialise une nouvelle instance de la classe OdbcDataAdapter avec une instruction SQL SELECT et une chaîne de connexion. |
Champs
DefaultSourceTableName |
Nom par défaut utilisé par l'objet DataAdapter pour les mappages de table. (Hérité de DbDataAdapter) |
Propriétés
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. (Hérité de DataAdapter) |
AcceptChangesDuringUpdate |
Obtient ou définit si AcceptChanges() est appelé pendant un Update(DataSet). (Hérité de DataAdapter) |
CanRaiseEvents |
Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component) |
Container |
Obtient le IContainer qui contient la Component. (Hérité de Component) |
ContinueUpdateOnError |
Obtient ou définit une valeur qui spécifie si une exception doit être générée en cas d'erreur pendant la mise à jour d'une ligne. (Hérité de DataAdapter) |
DeleteCommand |
Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour supprimer des enregistrements dans la source de données. |
DesignMode |
Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component) |
Events |
Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component) |
FillCommandBehavior |
Obtient ou définit le comportement de la commande utilisée pour remplir l'adaptateur de données. (Hérité de DbDataAdapter) |
FillLoadOption |
Obtient ou définit LoadOption qui détermine comment l'adaptateur remplit DataTable du DbDataReader. (Hérité de DataAdapter) |
InsertCommand |
Récupère ou définit une instruction SQL ou une procédure stockée utilisée pour insérer de nouveaux enregistrements dans la source de données. |
MissingMappingAction |
Détermine l'action à effectuer si les données entrantes ne possèdent pas de table ou de colonne correspondante. (Hérité de DataAdapter) |
MissingSchemaAction |
Détermine l'action à effectuer si le schéma DataSet existant ne correspond pas aux données entrantes. (Hérité de DataAdapter) |
ReturnProviderSpecificTypes |
Obtient ou définit si la méthode |
SelectCommand |
Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour sélectionner des enregistrements dans la source de données. |
Site |
Obtient ou définit le ISite de Component. (Hérité de Component) |
TableMappings |
Obtient une collection qui fournit le mappage principal entre une table source et un DataTable. (Hérité de DataAdapter) |
UpdateBatchSize |
Obtient ou définit une valeur qui active ou désactive la prise en charge du traitement par lots et qui spécifie le nombre de commandes pouvant être exécutées dans un lot. (Hérité de DbDataAdapter) |
UpdateCommand |
Obtient ou définit une instruction SQL ou une procédure stockée utilisée pour mettre à jour les enregistrements dans la source de données. |
Méthodes
AddToBatch(IDbCommand) |
Ajoute IDbCommand au lot actuel. (Hérité de DbDataAdapter) |
ClearBatch() |
Supprime tous les objets IDbCommand du lot. (Hérité de DbDataAdapter) |
CloneInternals() |
Obsolète.
Obsolète.
Obsolète.
Obsolète.
Crée une copie de cette instance de DataAdapter. (Hérité de DataAdapter) |
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. (Hérité de MarshalByRefObject) |
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Initialise une nouvelle instance de la classe RowUpdatedEventArgs. (Hérité de DbDataAdapter) |
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping) |
Initialise une nouvelle instance de la classe RowUpdatingEventArgs. (Hérité de DbDataAdapter) |
CreateTableMappings() |
Crée un DataTableMappingCollection. (Hérité de DataAdapter) |
Dispose() |
Libère toutes les ressources utilisées par Component. (Hérité de Component) |
Dispose(Boolean) |
Libère les ressources non managées utilisées par DbDataAdapter et libère éventuellement les ressources managées. (Hérité de DbDataAdapter) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
ExecuteBatch() |
Exécute le lot actuel. (Hérité de DbDataAdapter) |
Fill(DataSet) |
Ajoute ou actualise des lignes dans le DataSet. (Hérité de DbDataAdapter) |
Fill(DataSet, Int32, Int32, String) |
Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable. (Hérité de DbDataAdapter) |
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) |
Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant DataSet et les noms de tables source, la chaîne de commande et le comportement des commandes. (Hérité de DbDataAdapter) |
Fill(DataSet, String) |
Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable. (Hérité de DbDataAdapter) |
Fill(DataSet, String, IDataReader, Int32, Int32) |
Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour les faire correspondre à celles de la source de données en utilisant les noms DataSet, DataTable et IDataReader. (Hérité de DbDataAdapter) |
Fill(DataTable) |
Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données, en utilisant le nom DataTable. (Hérité de DbDataAdapter) |
Fill(DataTable, IDataReader) |
Ajoute ou actualise les lignes d’un DataTable pour les faire correspondre dans la source de données en utilisant les noms DataTable et IDataReader spécifiés. (Hérité de DbDataAdapter) |
Fill(DataTable, IDbCommand, CommandBehavior) |
Ajoute ou actualise les lignes de DataTable pour établir une correspondance avec celles de la source de données à l'aide des DataTable, IDbCommand et CommandBehavior spécifiés. (Hérité de DbDataAdapter) |
Fill(DataTable[], IDataReader, Int32, Int32) |
Ajoute ou actualise des lignes d'une plage spécifiée de la collection d'objets DataTable pour qu'elles correspondent à celles de la source de données. (Hérité de DataAdapter) |
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior) |
Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable. (Hérité de DbDataAdapter) |
Fill(Int32, Int32, DataTable[]) |
Ajoute ou actualise les lignes d’un ou plusieurs DataTable objets pour qu’elles correspondent à celles de la source de données en commençant à l’enregistrement spécifié et en récupérant jusqu’au nombre maximal d’enregistrements spécifié. (Hérité de DbDataAdapter) |
FillSchema(DataSet, SchemaType) |
Ajoute un DataTable appelé "Table" au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur le SchemaType spécifié. (Hérité de DbDataAdapter) |
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) |
Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur le SchemaType défini. (Hérité de DbDataAdapter) |
FillSchema(DataSet, SchemaType, String) |
Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu'il corresponde à celui de la source de données en se basant sur les SchemaType et DataTable définis. (Hérité de DbDataAdapter) |
FillSchema(DataSet, SchemaType, String, IDataReader) |
Ajoute DataTable au DataSet spécifié. (Hérité de DataAdapter) |
FillSchema(DataTable, SchemaType) |
Configure le schéma du DataTable spécifié en fonction du SchemaType défini. (Hérité de DbDataAdapter) |
FillSchema(DataTable, SchemaType, IDataReader) |
Ajoute DataTable au DataSet spécifié. (Hérité de DataAdapter) |
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) |
Configure le schéma du DataTable spécifié en fonction du SchemaType, de la chaîne de commande et des valeurs CommandBehavior définis. (Hérité de DbDataAdapter) |
GetBatchedParameter(Int32, Int32) |
Retourne IDataParameter à partir de l'une des commandes du lot actuel. (Hérité de DbDataAdapter) |
GetBatchedRecordsAffected(Int32, Int32, Exception) |
Retourne les informations relatives à une tentative de mise à jour distincte dans le cadre plus large d'une mise à jour groupée. (Hérité de DbDataAdapter) |
GetFillParameters() |
Obtient les paramètres définis par l'utilisateur lors de l'exécution d'une instruction SQL SELECT. (Hérité de DbDataAdapter) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetLifetimeService() |
Obsolète.
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. (Hérité de MarshalByRefObject) |
GetService(Type) |
Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
HasTableMappings() |
Indique si DataTableMappingCollection a été créé. (Hérité de DataAdapter) |
InitializeBatching() |
Initialise le mode batch pour DbDataAdapter. (Hérité de DbDataAdapter) |
InitializeLifetimeService() |
Obsolète.
Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
MemberwiseClone(Boolean) |
Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject) |
OnFillError(FillErrorEventArgs) |
Déclenche l’événement FillError. (Hérité de DbDataAdapter) |
OnRowUpdated(RowUpdatedEventArgs) |
Déclenche l’événement |
OnRowUpdating(RowUpdatingEventArgs) |
Déclenche l’événement |
ResetFillLoadOption() |
Réinitialise FillLoadOption à son état par défaut et entraîne une réponse de Fill(DataSet) à AcceptChangesDuringFill. (Hérité de DataAdapter) |
ShouldSerializeAcceptChangesDuringFill() |
Détermine si la propriété AcceptChangesDuringFill doit être persistante. (Hérité de DataAdapter) |
ShouldSerializeFillLoadOption() |
Détermine si la propriété FillLoadOption doit être persistante. (Hérité de DataAdapter) |
ShouldSerializeTableMappings() |
Détermine si un ou plusieurs objets DataTableMapping existent et s'ils doivent être persistants. (Hérité de DataAdapter) |
TerminateBatching() |
Termine le mode batch pour DbDataAdapter. (Hérité de DbDataAdapter) |
ToString() |
Retourne un String contenant le nom du Component, s’il en existe un. Cette méthode ne doit pas être remplacée. (Hérité de Component) |
Update(DataRow[]) |
Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans DataSet. (Hérité de DbDataAdapter) |
Update(DataRow[], DataTableMapping) |
Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le tableau d'objets DataRow spécifié. (Hérité de DbDataAdapter) |
Update(DataSet) |
Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le DataSet spécifié. (Hérité de DbDataAdapter) |
Update(DataSet, String) |
Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans DataSet avec le nom DataTable spécifié. (Hérité de DbDataAdapter) |
Update(DataTable) |
Met à jour les valeurs de la base de données en exécutant les instructions INSERT, UPDATE ou DELETE respectives pour chaque ligne insérée, mise à jour ou supprimée dans le DataTable spécifié. (Hérité de DbDataAdapter) |
Événements
Disposed |
Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component) |
FillError |
Retourné lorsqu'une erreur se produit pendant une opération de remplissage. (Hérité de DbDataAdapter) |
RowUpdated |
Se produit lors d'une opération de mise à jour après l'exécution d'une commande sur la source de données. |
RowUpdating |
Se produit pendant une opération de Update(DataSet), avant l'exécution d'une commande sur la source de données. |
Implémentations d’interfaces explicites
ICloneable.Clone() |
Pour obtenir une description de ce membre, consultez Clone(). |
IDataAdapter.TableMappings |
Obtient une collection qui indique comment une table source est mappée à une table de jeu de données. (Hérité de DataAdapter) |
IDbDataAdapter.DeleteCommand |
Pour obtenir une description de ce membre, consultez DeleteCommand. |
IDbDataAdapter.InsertCommand |
Pour obtenir une description de ce membre, consultez InsertCommand. |
IDbDataAdapter.SelectCommand |
Pour obtenir une description de ce membre, consultez SelectCommand. |
IDbDataAdapter.UpdateCommand |
Pour obtenir une description de ce membre, consultez UpdateCommand. |