OracleCommandBuilder Clase

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Precaución

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

Genera automáticamente comandos de tabla única que se utilizan para conciliar los cambios realizados en un objeto DataSet con la base de datos asociada. Esta clase no puede heredarse.

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

Herencia

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

Atributos

ObsoleteAttribute

Ejemplos

En el ejemplo siguiente se usa OracleCommand, junto con OracleDataAdapter y OracleConnection, para seleccionar filas de una base de datos. El ejemplo se pasa a un inicializado DataSet, un cadena de conexión, una cadena de consulta que es una instrucción SELECT de SQL y una cadena que es el nombre de la tabla de base de datos. A continuación, el ejemplo crea 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;  
}  

Comentarios

Este tipo está en desuso y se quitará en una versión futura de .NET Framework. Para obtener más información, consulte Oracle y ADO.NET.

OracleDataAdapter no genera automáticamente las instrucciones SQL necesarias para conciliar los cambios realizados en un DataSet asociado a la base de datos. Sin embargo, puede crear un OracleCommandBuilder objeto que genere instrucciones SQL para las actualizaciones de tabla única estableciendo la SelectCommand propiedad de OracleDataAdapter. A continuación, genera OracleCommandBuilder cualquier instrucción SQL adicional que no establezca.

La relación entre y OracleDataAdapter su correspondiente OracleCommandBuilder es siempre uno a uno. Para crear esta correspondencia, establezca la OracleDataAdapter propiedad del OracleCommandBuilder objeto . Esto hace que se OracleCommandBuilder registre a sí mismo como un agente de escucha, que genera la salida de RowUpdating eventos que afectan a DataSet.

Para generar instrucciones INSERT, UPDATE o DELETE, usa OracleCommandBuilder la SelectCommand propiedad para recuperar un conjunto necesario de metadatos.

OracleCommandBuilder también usa las Connectionpropiedades , y Transaction a las que hace referencia .SelectCommand

Si llama a Dispose, el OracleCommandBuilder elemento se desasocia de OracleDataAdaptery los comandos generados ya no se usan.

Constructores

OracleCommandBuilder()	Obsoletos. Inicializa una nueva instancia de OracleCommandBuilder.
OracleCommandBuilder(OracleDataAdapter)	Obsoletos. Inicializa una nueva instancia de la clase OracleCommandBuilder con el objeto OracleDataAdapter asociado.

Propiedades

CanRaiseEvents	Obsoletos. Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CatalogLocation	Obsoletos. Obtiene o establece el objeto CatalogLocation para una instancia de la clase DbCommandBuilder.
CatalogSeparator	Obsoletos. Obtiene o establece una cadena que se usa como separador de catálogo para una instancia de la clase DbCommandBuilder.
ConflictOption	Obsoletos. Especifica qué ConflictOption va a utilizar DbCommandBuilder. (Heredado de DbCommandBuilder)
Container	Obsoletos. Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DataAdapter	Obsoletos. Obtiene o establece un objeto OracleDataAdapter para el que este objeto OracleCommandBuilder va a generar instrucciones SQL.
DesignMode	Obsoletos. Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obsoletos. Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
QuotePrefix	Obsoletos. Obtiene o establece el carácter o los caracteres iniciales que se van a utilizar al especificar objetos de base de datos (por ejemplo, tablas o columnas), cuyos nombres contengan caracteres como espacios o símbolos (token) reservados. (Heredado de DbCommandBuilder)
QuoteSuffix	Obsoletos. Obtiene o establece el carácter o los caracteres finales que se van a usar al especificar los objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres como espacios o tokens reservados. (Heredado de DbCommandBuilder)
SchemaSeparator	Obsoletos. Obtiene o establece el carácter que se va a utilizar para el separador entre el identificador de esquema y cualquier otro identificador.
SetAllValues	Obsoletos. Especifica si en una instrucción de actualización se incluyen todos los valores de columna o sólo los que han cambiado. (Heredado de DbCommandBuilder)
Site	Obsoletos. Obtiene o establece ISite de Component. (Heredado de Component)

