Язык программирования C#9 и платформа .NET5

 // Создать объект команды посредством аргументов конструктора.
 string sql =
  @"Select i.id, m.Name as Make, i.Color, i.Petname
  FROM Inventory i
  INNER JOIN Makes m on m.Id = i.MakeId";
 SqlCommand myCommand = new SqlCommand(sql, connection);

 // Создать еще один объект команды через свойства.
 SqlCommand testCommand = new SqlCommand;
 testCommand.Connection = connection;
 testCommand.CommandText = sql;

Учтите, что в текущий момент вы еще фактически не отправили SQL-запрос базе данных AutoLot, а только подготовили состояние объекта команды для будущего использования.

В табл. 21.5 описаны некоторые дополнительные члены типа DbCommand.

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

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

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

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

Объекты чтения данных получаются из объекта команды с применением вызова ExecuteReader. Объект чтения данных представляет текущую запись, прочитанную из базы данных. Он имеет метод индексатора (например, синтаксис [] в языке С#), который позволяет обращаться к столбцам текущей записи. Доступ к конкретному столбцу возможен либо по имени, либо по целочисленному индексу, начинающемуся с нуля.

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

 ...
 // Получить объект чтения данных посредством ExecuteReader.
 using(SqlDataReader myDataReader = myCommand.ExecuteReader)
 {
  // Пройти в цикле по результатам.
  while (myDataReader.Read)
  {
  WriteLine($"-> Make: { myDataReader["Make"]},
  PetName: { myDataReader["PetName"]},
  Color: { myDataReader["Color"]}.");
  }
 }
 ReadLine;

Индексатор объекта чтения данных перегружен для приема либо значения string (имя столбца), либо значения int (порядковый номер столбца). Таким образом, текущую логику объекта чтения можно сделать яснее (и избежать жестко закодированных строковых имен), внеся следующие изменения (обратите внимание на использование свойства FieldCount):

 while (myDataReader.Read)
 {
  for (int i = 0; i < myDataReader.FieldCount; i++)
  {
  Console.Write(i != myDataReader.FieldCount - 1
  ? $"{myDataReader.GetName(i)} = {myDataReader.GetValue(i)}, "
  : $"{myDataReader.GetName(i)} = {myDataReader.GetValue(i)} ");
  }
  Console.WriteLine;
 }

Если в настоящий момент скомпилировать проект и запустить его на выполнение, то должен отобразиться список всех автомобилей из таблицы Inventory базы данных AutoLot. В следующем выводе показано несколько начальных записей:

 ***** Fun with Data Readers *****
 ***** Info about your connection *****
 Database location: .,5433
 Database name: AutoLot
 Timeout: 30
 Connection state: Open
 id = 1, Make = VW, Color = Black, Petname = Zippy
 id = 2, Make = Ford, Color = Rust, Petname = Rusty
 id = 3, Make = Saab, Color = Black, Petname = Mel
 id = 4, Make = Yugo, Color = Yellow, Petname = Clunker
 id = 5, Make = BMW, Color = Black, Petname = Bimmer
 id = 6, Make = BMW, Color = Green, Petname = Hank
 id = 7, Make = BMW, Color = Pink, Petname = Pinky
 id = 8, Make = Pinto, Color = Black, Petname = Pete
 id = 9, Make = Yugo, Color = Brown, Petname = Brownie

Получение множества результирующих наборов с использованием объекта чтения данных

Объекты чтения данных могут получать несколько результирующих наборов с применением одиночного объекта команды. Например, если вы хотите получить все строки из таблицы Inventory, а также все строки из таблицы Customers, тогда можете указать два SQL-оператора Select, разделив их точкой с запятой:

 sql += ";Select * from Customers;";

На заметку! Точка с запятой в начале строки опечаткой не является. В случае использования множества операторов они должны разделяться точками с запятой. И поскольку начальный оператор не содержал точку с запятой, она добавлена здесь в начало второго оператора.