ЯЗЫК ПРОГРАММИРОВАНИЯ С# 2005 И ПЛАТФОРМА .NET 2.0. 3-е издание - Эндрю Троелсен

Интерфейс IDbConnection

Тип IDbConnection реализуется объектом соединения поставщика данных, Этот интерфейс определяет множество членов, используемых для настройки соединения с конкретным хранилищем данных, а также позволяет получить объект транзакции поставщика данных. Вот формальное определение IDbConnection.

public interface IDbConnection: IDisposable {

 string ConnectionString { get; set; }

 int ConnectionTimeout { get; }

 string Database { get; }

 ConnectionState State { get; }

 IDbTransaction BeginTransaction();

 IDbTransaction BeginTransaction(IsolationLevel il);

 void ChangeDatabase(string databaseName);

 void Close();

 IDbCommand CreateCommand();

 void Open();

}

Интерфейс IDbTransaction

Как видите, перегруженный метод BeginTransaction(), определенный интерфейсом IDbConnection, обеспечивает доступ к объекту транзакции поставщика данных. Используя члены, определенные интерфейсам IDbTransaction, вы можете осуществлять программное взаимодействие с сеансом транзакции и соответствующим хранилищем данных.

public Interface IDbTransaction: IDisposable {

 IDbConnection Connection { get; }

 IsolationLevel IsolationLevel { get; }

 void Commit();

 void Rollback();

}

Интерфейс IDbCommand

Интерфейс IDbCommand будет реализован объектом команды поставщика данных. Как и в других объектных моделях доступа к данным, здесь объекты команд позволяют программно обрабатывать SQL-операторы, хранимые процедуры и параметризованные запросы. Кроме того, с помощью перегруженного метода ExecuteReader() объекты команд обеспечивают доступ к объекту чтения данных поставщика данных,

public Interface IDbCommand: IDisposable {

 string CommandText { get; set; }

 int CommandTimeout { get; set; }

 CommandType CommandType { get; set; }

 IDbConnection Connection { get; set; }

 IDataParameterCollection Parameters { get; }

 IDbTransaction Transaction { get; set; }

 UpdateRowSource UpdateRowSource { get; set; }

 void Cancel();

 IDbDataParameter CreateParameter();

 int ExecuteNonQuery();

 IDataReader ExecuteReader();

 IDataReader ExecuteReader(CommandBehavior behavior);

 object ExecuteScalar();

 void Prepare();

}

Интерфейсы IDbDataParameter и IDataParameter

Обратите внимание на то, что свойство Parameters интерфейса IDbCommand возвращает строго типизованную коллекцию, реализующую интерфейс IDataParameterCollection. Этот интерфейс обеспечивает доступ к множеству совместимых с IDbDataParameter типов класса (например, объектов параметров).

public interface IDbDataParameter: IDataParameter {

 byte Precision { get; set; }

 byte Scale { get; set; }

 int Size { get; set; }

}

Интерфейс IDbDataParameter расширяет интерфейс IDataParameter. предлагающий следующие возможности.

public interface IDataParameter {

 DbType DbType { get; set; }

 ParameterDirection Direction { get; set; }

 bool IsNullable { get; }

 string ParameterName { get; set; }

 string SourceColumn { get; set; }

 DataRowVersion SourceVersion { get; set; }

 object Value { get; set; }

}

Как видите, интерфейсы IDbDataParameter и IDataParameter позволяют представить параметры SQL-команды (включая хранимые процедуры) в виде специальных объектов параметров ADO.NET, а не в виде сложных строковых литералов.

Интерфейсы IDbDataAdapter и IDataAdapter

Адаптеры данных используются для извлечения объектов DataSet из хранилища данных и отправки их в хранилище. Интерфейс IDbDataAdapter определяет набор свойств, используемых для поддержки SQL-операторов в операциях выборки, вставки, обновления и удаления данных.

public interface IDbDataAdapter: IDataAdapter {

 IDbCommand DeleteCommand { get; set; }

 IDbCommand InsertCommand { get; set; }

 IDbCommand SelectCommand { get; set; }

 IDbCommand UpdateCommand { get; set; }

}

Кроме этих четырех свойств, адаптер данных ADO.NET наследует поведение, определенное его базовым интерфейсом IDataAdapter. Этот интерфейс определяет ключевую функцию адаптера данных: способность переносить объекты DataSet из приложения вызывающей стороны в хранилище данных и обратно, используя методы Fill() и Update().

Дополнительно интерфейс IDataAdapter позволяет транслировать имена столбцов базы данных в более понятные пользователю дисплейные имена с помощью свойства TableMappings.

public interface IDataAdapter {

