OracleCommandBuilder Classe

Définition

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.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class OracleCommandBuilder sealed : System::ComponentModel::Component
public ref class OracleCommandBuilder sealed : System::Data::Common::DbCommandBuilder
public sealed class OracleCommandBuilder : System.ComponentModel.Component
public sealed class OracleCommandBuilder : 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
type OracleCommandBuilder = class
    inherit Component
type OracleCommandBuilder = class
    inherit 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 Component
Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder
Héritage
OracleCommandBuilder
Héritage
Attributs

Exemples

L’exemple suivant utilise OracleCommand , avec OracleDataAdapter et OracleConnection , pour sélectionner des lignes d’une base de données.The following example uses OracleCommand, along with OracleDataAdapter and OracleConnection, to select rows from a database. L’exemple reçoit un initialisé DataSet , une chaîne de connexion, une chaîne de requête qui est une instruction SQL SELECT et une chaîne qui est le nom de la table de base de données.The example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the database table. L’exemple crée ensuite un OracleCommandBuilder .The example then creates an 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 future version du .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Pour plus d’informations, consultez Oracle et ADO.net.For more information, see Oracle and ADO.NET.

OracleDataAdapterNe génère pas automatiquement les instructions SQL requises pour harmoniser les modifications apportées à un DataSet associé à la base de données.The OracleDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet associated with the database. Toutefois, vous pouvez créer un OracleCommandBuilder objet qui génère des instructions SQL pour les mises à jour d’une seule table en définissant la SelectCommand propriété de OracleDataAdapter .However, you can create an OracleCommandBuilder object that generates SQL statements for single-table updates by setting the SelectCommand property of the OracleDataAdapter. Ensuite, OracleCommandBuilder génère toutes les instructions SQL supplémentaires que vous ne définissez pas.Then, the OracleCommandBuilder generates any additional SQL statements that you do not set.

La relation entre un OracleDataAdapter et son correspondant OracleCommandBuilder est toujours un-à-un.The relationship between an OracleDataAdapter and its corresponding OracleCommandBuilder is always one-to-one. Pour créer cette correspondance, vous définissez la OracleDataAdapter propriété de l' OracleCommandBuilder objet.To create this correspondence, you set the OracleDataAdapter property of the OracleCommandBuilder object. Le s' OracleCommandBuilder inscrit alors en tant qu’écouteur, ce qui produit la sortie des RowUpdating événements qui affectent le DataSet .This causes the OracleCommandBuilder to register itself as a listener, which produces the output of RowUpdating events that affect the DataSet.

Pour générer des instructions INSERT, UPDATE ou DELETE, le OracleCommandBuilder utilise la SelectCommand propriété pour récupérer un jeu de métadonnées requis.To generate INSERT, UPDATE, or DELETE statements, the OracleCommandBuilder uses the SelectCommand property to retrieve a required set of metadata.

OracleCommandBuilderUtilise également les Connection Propriétés, et Transaction référencées par le SelectCommand .The OracleCommandBuilder also uses the Connection, and Transaction properties referenced by the SelectCommand.

Si vous appelez Dispose , la OracleCommandBuilder est dissociée de OracleDataAdapter , et les commandes générées ne sont plus utilisées.If you call Dispose, the OracleCommandBuilder is disassociated from the OracleDataAdapter, and the generated commands are no longer used.

Constructeurs

OracleCommandBuilder()

Initialise une nouvelle instance de l'objet OracleCommandBuilder.Initializes a new instance of the OracleCommandBuilder.

OracleCommandBuilder(OracleDataAdapter)

Initialise une nouvelle instance de la classe OracleCommandBuilder avec l'objet OracleDataAdapter associé.Initializes a new instance of the OracleCommandBuilder class with the associated OracleDataAdapter object.

Propriétés

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.

(Hérité de Component)
CatalogLocation

Obtient ou définit le CatalogLocation d’une instance de la classe DbCommandBuilder.Gets or sets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator

Obtient ou définit une chaîne utilisée comme séparateur de catalogue pour une instance de la classe DbCommandBuilder.Gets or sets a string used as the catalog separator for an instance of the DbCommandBuilder class.

ConflictOption

Spécifie quel ConflictOption doit être utilisé par le DbCommandBuilder.Specifies which ConflictOption is to be used by the DbCommandBuilder.

(Hérité de DbCommandBuilder)
Container

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

(Hérité de Component)
DataAdapter

Obtient ou définit l'objet OracleDataAdapter pour lequel cet objet OracleCommandBuilder générera des instructions SQL.Gets or sets an OracleDataAdapter object for which this OracleCommandBuilder object will generate SQL statements.

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.