Métodos

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Obsoletos. Permite que la implementación del proveedor de la clase DbCommandBuilder controle propiedades de parámetro adicionales. (Heredado de DbCommandBuilder)
CreateObjRef(Type)	Obsoletos. Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
DeriveParameters(OracleCommand)	Obsoletos. Recupera información de parámetro del procedimiento almacenado especificado en OracleCommand y rellena la colección de Parameters del objeto OracleCommand especificado.
Dispose()	Obsoletos. Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Obsoletos. Libera los recursos no administrados que usa DbCommandBuilder y, de forma opcional, libera los recursos administrados. (Heredado de DbCommandBuilder)
Equals(Object)	Obsoletos. Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetDeleteCommand()	Obsoletos. Obtiene el objeto OracleCommand generado automáticamente que es necesario para realizar eliminaciones en la base de datos.
GetDeleteCommand(Boolean)	Obsoletos. Obtiene el objeto OracleCommand generado automáticamente que es necesario para realizar eliminaciones en la base de datos.
GetHashCode()	Obsoletos. Sirve como la función hash predeterminada. (Heredado de Object)
GetInsertCommand()	Obsoletos. Obtiene el objeto OracleCommand generado automáticamente que es necesario para realizar inserciones en la base de datos.
GetInsertCommand(Boolean)	Obsoletos. Obtiene el objeto OracleCommand generado automáticamente que es necesario para realizar inserciones en la base de datos.
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetParameterName(Int32)	Obsoletos. Devuelve el nombre del parámetro especificado en el formato de @p#. Utilícelo al crear un generador de comandos personalizado. (Heredado de DbCommandBuilder)
GetParameterName(String)	Obsoletos. Devuelve el nombre completo del parámetro, a partir de su nombre parcial. (Heredado de DbCommandBuilder)
GetParameterPlaceholder(Int32)	Obsoletos. Devuelve el marcador de posición para el parámetro en la instrucción SQL asociada. (Heredado de DbCommandBuilder)
GetSchemaTable(DbCommand)	Obsoletos. Devuelve la tabla de esquema para DbCommandBuilder. (Heredado de DbCommandBuilder)
GetService(Type)	Obsoletos. Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obsoletos. Obtiene el Type de la instancia actual. (Heredado de Object)
GetUpdateCommand()	Obsoletos. Obtiene el objeto OracleCommand generado automáticamente que es necesario para realizar actualizaciones en la base de datos.
GetUpdateCommand(Boolean)	Obsoletos. Obtiene el objeto OracleCommand generado automáticamente que es necesario para realizar actualizaciones en la base de datos.
InitializeCommand(DbCommand)	Obsoletos. Restablece las propiedades CommandTimeout, Transaction, CommandType y UpdateRowSource en el objeto DbCommand. (Heredado de DbCommandBuilder)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Obsoletos. Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Obsoletos. Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
QuoteIdentifier(String)	Obsoletos. Dado un identificador sin comillas en el caso de un catálogo correcto, devuelve el formato correcto entrecomillado de ese identificador, incluyendo una secuencia de escape adecuada para las comillas incrustadas en el identificador.
RefreshSchema()	Obsoletos. Borra los comandos asociados a este DbCommandBuilder. (Heredado de DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Obsoletos. Agrega un controlador de eventos para el evento RowUpdating. (Heredado de DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Obsoletos. Registra el objeto DbCommandBuilder para controlar el evento RowUpdating de un objeto DbDataAdapter. (Heredado de DbCommandBuilder)
ToString()	Obsoletos. Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
UnquoteIdentifier(String)	Obsoletos. Dado un identificador entre comillas, devuelve el formato correcto sin comillas de ese identificador, incluyendo una secuencia sin escape adecuada para las comillas incrustadas en el identificador.

Eventos

Disposed

Obsoletos. Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Consulte también

• Generación de comandos con objetos CommandBuilder