 MissingMappingAction MissingMappingAction { get; set; }

 MissingSchemaAction MissingSchemaAction { get; set; }

 ITableMappingCollection TableMappings { get; }

 int Fill(System.Data.DataSet dataSet);

 DataTable[] FillSchema(DataSet dataSet, SchemaType schemaType);

 IDataParameter[] GetFillParameters();

 int Update(DataSet dataSet);

}

Интерфейсы IDataReader и IDataRecord

Следующим ключевым интерфейсом является IDataReader, который представляет общие возможности поведения объекта чтения данных. Получив IDataReader-тип от поставщика данных ADO.NET, вы можете обратиться к результирующему набору данных в режиме однонаправленного доступа, позволяющего только чтение.

public interface IDataReader: IDisposable, IDataRecord {

 int Depth { get; }

 bool IsClosed { get; }

 int RecordsAffected { get; }

 void Close();

 DataTable GetSchemaTable();

 bool NextResult();

 bool Read();

}

Наконец, вы видите, что IDataReader расширяет интерфейс IDataRecord, определяющий большой набор членов, которые позволяют извлечь из потока строго типизованное значение вместо общего объекта System.Object, предлагаемого перегруженным методом индексатора объекта чтения данных. Вот часть программного кода соответствующих методов GetXXX(), определенных в рамках IDataRecord (весь программный код можно найти в документации .NET Framework 2.0 SDK).

public interface IDataRecord {

 int FieldCount { get; }

 object this[string name] { get; }

 object this[int i] { get; }

 bool GetBoolean(int i);

 byte GetByte(int i);

 char GetChar(int i);

 DateTime GetDateTime(int i);

 Decimal GetDecimal(int i);

 float GetFloat(int i);

 short GetInt16(int i);

 int GetInt32(int i);

 long GetInt64(int i);

 …

 bool IsDBNull(int i);

}

Замечание. Перед чтением значения из объекта чтения данных можно использовать метод IDataReader.IsDBNull(), чтобы программно убедиться в том, что соответствующее поле данных не равно null (и не допустить генерирования соответствующего исключения в среде выполнения).

Интерфейсы и абстрактные поставщики данных

К этому моменту вы должны иметь более конкретное представление об общих функциональных возможностях, присущих всем поставщикам данных .NET. Напомним, что, хотя имена реализующих типов у разных поставщиков данных оказываются разными, у вас все равно есть возможность программировать эти типы в аналогичной манере – в этом и заключается преимущество полиморфизма, основанного на использовании интерфейсов. Так, если определить метод, имеющий параметр IDbConnection, вы сможете передать ему любой объект соединения ADO.NET.

public static void OpenConnection(IDbConnection cn) {

 // Открытие входного соединения для вызывающей стороны.

 cn.Open();

}

То же можно сказать и о возвращаемых значениях. Рассмотрите, например, следующую простую программу на C#, которая позволяет вызывающей стороне получить конкретный объект соединения, используя значение пользовательского перечня (здесь предполагается, что вы указали оператор using для System.Data).

namespace ConnectionApp {

 enum DataProvider { SqlServer, OleDb, Odbc, Oracle }

 class Program {

  static void Main(string[] args) {

   // Получение соединения.

   IDbConnection myCn = GetConnection(DataProvider.SqlServer);

   // Требуется соединение с базой данных SQL Server Pubs.

   myCn.ConnectionString = "Data Source=localhost;uid=sa;pwd=;Initial Catalog=Pubs";

   // Открытие соединения с помощью вспомогательной функции.

   OpenConnection(myCn);

   // Использование соединения и его последующее закрытие.

   …

   myCn.Close();

  }

  static IDbConnection GetConnection(DataProvider dp) {

   IDbConnection conn = null;

   switch (dp) {

   case DataProvider.SqlServer:

    conn = new SqlConnection();

    break;

   case DataProvider.OleDb:

    conn = new OleDbConnection();

    break;

   case DataProvider.Odbc:

    conn = new OdbcConnection();

    break;

   case DataProvider.Oracle:

    conn = new OracleConnection();

    break;

   }

   return conn;

  }

 }

}

Преимущество использования общих интерфейсов System.Data заключается в том, что в этом случае у вас больше шансов создать более гибкий программный код, который дольше сможет оставаться актуальным. Например, если сегодня вы построите приложение, использующее Microsoft SQL Server, то что вы сможете сделать, если через год-другой руководство вашей компании примет решение перейти на использование Oracle? Если в приложении "жестко" запрограммированы имена типов System.Data.SqlClient, то вам, очевидно, придется сначала их отредактировать, а затем перекомпилировать и повторно инсталлировать компоновочный блок.