OdbcDataAdapter Класс

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v9.0.0-rc.1.24431.7

Исходный код:

OdbcDataAdapter.cs

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

public ref class OdbcDataAdapter sealed : System::Data::Common::DbDataAdapter, ICloneable

public sealed class OdbcDataAdapter : System.Data.Common.DbDataAdapter, ICloneable

type OdbcDataAdapter = class
    inherit DbDataAdapter
    interface IDataAdapter
    interface IDbDataAdapter
    interface ICloneable

Public NotInheritable Class OdbcDataAdapter
Inherits DbDataAdapter
Implements ICloneable

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

Object

MarshalByRefObject

Component

DataAdapter

DbDataAdapter

OdbcDataAdapter

Реализации

IDataAdapter IDbDataAdapter ICloneable

Примеры

В следующем примере используются OdbcCommand, OdbcDataAdapterи OdbcConnection для выбора записей и заполнения DataSet выделенными строками.

public DataSet GetDataSetFromAdapter(
    DataSet dataSet, string connectionString, string queryString)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        OdbcDataAdapter adapter =
            new OdbcDataAdapter(queryString, connection);

        // Open the connection and fill the DataSet.
        try
        {
            connection.Open();
            adapter.Fill(dataSet);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
    return dataSet;
}

Public Function GetDataSetFromAdapter( _
    ByVal dataSet As DataSet, ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Using connection As New OdbcConnection(connectionString)
        Dim adapter As New OdbcDataAdapter(queryString, connection)

        ' Open the connection and fill the DataSet.
        Try
            connection.Open()
            adapter.Fill(dataSet)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using

    Return dataSet
End Function

Комментарии

служит OdbcDataAdapter мостом между DataSet источником данных и для получения и сохранения данных. Предоставляет OdbcDataAdapter этот мост, используя Fill для загрузки данных из источника данных в DataSet, и с помощью для Update отправки изменений, внесенных в обратном DataSet режиме, в источник данных.

При заполнении OdbcDataAdapterDataSetон создает необходимые таблицы и столбцы для возвращаемых данных, если они еще не существуют. Однако сведения о первичном ключе не включаются в неявно созданную схему, если свойству MissingSchemaAction не присвоено значение AddWithKey. Вы также OdbcDataAdapter можете создать схему DataSet, включая сведения о первичном ключе, перед заполнением ее данными с помощью FillSchema. Дополнительные сведения см. в статье Добавление существующих ограничений в набор данных.

Примечание

При вызове Fill метода в источнике данных, который не имеет столбца первичного ключа, OdbcDataAdapter объект пытается повысить уровень уникального ограничивающего столбца до первичного ключа. В процессе помечает OdbcDataAdapter ограничение уникальности как не допускающее значения NULL. Это работает, если в столбце уникального ограничения не указано значение NULL. Если имеется значение NULL, метод завершается Fill сбоем с нарушением ограничения. Чтобы избежать этой ситуации, не допускайте значения NULL в столбце уникальных ограничений.

Примечание

Из-за ограничений собственных драйверов ODBC при вызове возвращается только один DataTable из них FillSchema. Это верно даже при выполнении пакетных инструкций SQL, от которых ожидается несколько DataTable объектов.

Также OdbcDataAdapter включает SelectCommandсвойства , InsertCommand, DeleteCommand, UpdateCommandи TableMappings для упрощения загрузки и обновления данных.

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

OdbcDataAdapter()	Инициализирует новый экземпляр класса OdbcDataAdapter.
OdbcDataAdapter(OdbcCommand)	Инициализирует новый экземпляр класса OdbcDataAdapter с заданным оператором SQL SELECT.
OdbcDataAdapter(String, OdbcConnection)	Инициализирует новый экземпляр класса OdbcDataAdapter с оператором SQL SELECT и объектом OdbcConnection.
OdbcDataAdapter(String, String)	Инициализирует новый экземпляр класса OdbcDataAdapter с оператором SQL SELECT и строкой подключения.

Поля

DefaultSourceTableName

Имя по умолчанию, используемое объектом DataAdapter для сопоставлений таблиц. (Унаследовано от DbDataAdapter)

Свойства

AcceptChangesDuringFill	Возвращает или задает значение, указывающее, вызывается ли метод AcceptChanges() в объекте DataRow после его добавления к объекту DataTable при выполнении любой из операций Fill. (Унаследовано от DataAdapter)
AcceptChangesDuringUpdate	Возвращает или задает, вызывается ли метод AcceptChanges() при вызове метода Update(DataSet). (Унаследовано от DataAdapter)
CanRaiseEvents	Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component)
Container	Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component)
ContinueUpdateOnError	Возвращает или задает значение, указывающее, следует ли генерировать ли исключение при обнаружении ошибки во время обновления строки. (Унаследовано от DataAdapter)
DeleteCommand	Возвращает или задает оператор SQL или хранимую процедуру, используемую для удаления записей в источнике данных.
DesignMode	Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component)
Events	Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component)
FillCommandBehavior	Возвращает или задает реакцию команды, использованной для заполнения адаптера данных. (Унаследовано от DbDataAdapter)
FillLoadOption	Возвращает или задает значение перечисления типа LoadOption, определяющее, как адаптер заполняет объект DataTable из объекта DbDataReader. (Унаследовано от DataAdapter)
InsertCommand	Возвращает или задает инструкцию либо хранимую процедуру SQL, используемую для вставки записей в источнике данных.
MissingMappingAction	Определяет действие, выполняемое, если входные данные не соответствуют таблице или столбцу. (Унаследовано от DataAdapter)
MissingSchemaAction	Определяет действие, которое должно быть выполнено, если существующая схема DataSet не соответствует входным данным. (Унаследовано от DataAdapter)
ReturnProviderSpecificTypes	Возвращает или задает, должен ли метод Fill возвращать зависящие от поставщика значения или обычные CLS-совместимые значения. (Унаследовано от DataAdapter)
SelectCommand	Возвращает или задает оператор SQL или хранимую процедуру для выборки записей в источнике данных.
Site	Получает или задает ISite объекта Component. (Унаследовано от Component)
TableMappings	Возвращает коллекцию, которая предоставляет основное сопоставление между исходной таблицей DataTableи . (Унаследовано от DataAdapter)
UpdateBatchSize	Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета. (Унаследовано от DbDataAdapter)
UpdateCommand	Возвращает или задает инструкцию SQL либо хранимую процедуру (используется для обновления записей в источнике данных).

