OdbcDataAdapter Класс

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v11.0.0-preview.2.26159.112

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

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, а также OdbcConnection для выбора записей и заполнения DataSet выбранными OdbcDataAdapterстроками.

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 источник данных.

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

Замечание

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

Замечание

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

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

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

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

Свойства

Имя	Описание
DeleteCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для удаления записей в источнике данных.
InsertCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для вставки новых записей в источник данных.
SelectCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для выбора записей в источнике данных.
UpdateCommand	Возвращает или задает инструкцию SQL или хранимую процедуру, используемую для обновления записей в источнике данных.

События

Имя	Описание
RowUpdated	Происходит во время операции обновления после выполнения команды в источнике данных.
RowUpdating	Происходит во время Update(DataSet) выполнения команды в источнике данных.

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

Имя	Описание
ICloneable.Clone()	Описание этого элемента см. в разделе Clone().
IDbDataAdapter.DeleteCommand	Описание этого элемента см. в разделе DeleteCommand.
IDbDataAdapter.InsertCommand	Описание этого элемента см. в разделе InsertCommand.
IDbDataAdapter.SelectCommand	Описание этого элемента см. в разделе SelectCommand.
IDbDataAdapter.UpdateCommand	Описание этого элемента см. в разделе UpdateCommand.

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

• Объекты DataAdapter и DataReader