Console.WriteLine("***** Info about your connection *****");
Console.WriteLine($@"Database location:
{connection.DataSource}"); // Местоположение базы данных
Console.WriteLine($"Database name: {connection.Database}");
// Имя базы данных
Console.WriteLine($@"Timeout:
{connection.ConnectionTimeout}"); // Таймаут
Console.WriteLine($"Connection state:
{connection.State}\n"); // Состояние подключения
}
Большинство этих свойств понятно без объяснений, но свойство
State
требует специального упоминания. Ему можно присвоить любое значение из перечисления
ConnectionState
:
public enum ConnectionState
{
Broken,
Closed,
Connecting,
Executing,
Fetching,
Open
}
Однако допустимыми значениями
ConnectionState
будут только
ConnectionState.Open
,
ConnectionState.Connecting
и
ConnectionState.Closed
(остальные члены перечисления зарезервированы для будущего использования). Кроме того, закрывать подключение всегда безопасно, даже если его состоянием в текущий момент является
ConnectionState.Closed
.
Работа с объектами ConnectionStringBuilder
Работа со строками подключения в коде может быть утомительной, т.к. они часто представлены в виде строковых литералов, которые в лучшем случае трудно обрабатывать и контролировать на предмет ошибок. Совместимые с .NET Core поставщики данных поддерживают объекты построителей строк подключения, которые позволяют устанавливать пары "имя-значение" с применением строго типизированных свойств. Взгляните на следующую модификацию текущего кода:
var connectionStringBuilder = new SqlConnectionStringBuilder
{
InitialCatalog = "AutoLot",
DataSource = ".,5433",
UserID = "sa",
Password = "P@ssw0rd",
ConnectTimeout = 30
};
connection.ConnectionString =
connectionStringBuilder.ConnectionString;
В этой версии создается экземпляр класса
SqlConnectionStringBuilder
, соответствующим образом устанавливаются его свойства, после чего с использованием свойства
ConnectionString
получается внутренняя строка. Обратите внимание, что здесь применяется стандартный конструктор типа. При желании объект построителя строки подключения для поставщика данных можно также создать, передав в качестве отправной точки существующую строку подключения (что может быть удобно, когда значения динамически читаются из внешнего источника). После наполнения объекта начальными строковыми данными отдельные пары "имя-значение" можно изменять с помощью связанных свойств.
Работа с объектами команд
Теперь, когда вы лучше понимаете роль объекта подключения, следующей задачей будет выяснение, каким образом отправлять SQL-запросы базе данных. Тип
SqlCommand
(производный от
DbCommand
) является объектно-ориентированным представлением SQL-запроса, имени таблицы или хранимой процедуры. Тип команды указывается с использованием свойства
CommandType
, которое принимает любое значение из перечисления
CommandType
:
public enum CommandType
{
StoredProcedure,
TableDirect,
Text // Стандартное значение.
}
При создании объекта команды SQL-запрос можно указывать как параметр конструктора или устанавливать свойство
CommandText
напрямую. Кроме того, когда создается объект команды, необходимо задать желаемое подключение. Его также можно указать в виде параметра конструктора либо с применением свойства
Connection
. Взгляните на следующий фрагмент кода:
// Создать объект команды посредством аргументов конструктора.
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-операторы выборки.
