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

 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-операторов выборки данных.

Объекты чтения данных оказываются полезными тогда, когда требуется очень быстро просмотреть большой объем данных и при этом нет необходимости заботиться об их представлении в памяти. Например, если вы запрашиваете 20000 записей из таблицы для того, чтобы сохранить их в текстовом файле, то при хранении этой информации в DataSet возникает достаточно большая нагрузка на память. Более выгодным решением оказывается создание объекта чтения данных, который будет обрабатывать каждую запись настолько быстро, насколько это возможно. Но при этом следует учитывать то, что объекты чтения данных (в отличие от объектов адаптера данных, которые мы рассмотрим позже) поддерживают открытое соединение с источником данных, пока вы явно не закроете сеанс связи.

Объекты чтения данных получаются из объекта команды с помощью вызова ExecuteReader. При вызове этого метода объекту чтения данных можно дополнительно дать инструкцию автоматически закрыть соответствующий объект соединения, указав CommandBehavior.CloseConnection.

В следующем примере использования объекта чтения данных применяется метод Read для определения момента достижения конца записей (тогда возвращаемое значение оказывается равным false). Для каждой поступающей записи индексатору типа дается указание напечатать информацию о марке автомобиля, его названии и цвете. Также обратите внимание на то, что сразу же после завершении обработки записей вызывается метод Close, чтобы освободить объект соединения.

static void Main(string[] args) {
 …
 // Получение объекта чтения данных в стиле ExecuteReader.
 SqlDataReader myDataReader;
 myDataReader = myCommand.ExecuteReader(CommandBehavior.CloseConnection);
 // Цикл по результирующему набору.
 while(myDataReader.Read) {
 Console.WriteLine("-› Марка – {0}, название – {1}, цвет – {2}",
 myDataReader["Make"].ToString.Trim,
 myDataReader["PetName"].ToString.Trim,
 myDataReader["Color"]. ToString.Trim);
 }
 myDataReader.Close;
 ShowConnectionStatus(on);
}

Замечание. Обрезка строковых данных здесь используется только для того, чтобы удалить пробелы в конце полей базы данных, и это никак не связано с ADO.NET.

Индексатор объекта чтения данных перегружен, чтобы ему можно было передать либо строку (представляющую имя столбца), либо целое число (соответствующее порядковому номеру столбца). Поэтому вы можете немного "подчистить" соответствующий фрагмент программы (избавившись от необходимости печатания имен) и использовать вариант, показанный ниже (обратите внимание на использование свойства FieldCount).