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

Троелсен Эндрю

}

Большинство указанных свойств самоочевидно, Но свойство State все же требует некоторого обсуждения. Этому свойству можно назначить любое значение из перечня ConnectionState

public enum System.Data.ConnectionState {

 Broken, Closed,

 Connecting, Executing,

 Fetching, Open

}

но единственными действительными значениями ConnectionState являются ConnectionState.Open и ConnectionState.Closed (остальные члены этого перечня зарезервированы для использования в будущем). Также заметим, что вполне безопасно закрыть соединение, состоянием которого в настоящий момент является ConnectionState.Closed.

Работа

с ConnectionStringBuilder в .NET 2.0

Работа в программе со строками соединений может оказаться достаточно сложной, например, из-за возможных опечаток, которые не всегда легко обнаружить, В рамках .NET 2.0 все предлагаемые Microsoft поставщики данных ADO.NET поддерживают объекты построителя строк соединений, позволяющие создавать пары имен и значений с помощью строго типизованных свойств. Рассмотрим следующую модификацию метода Main.

static void Main(string[] args) {

 // Создание строки соединения с помощью объекта построителя.

 SqlConnectionStringBuilder cnStrBuilder = new SqlConnectionStringBuilder;

 cnStrBuilder.UserID = "sa";

 cnStrBuilder.Password = "";

 cnStrBuilder.InitialCatalog = "Cars";

 cnStrBuilder.DataSource = "(local)";

 cnStrBuilder.ConnectTimeout =30;

 SqlConnection cn = new SqlConnection;

 cn.ConnectionString = cnStrBuilder.ConnectionString;

 cn.Open;

 ShowConnectionStatus(cn);

 …

}

В этом варианте программного кода создается экземпляр SqlConnectionStringBuilder, устанавливаются соответствующие свойства и с помощью свойства ConnectionString получается внутренняя строка. Заметьте, что здесь используется конструктор типа, заданный по умолчанию. Можно также создать экземпляр объекта построителя строк соединения для поставщика данных, передав уже существующую строку соединения в качестве исходной (это может оказаться полезно тогда, когда соответствующие значения считываются динамически ив файла app.config). Получив такой объект с начальными строковыми данными, вы можете изменить пары имен и значений с помощью соответствующих свойств, например:

static void Main(string[] args) {

 Console.WriteLine("*** Забавы с чтением данных ***\n");

 // Предположим, что строка cnStr получeна из файла *.config.

 string cnStr = "uid=sa;pwd=;Initial Catalog=Cars;" +

"Data Source=(local);Connect Timeout=30";

 SqlConnectionStringBuilder cnStrBuilder = new SqlConnectionStringBuilder(cnStr);

 cnStrBuilder.UserID = "sa";

 cnStrBuilder.Password = "";

 caStrBuilder.InitialCatalog = "Cars";

 cnStrBuilder.DataSource = "(local)";

 // Изменение значения времени ожидания.

 cnStrBuilder.ConnectTimeout = 5;

 …

}

Работа с объектами команд

Теперь, когда вы понимаете роль объекта соединения, мы выясним, как предъявить SQL-запрос базе данных. Тип SqlCommand (который получается из DbCommand) является объектом представлением SQL-запроса, имени таблицы или хранимой процедуры. Вид соответствующей команды указывается c помощью свойства CommandTyре, которое может принимать любое значение из перечня CommandType.

public enum System.Data.CommandType {

 StoredProcedure,

 TableDirect,

 Text // Значение, используемое по умолчанию.

}

При создании объекта команды вы можете указать SQL-запрос

или в качестве параметра конструктора, или напрямую через свойство CommandText. Также при создании объекта команд вы должны указать соединение, которое будет при этом использоваться. Это можно сделать либо через параметр конструктора, либо с помощью свойства Connection.

static void Main(string[] args) {

 SqlConnection cn = new SqlConnection;

 …

 // Создание объекта команды с помощью аргументов конструктора.

 string strSQL = "Select * From Inventory";

 SqlCommand myCommand = new SqlCommand(strSQL, cn);

 // Создание другого объекта команды с помощью свойств.

 SqlCommand testCommand = new SqlCommand;

 testCommand.Connection = cn;

 testCommand.CommandText = strSQL;

 …

}

Следует понимать, что в этот момент вы еще не предъявляете SQL-запрос базе данных Cars непосредственно, а только подготавливаете объект команды для использования в будущем. В табл. 22.7 приводятся описания еще нескольких членов типа DbCommand.

Таблица 22.7. Члены типа DbCommand

Член	Описание
CommandTimeout	Читает или устанавливает значение времени ожидания выполнения команды, прежде чем будет сгенерировано сообщение об ошибке. Значением по умолчанию является 30 секунд
Connection	Читает или устанавливает значение DbConnection, которое используется данным экземпляром DbCommand
Parameters	Получает коллекцию типов DbParameter, используемых для параметризованного запроса
Cancel	Отменяет выполнение команды
ExecuteReader	Возвращает объект DbDataReader поставщика данных для доступа к соответствующим данным режиме однонаправленного чтения
ExecuteNonQuery	Направляет текст команды в хранилище данных
ExecuteScalar	"Облегченная" версия метода ExecuteNonQuery, предназначенная специально для запросов, возвращающих одиночные данные (например, как при запросе числа записей)
ExecuteXmlReader	В Microsoft SQL Server (2000 и более поздних версий) допускается возможность возвращения набора результатов в формате XML. Данный метод возвращает System.Xml.XmlReader, который позволяет обработать поступающий XML-поток
Prepare	Создает подготовленную (или скомпилированную) версию команды для источника данных. Вы, возможно, знаете, что готовый к использованию запрос выполняется быстрее, и это оказывается важно тогда, когда один и тот же запрос требуется выполнять многократно

Замечание. Позже в этой главе будет показано, что в .NET 2.0 у объекта SqlCommand появилось несколько дополнительных членов, упрощающих задачу асинхронного взаимодействия с базами данных.

Работа с объектами чтения данных

После создания активного соединения и SQL-команды следующим шагом является предъявление запроса источнику данных. Как вы, наверное, догадываетесь, это можно сделать несколькими способами. Тип DbDataReader (реализующий IDataReader) обеспечивает самый простой и самый быстрый способ получения информации из хранилища данных. Напомним, что объекты чтения данных создают однонаправленный и доступный только для чтения поток данных, возвращающей по одной записи за один раз. Поэтому должно быть вполне очевидно, что объекты чтения данных используются для отправки хранилищу данных только SQL-операторов выборки данных.