OracleCommandBuilder OracleCommandBuilder OracleCommandBuilder OracleCommandBuilder Class

Определение

Предупреждение

Этот API устарел.

Автоматически создает однотабличные команды, которые позволяют согласовать изменения, внесенные в DataSet, со связанной базой данных.Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated database. Этот класс не наследуется.This class cannot be inherited.

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
type OracleCommandBuilder = class
    inherit DbCommandBuilder
Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder
Наследование
Атрибуты

Примеры

В следующем примере метод OracleCommand, вместе с OracleDataAdapter и OracleConnection, используется для выбора строк из базы данных.The following example uses OracleCommand, along with OracleDataAdapter and OracleConnection, to select rows from a database. В примере передается инициализированный DataSet, строка подключения, строка запроса, которая является инструкцией SQL SELECT, и строка, которая является именем таблицы базы данных.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. Затем в примере создается объект 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;  
}  

Комментарии

Этот тип является устаревшим и будет удален в следующей версии .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Дополнительные сведения см. в разделе Oracle и ADO.NET.For more information, see Oracle and ADO.NET.

Не создает автоматически инструкции SQL, необходимые для согласования изменений, внесенных в объект DataSet , связанный с базой данных. OracleDataAdapterThe OracleDataAdapter does not automatically generate the SQL statements required to reconcile changes made to a DataSet associated with the database. Однако можно создать OracleCommandBuilder объект, который формирует инструкции SQL для однотабличных обновлений, SelectCommand задав свойство объекта OracleDataAdapter.However, you can create an OracleCommandBuilder object that generates SQL statements for single-table updates by setting the SelectCommand property of the OracleDataAdapter. OracleCommandBuilder Затем создает все дополнительные инструкции SQL, которые не заданы.Then, the OracleCommandBuilder generates any additional SQL statements that you do not set.

Отношение между OracleDataAdapter и соответствующим OracleCommandBuilder ему всегда равно «один к одному».The relationship between an OracleDataAdapter and its corresponding OracleCommandBuilder is always one-to-one. Для создания этой корреспонденции задается OracleDataAdapter свойство OracleCommandBuilder объекта.To create this correspondence, you set the OracleDataAdapter property of the OracleCommandBuilder object. Это приводит к OracleCommandBuilder тому, что объект регистрируется в качестве прослушивателя, который RowUpdating создает выходные данные событий DataSet, влияющих на.This causes the OracleCommandBuilder to register itself as a listener, which produces the output of RowUpdating events that affect the DataSet.

Чтобы создать инструкции INSERT, UPDATE или DELETE, OracleCommandBuilder SelectCommand компонент использует свойство для получения требуемого набора метаданных.To generate INSERT, UPDATE, or DELETE statements, the OracleCommandBuilder uses the SelectCommand property to retrieve a required set of metadata.

В OracleCommandBuilder Transaction такжеSelectCommandиспользуются свойства Connection, и, на которые ссылается.The OracleCommandBuilder also uses the Connection, and Transaction properties referenced by the SelectCommand.

При вызове Disposeметод OracleCommandBuilder не связывается с ,асозданныекомандыбольшенеиспользуются.OracleDataAdapterIf you call Dispose, the OracleCommandBuilder is disassociated from the OracleDataAdapter, and the generated commands are no longer used.

Конструкторы

OracleCommandBuilder() OracleCommandBuilder() OracleCommandBuilder() OracleCommandBuilder()

Инициализирует новый экземпляр класса OracleCommandBuilder.Initializes a new instance of the OracleCommandBuilder.

OracleCommandBuilder(OracleDataAdapter) OracleCommandBuilder(OracleDataAdapter) OracleCommandBuilder(OracleDataAdapter) OracleCommandBuilder(OracleDataAdapter)

Инициализирует новый экземпляр класса OracleCommandBuilder вместе со связанным объектом OracleDataAdapter.Initializes a new instance of the OracleCommandBuilder class with the associated OracleDataAdapter object.

Свойства

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CatalogLocation CatalogLocation CatalogLocation CatalogLocation

Возвращает или задает CatalogLocation для экземпляра класса DbCommandBuilder.Sets or gets the CatalogLocation for an instance of the DbCommandBuilder class.

