OracleCommandBuilder Classe

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Attention

OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Génère automatiquement des commandes de table simple utilisées pour harmoniser les modifications apportées à DataSet avec la base de données associée. Cette classe ne peut pas être héritée.

public ref class OracleCommandBuilder sealed : System::Data::Common::DbCommandBuilder

[System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommandBuilder : System.Data.Common.DbCommandBuilder

[<System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder

Héritage

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

Attributs

ObsoleteAttribute

Exemples

L’exemple suivant utilise OracleCommand, avec OracleDataAdapter et OracleConnection, pour sélectionner des lignes à partir d’une base de données. L’exemple est transmis à un chaîne de connexion initialiséDataSet, une chaîne de requête qui est une instruction SELECT SQL et une chaîne qui est le nom de la table de base de données. L’exemple crée ensuite un OracleCommandBuilder.

Private Function SelectOracleRows(connection As String, queryString As String, tableName As String) As DataSet  

   Dim connection As New OracleConnection(connection)  
   Dim dataAdapter As New OracleDataAdapter()  
   Dim dataSet As DataSet = New DataSet  

   dataAdapter.SelectCommand = New OracleCommand(queryString, connection)  

   Dim cmdBuilder As OracleCommandBuilder = New OracleCommandBuilder(dataAdapter)  

   connection.Open()  
   dataAdapter.Fill(dataSet, tableName)  
      ' Code to modify data in DataSet here   
      ' Without the OracleCommandBuilder this line would fail.  
   dataAdapter.Update(dataSet, tableName)  
   connection.Close()  
End Function  

public static DataSet SelectOracleSrvRows(string myConnection, string mySelectQuery, string myTableName)  
{  
   OracleConnection myConn = new OracleConnection(myConnection);  
   OracleDataAdapter myDataAdapter = new OracleDataAdapter();  
   myDataAdapter.SelectCommand = new OracleCommand(mySelectQuery, myConn);  
   OracleCommandBuilder cb = new OracleCommandBuilder(myDataAdapter);  

   myConn.Open();  
   DataSet ds = new DataSet();  
   myDataAdapter.Fill(ds, myTableName);  

   //Code to modify data in DataSet goes here...  

   //Without the OracleCommandBuilder this line would fail.  
   myDataAdapter.Update(ds, myTableName);  
   myConn.Close();  
   return ds;  
}  

Remarques

Ce type est déconseillé et sera supprimé dans une prochaine version du .NET Framework. Pour plus d’informations, consultez Oracle et ADO.NET.

ne OracleDataAdapter génère pas automatiquement les instructions SQL nécessaires pour rapprocher les modifications apportées à un DataSet associé à la base de données. Toutefois, vous pouvez créer un objet qui génère des OracleCommandBuilder instructions SQL pour les mises à jour d’une table unique en définissant la SelectCommand propriété de .OracleDataAdapter Ensuite, le OracleCommandBuilder génère toutes les instructions SQL supplémentaires que vous ne définissez pas.

La relation entre un OracleDataAdapter et son correspondant OracleCommandBuilder est toujours un-à-un. Pour créer cette correspondance, vous définissez la OracleDataAdapter propriété de l’objet OracleCommandBuilder . Cela entraîne l’inscription OracleCommandBuilder de lui-même en tant qu’écouteur, ce qui produit la sortie des RowUpdating événements qui affectent le DataSet.

Pour générer des instructions INSERT, UPDATE ou DELETE, le OracleCommandBuilder utilise la SelectCommand propriété pour récupérer un ensemble de métadonnées requis.

utilise OracleCommandBuilder également les Connectionpropriétés et Transaction référencées par .SelectCommand

Si vous appelez Dispose, le OracleCommandBuilder est dissocié du OracleDataAdapteret les commandes générées ne sont plus utilisées.

Constructeurs

OracleCommandBuilder()	Obsolète. Initialise une nouvelle instance de l'objet OracleCommandBuilder.
OracleCommandBuilder(OracleDataAdapter)	Obsolète. Initialise une nouvelle instance de la classe OracleCommandBuilder avec l'objet OracleDataAdapter associé.

Propriétés

CanRaiseEvents	Obsolète. Obtient une valeur qui indique si le composant peut déclencher un événement. (Hérité de Component)
CatalogLocation	Obsolète. Obtient ou définit le CatalogLocation d’une instance de la classe DbCommandBuilder.
CatalogSeparator	Obsolète. Obtient ou définit une chaîne utilisée comme séparateur de catalogue pour une instance de la classe DbCommandBuilder.
ConflictOption	Obsolète. Spécifie quel ConflictOption doit être utilisé par le DbCommandBuilder. (Hérité de DbCommandBuilder)
Container	Obsolète. Obtient le IContainer qui contient la Component. (Hérité de Component)
DataAdapter	Obsolète. Obtient ou définit l'objet OracleDataAdapter pour lequel cet objet OracleCommandBuilder générera des instructions SQL.
DesignMode	Obsolète. Obtient une valeur qui indique si Component est actuellement en mode design. (Hérité de Component)
Events	Obsolète. Obtient la liste des gestionnaires d'événements attachés à ce Component. (Hérité de Component)
QuotePrefix	Obsolète. Obtient ou définit le ou les caractères de début à utiliser lors de la spécification d'objets de base de données (par exemple, des tables ou colonnes) dont les noms contiennent des caractères tels que des espaces ou des jetons réservés. (Hérité de DbCommandBuilder)
QuoteSuffix	Obsolète. Obtient ou définit le ou les caractères de fin à utiliser lors de la spécification d'objets de base de données (par exemple, des tables ou colonnes) dont les noms contiennent des caractères tels que des espaces ou des jetons réservés. (Hérité de DbCommandBuilder)
SchemaSeparator	Obsolète. Obtient ou définit le caractère à utiliser pour le séparateur entre l'identificateur de schéma et tout autre identificateur.
SetAllValues	Obsolète. Spécifie si toutes les valeurs de colonne d'une instruction de mise à jour sont incluses ou uniquement modifiées. (Hérité de DbCommandBuilder)
Site	Obsolète. Obtient ou définit le ISite de Component. (Hérité de Component)

Méthodes

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Obsolète. Permet à l'implémentation de fournisseur de la classe DbCommandBuilder de gérer des propriétés de paramètre supplémentaires. (Hérité de DbCommandBuilder)
CreateObjRef(Type)	Obsolète. 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)
DeriveParameters(OracleCommand)	Obsolète. Récupère les informations sur les paramètres à partir de la procédure stockée spécifiée dans OracleCommand et remplit la collection Parameters de l'objet OracleCommand spécifié.
Dispose()	Obsolète. Libère toutes les ressources utilisées par Component. (Hérité de Component)
Dispose(Boolean)	Obsolète. Libère les ressources non managées utilisées par DbCommandBuilder et libère éventuellement les ressources managées. (Hérité de DbCommandBuilder)
Equals(Object)	Obsolète. Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetDeleteCommand()	Obsolète. Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.
GetDeleteCommand(Boolean)	Obsolète. Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.
GetHashCode()	Obsolète. Fait office de fonction de hachage par défaut. (Hérité de Object)
GetInsertCommand()	Obsolète. Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.
GetInsertCommand(Boolean)	Obsolète. Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.
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. (Hérité de MarshalByRefObject)
GetParameterName(Int32)	Obsolète. Retourne le nom du paramètre spécifié au format .@p# Utilisez-le lors de la création d'un générateur de commandes personnalisé. (Hérité de DbCommandBuilder)
GetParameterName(String)	Obsolète. Retourne le nom de paramètre complet à partir du nom de paramètre partiel. (Hérité de DbCommandBuilder)
GetParameterPlaceholder(Int32)	Obsolète. Retourne l'espace réservé pour le paramètre dans l'instruction SQL associée. (Hérité de DbCommandBuilder)
GetSchemaTable(DbCommand)	Obsolète. Retourne la table de schéma pour le DbCommandBuilder. (Hérité de DbCommandBuilder)
GetService(Type)	Obsolète. Retourne un objet qui représente un service fourni par Component ou par son Container. (Hérité de Component)
GetType()	Obsolète. Obtient le Type de l'instance actuelle. (Hérité de Object)
GetUpdateCommand()	Obsolète. Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la base de données.
GetUpdateCommand(Boolean)	Obsolète. Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la base de données.
InitializeCommand(DbCommand)	Obsolète. Réinitialise les propriétés CommandTimeout, Transaction, CommandType et UpdateRowSource à la valeur DbCommand. (Hérité de DbCommandBuilder)
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. (Hérité de MarshalByRefObject)
MemberwiseClone()	Obsolète. Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Obsolète. Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
QuoteIdentifier(String)	Obsolète. À partir d'un identificateur sans guillemets dans le cas du catalogue correct, retourne le formulaire correct entre guillemets de cet identificateur, y compris une séquence d'échappement correcte des guillemets incorporés dans l'identificateur.
RefreshSchema()	Obsolète. Efface les commandes associées à ce DbCommandBuilder. (Hérité de DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Obsolète. Ajoute un gestionnaire d'événements pour l'événement RowUpdating. (Hérité de DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Obsolète. Enregistre le DbCommandBuilder pour gérer l'événement RowUpdating d'un DbDataAdapter. (Hérité de DbCommandBuilder)
ToString()	Obsolète. 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)
UnquoteIdentifier(String)	Obsolète. À partir d'un identificateur entre guillemets, retourne le formulaire correct sans guillemets de cet identificateur, y compris une séquence d'échappement correctement annulée de guillemets incorporés dans l'identificateur.

Événements

Disposed

Obsolète. Se produit lorsque le composant est supprimé par un appel à la méthode Dispose(). (Hérité de Component)

Voir aussi

• Génération de commandes avec CommandBuilders