OracleCommandBuilder Класс

Определение

Пространство имен:

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Внимание!

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

Автоматически создает однотабличные команды, которые позволяют согласовать изменения, внесенные в DataSet, со связанной базой данных. Этот класс не наследуется.

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

Наследование

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

Атрибуты

ObsoleteAttribute

Примеры

В следующем примере для выбора строк из базы данных используются OracleCommandвместе с OracleDataAdapter и OracleConnection. В этом примере передается инициализированный DataSetобъект , строка подключения, строка запроса, которая является инструкцией SQL SELECT, и строка с именем таблицы базы данных. Затем в примере создается объект 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. Дополнительные сведения см. в разделе Oracle и ADO.NET.

не OracleDataAdapter создает автоматически инструкции SQL, необходимые для согласования изменений, внесенных в объект , связанный DataSet с базой данных. Однако можно создать OracleCommandBuilder объект , который создает инструкции SQL для обновлений из одной таблицы, задав SelectCommand свойство OracleDataAdapterобъекта . Затем создает все дополнительные инструкции SQL, OracleCommandBuilder которые не заданы.

Отношение между OracleDataAdapter и соответствующим ему OracleCommandBuilder всегда одно к одному. Чтобы создать это соответствие, необходимо задать OracleDataAdapter свойство OracleCommandBuilder объекта . Это приводит OracleCommandBuilder к регистрации в качестве прослушивателя, который создает выходные данные событий, влияющих RowUpdating на DataSet.

Для создания инструкций OracleCommandBuilder INSERT, UPDATE или DELETE использует SelectCommand свойство для получения требуемого набора метаданных.

Также OracleCommandBuilder использует Connectionсвойства , и Transaction , на которые ссылается SelectCommand.

При вызове DisposeOracleCommandBuilder метод отсоединяется от OracleDataAdapter, а созданные команды больше не используются.

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

OracleCommandBuilder()	Устаревшие.. Инициализирует новый экземпляр класса OracleCommandBuilder.
OracleCommandBuilder(OracleDataAdapter)	Устаревшие.. Инициализирует новый экземпляр класса OracleCommandBuilder вместе со связанным объектом OracleDataAdapter.

Свойства

CanRaiseEvents	Устаревшие.. Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
CatalogLocation	Устаревшие.. Возвращает или задает CatalogLocation для экземпляра класса DbCommandBuilder.
CatalogSeparator	Устаревшие.. Возвращает или задает строку, которую можно использовать в качестве разделителя каталогов для экземпляра класса DbCommandBuilder.
ConflictOption	Устаревшие.. Указывает, какое значение типа ConflictOption должно использоваться объектом DbCommandBuilder. (Унаследовано от DbCommandBuilder)
Container	Устаревшие.. Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
DataAdapter	Устаревшие.. Возвращает или задает объект OracleDataAdapter, для которого данный объект OracleCommandBuilder будет генерировать операторы SQL.
DesignMode	Устаревшие.. Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Устаревшие.. Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
QuotePrefix	Устаревшие.. Возвращает или задает начальный символ или символы, используемые для указания объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены. (Унаследовано от DbCommandBuilder)
QuoteSuffix	Устаревшие.. Получает или задает конечный символ или символы, используемые для указания объектов базы данных (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены. (Унаследовано от DbCommandBuilder)
SchemaSeparator	Устаревшие.. Возвращает или задает символ, который используется в качестве разделителя между идентификатором схемы и остальными идентификаторами.
SetAllValues	Устаревшие.. Указывает, включены все значения столбца в инструкции UPDATE или только измененные значения. (Унаследовано от DbCommandBuilder)
Site	Устаревшие.. Получает или задает ISite объекта Component. (Унаследовано от Component)

Методы

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Устаревшие.. Разрешает реализации поставщика класса DbCommandBuilder обрабатывать дополнительные свойства параметров. (Унаследовано от DbCommandBuilder)
CreateObjRef(Type)	Устаревшие.. Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
DeriveParameters(OracleCommand)	Устаревшие.. Извлекает сведения о параметрах из хранимой процедуры, указанной в объекте OracleCommand, и включает их в коллекцию параметров Parameters указанного объекта OracleCommand.
Dispose()	Устаревшие.. Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component)
Dispose(Boolean)	Устаревшие.. Освобождает неуправляемые ресурсы, используемые объектом DbCommandBuilder, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbCommandBuilder)
Equals(Object)	Устаревшие.. Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetDeleteCommand()	Устаревшие.. Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций удаления в базе данных.
GetDeleteCommand(Boolean)	Устаревшие.. Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций удаления в базе данных.
GetHashCode()	Устаревшие.. Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInsertCommand()	Устаревшие.. Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций вставки в базу данных.
GetInsertCommand(Boolean)	Устаревшие.. Получает автоматически созданный объект OracleCommand, который требуется для выполнения операций вставки в базу данных.
GetLifetimeService()	Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetParameterName(Int32)	Устаревшие.. Возвращает имя указанного параметра в формате @p#. Используется при создании пользовательского построителя команд. (Унаследовано от DbCommandBuilder)
GetParameterName(String)	Устаревшие.. Возвращает полное имя параметра при данном частичном имени параметра. (Унаследовано от DbCommandBuilder)
GetParameterPlaceholder(Int32)	Устаревшие.. Возвращает местозаполнитель для параметра в связанной инструкции SQL. (Унаследовано от DbCommandBuilder)
GetSchemaTable(DbCommand)	Устаревшие.. Возвращает таблицу схемы для объекта DbCommandBuilder. (Унаследовано от DbCommandBuilder)
GetService(Type)	Устаревшие.. Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Устаревшие.. Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetUpdateCommand()	Устаревшие.. Получает автоматически созданный объект OracleCommand, который требуется для выполнения обновлений базы данных.
GetUpdateCommand(Boolean)	Устаревшие.. Получает автоматически созданный объект OracleCommand, который требуется для выполнения обновлений базы данных.
InitializeCommand(DbCommand)	Устаревшие.. Сбрасывает свойства CommandTimeout, Transaction, CommandType и UpdateRowSource в объекте DbCommand. (Унаследовано от DbCommandBuilder)
InitializeLifetimeService()	Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Устаревшие.. Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Устаревшие.. Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
QuoteIdentifier(String)	Устаревшие.. Если у идентификатора нет кавычек, при наличии правильного каталога возвращает правильную форму этого идентификатора, взятую в кавычки, при этом корректно избегает кавычек, встроенных в идентификатор.
RefreshSchema()	Устаревшие.. Очищает команды, связанные с этим объектом DbCommandBuilder. (Унаследовано от DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Устаревшие.. Добавляет обработчик событий для события RowUpdating. (Унаследовано от DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Устаревшие.. Регистрирует объект DbCommandBuilder, чтобы обработать событие RowUpdating для объекта DbDataAdapter. (Унаследовано от DbCommandBuilder)
ToString()	Устаревшие.. Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)
UnquoteIdentifier(String)	Устаревшие.. Если у идентификатора есть кавычки, возвращает форму этого идентификатора без кавычек, при этом корректно учитывая кавычки, встроенные в идентификатор.

События

Disposed

Устаревшие.. Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)

См. также раздел

• Создание команд с помощью построителей CommandBuilder