CatalogSeparator CatalogSeparator CatalogSeparator CatalogSeparator

Возвращает или задает строку, которую можно использовать в качестве разделителя каталогов, для экземпляра класса DbCommandBuilder.Sets or gets a string used as the catalog separator for an instance of the DbCommandBuilder class.

Container Container Container Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DataAdapter DataAdapter DataAdapter DataAdapter

Возвращает или задает объект OracleDataAdapter, для которого данный объект OracleCommandBuilder будет генерировать операторы SQL.Gets or sets an OracleDataAdapter object for which this OracleCommandBuilder object will generate SQL statements.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
QuotePrefix QuotePrefix QuotePrefix QuotePrefix

Возвращает или задает начальный символ или символы, используемые для указания объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены.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.

QuoteSuffix QuoteSuffix QuoteSuffix QuoteSuffix

Получает или задает конечный символ или символы, используемые для указания объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены.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.

SchemaSeparator SchemaSeparator SchemaSeparator SchemaSeparator

Возвращает или задает символ, который используется в качестве разделителя между идентификатором схемы и остальными идентификаторами.Gets or sets the character to be used for the separator between the schema identifier and any other identifiers.

Site Site Site Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Inherited from Component)

Методы

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

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
DeriveParameters(OracleCommand) DeriveParameters(OracleCommand) DeriveParameters(OracleCommand) DeriveParameters(OracleCommand)

Извлекает сведения о параметрах из хранимой процедуры, указанной в объекте OracleCommand, и включает их в коллекцию параметров Parameters указанного объекта OracleCommand.Retrieves parameter information from the stored procedure specified in the OracleCommand and populates the Parameters collection of the specified OracleCommand object.

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

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

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

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDeleteCommand() GetDeleteCommand() GetDeleteCommand() GetDeleteCommand()

Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций удаления в базе данных.Gets the automatically generated OracleCommand object required to perform deletions on the database.

GetDeleteCommand(Boolean) GetDeleteCommand(Boolean) GetDeleteCommand(Boolean) GetDeleteCommand(Boolean)

Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций удаления в базе данных.Gets the automatically generated OracleCommand object required to perform deletions on the database.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetInsertCommand() GetInsertCommand() GetInsertCommand() GetInsertCommand()

Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций вставки в базу данных.Gets the automatically generated OracleCommand object required to perform insertions on the database.

GetInsertCommand(Boolean) GetInsertCommand(Boolean) GetInsertCommand(Boolean) GetInsertCommand(Boolean)

Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций вставки в базу данных.Gets the automatically generated OracleCommand object required to perform insertions on the database.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.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)

Возвращает объект, представляющий службу, обеспечиваемую компонентом Component или его контейнером Container.Returns an object that represents a service provided by the Component or by its Container.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetUpdateCommand() GetUpdateCommand() GetUpdateCommand() GetUpdateCommand()

Получает автоматически созданный объект OracleCommand, который требуется для выполнения обновлений базы данных.Gets the automatically generated OracleCommand object required to perform updates on the database.

GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean) GetUpdateCommand(Boolean)

Получает автоматически созданный объект OracleCommand, который требуется для выполнения обновлений базы данных.Gets the automatically generated OracleCommand object required to perform updates on the database.

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

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
QuoteIdentifier(String) QuoteIdentifier(String) QuoteIdentifier(String) QuoteIdentifier(String)

Если у идентификатора нет кавычек, при наличии правильного каталога возвращает правильную форму этого идентификатора, взятую в кавычки, при этом корректно избегает кавычек, встроенных в идентификатор.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() RefreshSchema() RefreshSchema() RefreshSchema()

Очищает команды, связанные с этим объектом DbCommandBuilder.Clears the commands that are associated with this DbCommandBuilder.

ToString() ToString() ToString() ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Inherited from Component)
UnquoteIdentifier(String) UnquoteIdentifier(String) UnquoteIdentifier(String) UnquoteIdentifier(String)

Если у идентификатора есть кавычки, возвращает форму этого идентификатора без кавычек, при этом корректно учитывая кавычки, встроенные в идентификатор.Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.

События

Disposed Disposed Disposed Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Применяется к

Дополнительно