(Hérité de Component)
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.

(Hérité de Component)
QuotePrefix

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.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

QuotePrefix

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.Gets or sets the beginning character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

(Hérité de DbCommandBuilder)
QuoteSuffix

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.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

QuoteSuffix

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.Gets or sets the ending character or characters to use when specifying database objects (for example, tables or columns) whose names contain characters such as spaces or reserved tokens.

(Hérité de DbCommandBuilder)
SchemaSeparator

Obtient ou définit le caractère à utiliser pour le séparateur entre l'identificateur de schéma et tout autre identificateur.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

SetAllValues

Spécifie si toutes les valeurs de colonne d'une instruction de mise à jour sont incluses ou uniquement modifiées.Specifies whether all column values in an update statement are included or only changed ones.

(Hérité de DbCommandBuilder)
Site

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

(Hérité de Component)

Méthodes

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)

Permet à l'implémentation de fournisseur de la classe DbCommandBuilder de gérer des propriétés de paramètre supplémentaires.Allows the provider implementation of the DbCommandBuilder class to handle additional parameter properties.

(Hérité de DbCommandBuilder)
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.

(Hérité de MarshalByRefObject)
DeriveParameters(OracleCommand)

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é.Retrieves parameter information from the stored procedure specified in the OracleCommand and populates the Parameters collection of the specified OracleCommand object.

Dispose()

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

(Hérité de Component)
Dispose(Boolean)

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

(Hérité de Component)
Dispose(Boolean)

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

(Hérité de DbCommandBuilder)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetDeleteCommand()

Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetDeleteCommand(Boolean)

Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetHashCode()

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

(Hérité de Object)
GetInsertCommand()

Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.Gets the automatically generated OracleCommand object required to perform insertions on the database.

GetInsertCommand(Boolean)

Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des suppressions au niveau de la base de données.Gets the automatically generated OracleCommand object required to perform insertions on the database.

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetParameterName(Int32)

Retourne le nom du paramètre spécifié au format @p#.Returns the name of the specified parameter in the format of @p#. Utilisez-le lors de la création d'un générateur de commandes personnalisé.Use when building a custom command builder.

(Hérité de DbCommandBuilder)
GetParameterName(String)

Retourne le nom de paramètre complet à partir du nom de paramètre partiel.Returns the full parameter name, given the partial parameter name.

(Hérité de DbCommandBuilder)
GetParameterPlaceholder(Int32)

Retourne l'espace réservé pour le paramètre dans l'instruction SQL associée.Returns the placeholder for the parameter in the associated SQL statement.

(Hérité de DbCommandBuilder)
GetSchemaTable(DbCommand)

Retourne la table de schéma pour le DbCommandBuilder.Returns the schema table for the DbCommandBuilder.

(Hérité de DbCommandBuilder)
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.

(Hérité de Component)
GetType()

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

(Hérité de Object)
GetUpdateCommand()

Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la base de données.Gets the automatically generated OracleCommand object required to perform updates on the database.

GetUpdateCommand(Boolean)

Obtient l'objet OracleCommand généré automatiquement, qui est requis pour effectuer des mises à jour au niveau de la base de données.Gets the automatically generated OracleCommand object required to perform updates on the database.

InitializeCommand(DbCommand)

Réinitialise les propriétés CommandTimeout, Transaction, CommandType et UpdateRowSource à la valeur DbCommand.Resets the CommandTimeout, Transaction, CommandType, and UpdateRowSource properties on the DbCommand.

(Hérité de DbCommandBuilder)
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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

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

(Hérité de MarshalByRefObject)
QuoteIdentifier(String)

À 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.Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.

RefreshSchema()

Efface les commandes associées à ce DbCommandBuilder.Clears the commands that are associated with this DbCommandBuilder.

RefreshSchema()

Efface les commandes associées à ce DbCommandBuilder.Clears the commands associated with this DbCommandBuilder.

(Hérité de DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)

Ajoute un gestionnaire d'événements pour l'événement RowUpdating.Adds an event handler for the RowUpdating event.

(Hérité de DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)

Enregistre le DbCommandBuilder pour gérer l'événement RowUpdating d'un DbDataAdapter.Registers the DbCommandBuilder to handle the RowUpdating event for a DbDataAdapter.

(Hérité de DbCommandBuilder)
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.

(Hérité de Component)
UnquoteIdentifier(String)

À 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.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

Événements

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.

(Hérité de Component)

S’applique à