Методы

AddToBatch(IDbCommand)	Добавляет интерфейс IDbCommand к текущему пакету. (Унаследовано от DbDataAdapter)
ClearBatch()	Удаляет все объекты IDbCommand из пакета. (Унаследовано от DbDataAdapter)
CloneInternals()	Устаревшие.. Создает дубликат этого экземпляра класса DataAdapter. (Унаследовано от DataAdapter)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
CreateRowUpdatedEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Инициализирует новый экземпляр класса RowUpdatedEventArgs. (Унаследовано от DbDataAdapter)
CreateRowUpdatingEvent(DataRow, IDbCommand, StatementType, DataTableMapping)	Инициализирует новый экземпляр класса RowUpdatingEventArgs. (Унаследовано от DbDataAdapter)
CreateTableMappings()	Создает новый экземпляр DataTableMappingCollection. (Унаследовано от DataAdapter)
Dispose()	Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DbDataAdapter, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbDataAdapter)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExecuteBatch()	Выполняет текущий пакет. (Унаследовано от DbDataAdapter)
Fill(DataSet)	Добавляет или обновляет строки в объекте DataSet. (Унаследовано от DbDataAdapter)
Fill(DataSet, Int32, Int32, String)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable. (Унаследовано от DbDataAdapter)
Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с помощью имен DataSet и исходной таблицы, командной строки и поведения команды. (Унаследовано от DbDataAdapter)
Fill(DataSet, String)	Добавляет или обновляет строки в объекте DataSet для получения соответствия строкам в источнике данных с помощью имен DataSet и DataTable. (Унаследовано от DbDataAdapter)
Fill(DataSet, String, IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet, DataTable и IDataReader. (Унаследовано от DbDataAdapter)
Fill(DataTable)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имени DataTable. (Унаследовано от DbDataAdapter)
Fill(DataTable, IDataReader)	Добавляет или обновляет строки в объекте DataTable для получения соответствия строкам в источнике данных с помощью указанных имен DataTable и IDataReader. (Унаследовано от DbDataAdapter)
Fill(DataTable, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в объекте DataTable для получения соответствия строкам в источнике данных с помощью указанного объекта DataTable, интерфейса IDbCommand и значения типа CommandBehavior. (Унаследовано от DbDataAdapter)
Fill(DataTable[], IDataReader, Int32, Int32)	Добавляет или обновляет строки в указанной коллекции объектов DataTable для получения соответствия строкам в источнике данных. (Унаследовано от DataAdapter)
Fill(DataTable[], Int32, Int32, IDbCommand, CommandBehavior)	Добавляет или обновляет строки в указанном диапазоне в объект DataSet для получения соответствия строкам в источнике данных с использованием имен DataSet и DataTable. (Унаследовано от DbDataAdapter)
Fill(Int32, Int32, DataTable[])	Добавляет или обновляет строки в одном или нескольких объектах DataTable в соответствии с строками в источнике данных, начиная с указанной записи и извлекая до указанного максимального количества записей. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType)	Добавляет объект DataTable с именем Table в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior)	Добавляет объект DataTable в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанного значения типа SchemaType. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType, String)	Добавляет объект DataTable в указанный объект DataSet и настраивает схему для соответствия этому объекту в источнике данных на основе указанных SchemaType и DataTable. (Унаследовано от DbDataAdapter)
FillSchema(DataSet, SchemaType, String, IDataReader)	Добавляет объект DataTable к указанному объекту DataSet. (Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType)	Настраивает схему указанного объекта DataTable на основе указанного SchemaType. (Унаследовано от DbDataAdapter)
FillSchema(DataTable, SchemaType, IDataReader)	Добавляет объект DataTable к указанному объекту DataSet. (Унаследовано от DataAdapter)
FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior)	Настраивает схему для указанного объекта DataTable, основываясь на указанном значении типа SchemaType, командной строке и значениях типа CommandBehavior. (Унаследовано от DbDataAdapter)
GetBatchedParameter(Int32, Int32)	Возвращает интерфейс IDataParameter из одной из команд в текущем пакете. (Унаследовано от DbDataAdapter)
GetBatchedRecordsAffected(Int32, Int32, Exception)	Возвращает сведения об отдельной попытке обновления в рамках большего по своему объему пакета обновления. (Унаследовано от DbDataAdapter)
GetFillParameters()	Получает параметры, заданные пользователем при выполнении оператора SQL SELECT. (Унаследовано от DbDataAdapter)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject)
GetService(Type)	Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HasTableMappings()	Указывает, был ли создан DataTableMappingCollection. (Унаследовано от DataAdapter)
InitializeBatching()	Инициализирует пакетную обработку для объекта DbDataAdapter. (Унаследовано от DbDataAdapter)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
OnFillError(FillErrorEventArgs)	Вызывает событие FillError. (Унаследовано от DbDataAdapter)
OnRowUpdated(RowUpdatedEventArgs)	Вызывает событие RowUpdated поставщика данных .NET. (Унаследовано от DbDataAdapter)
OnRowUpdating(RowUpdatingEventArgs)	Вызывает событие RowUpdating поставщика данных .NET. (Унаследовано от DbDataAdapter)
ResetFillLoadOption()	Сбрасывает свойство FillLoadOption к состоянию по умолчанию и вызывает метод Fill(DataSet) для обеспечения поддержки свойства AcceptChangesDuringFill. (Унаследовано от DataAdapter)
ShouldSerializeAcceptChangesDuringFill()	Определяет, должно ли сохраняться свойство AcceptChangesDuringFill. (Унаследовано от DataAdapter)
ShouldSerializeFillLoadOption()	Определяет, должно ли сохраняться свойство FillLoadOption. (Унаследовано от DataAdapter)
ShouldSerializeTableMappings()	Определяет, существует ли один или несколько объектов DataTableMapping и нужно ли их сохранить. (Унаследовано от DataAdapter)
TerminateBatching()	Завершает пакетную обработку для объекта DbDataAdapter. (Унаследовано от DbDataAdapter)
ToString()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)
Update(DataRow[])	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве объектов DataSet. (Унаследовано от DbDataAdapter)
Update(DataRow[], DataTableMapping)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном массиве объектов DataRow. (Унаследовано от DbDataAdapter)
Update(DataSet)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном DataSet. (Унаследовано от DbDataAdapter)
Update(DataSet, String)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в DataSet с заданным именем DataTable. (Унаследовано от DbDataAdapter)
Update(DataTable)	Обновляет значения в базе данных, выполняя соответствующие операторы INSERT, UPDATE или DELETE для каждой вставленной, обновленной или удаленной строки в указанном DataTable. (Унаследовано от DbDataAdapter)

События

Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)
FillError	Возвращается при возникновении ошибки во время работы операции заполнения. (Унаследовано от DbDataAdapter)
RowUpdated	Происходит во время операции обновления после выполнения команды в отношении источника данных.
RowUpdating	Происходит во время Update(DataSet) перед выполнением команды в отношении источника данных.

Явные реализации интерфейса

ICloneable.Clone()	Описание этого члена см. в разделе Clone().
IDataAdapter.TableMappings	Возвращает коллекцию, указывающую, как исходная таблица сопоставляется с таблицей набора данных. (Унаследовано от DataAdapter)
IDbDataAdapter.DeleteCommand	Описание этого члена см. в разделе DeleteCommand.
IDbDataAdapter.InsertCommand	Описание этого члена см. в разделе InsertCommand.
IDbDataAdapter.SelectCommand	Описание этого члена см. в разделе SelectCommand.
IDbDataAdapter.UpdateCommand	Описание этого члена см. в разделе UpdateCommand.

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

• Объекты DataAdapter и DataReader