Действия по доступу к базам данных

Действия доступа к базе данных позволяют обращаться к базе данных из рабочего процесса. Эти действия позволяют получать или изменять сведения и использовать ADO.NET для доступа к базе данных.

Действия базы данных

В следующих разделах подробно описан список действий, включенных в пример DbActivities.

DbUpdate

Выполняет SQL-запрос, который реализует изменение в базе данных (вставку, обновление, удаление или иные изменения).

Этот класс выполняет работу асинхронно (он является производным от класса AsyncCodeActivity и использует его возможности для асинхронной работы).

Чтобы настроить сведения о соединении, можно задать неизменяемое имя поставщика (ProviderName) и строку соединения (ConnectionString) или использовать имя конфигурации строки соединения (ConfigFileSectionName) из файла конфигурации приложения.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

Запрос для выполнения настраивается в свойстве Sql, а параметры передаются через коллекцию Parameters.

После выполнения DbUpdate количество измененных записей возвращается в свойстве AffectedRecords.

Public class DbUpdate: AsyncCodeActivity
{
    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DefaultValue(null)]
    public InArgument<string> ProviderName { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DependsOn("ProviderName")]
    [DefaultValue(null)]
    public InArgument<string> ConnectionString { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConfigFileSectionName")]
    [DefaultValue(null)]
    public InArgument<string> ConfigName { get; set; }

    [DefaultValue(null)]
    public CommandType CommandType { get; set; }

    [RequiredArgument]
    public InArgument<string> Sql { get; set; }

    [DependsOn("Sql")]
    [DefaultValue(null)]
    public IDictionary<string, Argument> Parameters { get; }

    [DependsOn("Parameters")]
    public OutArgument<int> AffectedRecords { get; set; }
}

Аргумент	Description
ProviderName	Неизменяемое имя поставщика ADO.NET. Если этот аргумент задан, то необходимо задать и аргумент ConnectionString.
ConnectionString	Строка соединения для подключения к базе данных. Если этот аргумент задан, то необходимо задать и аргумент ProviderName.
ConfigName	Имя раздела файла конфигурации, в котором хранятся сведения о соединении. Если этот аргумент задан, то аргументы ProviderName и ConnectionString не требуются.
CommandType	Тип выполняемой команды DbCommand.
SQL	Команда SQL для выполнения.
Параметры	Коллекция параметров SQL-запроса.
AffectedRecords	Количество записей, на которые повлияла последняя операция.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

DbQueryScalar

Выполняет запрос, возвращающий единичное значение данные из базы данных.

Этот класс выполняет работу асинхронно (он является производным от класса AsyncCodeActivity<TResult> и использует его возможности для асинхронной работы).

Чтобы настроить сведения о соединении, можно задать неизменяемое имя поставщика (ProviderName) и строку соединения (ConnectionString) или использовать имя конфигурации строки соединения (ConfigFileSectionName) из файла конфигурации приложения.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

Запрос для выполнения настраивается в свойстве Sql, а параметры передаются через коллекцию Parameters.

После DbQueryScalar выполнения скаляр возвращается в Result out аргументе (тип TResult, определенный в базовом классе AsyncCodeActivity<TResult>).

public class DbQueryScalar<TResult> : AsyncCodeActivity<TResult>
{
    // public arguments
    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DefaultValue(null)]
    public InArgument<string> ProviderName { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DependsOn("ProviderName")]
    [DefaultValue(null)]
    public InArgument<string> ConnectionString { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConfigFileSectionName")]
    [DefaultValue(null)]
    public InArgument<string> ConfigName { get; set; }

    [DefaultValue(null)]
    public CommandType CommandType { get; set; }

    [RequiredArgument]
    public InArgument<string> Sql { get; set; }

    [DependsOn("Sql")]
    [DefaultValue(null)]
    public IDictionary<string, Argument> Parameters { get; }
}

Аргумент	Description
ProviderName	Неизменяемое имя поставщика ADO.NET. Если этот аргумент задан, то необходимо задать и аргумент ConnectionString.
ConnectionString	Строка соединения для подключения к базе данных. Если этот аргумент задан, то необходимо задать и аргумент ProviderName.
CommandType	Тип выполняемой команды DbCommand.
ConfigName	Имя раздела файла конфигурации, в котором хранятся сведения о соединении. Если этот аргумент задан, то аргументы ProviderName и ConnectionString не требуются.
SQL	Команда SQL для выполнения.
Параметры	Коллекция параметров SQL-запроса.
Результат	Скаляр, полученный после выполнения запроса. Этот аргумент имеет тип TResult.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

DbQuery

Выполняет запрос, который возвращает список объектов. После выполнения запроса выполняется функция сопоставления (это может быть Func<TResult>TResult><DbDataReaderили<DbDataReaderActivityFunc<TResult> , или ). TResult> Эта функция сопоставления получает запись в DbDataReader и сопоставляет ее возвращаемому объекту.

Чтобы настроить сведения о соединении, можно задать неизменяемое имя поставщика (ProviderName) и строку соединения (ConnectionString) или использовать имя конфигурации строки соединения (ConfigFileSectionName) из файла конфигурации приложения.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

Запрос для выполнения настраивается в свойстве Sql, а параметры передаются через коллекцию Parameters.

Результаты SQL-запроса извлекаются с использованием DbDataReader. Действие выполняет перебор по DbDataReader и сопоставляет строки в DbDataReader с экземпляром TResult. Пользователь DbQuery должен предоставить код сопоставления, и это можно сделать двумя способами: с помощью Func<TResult>DbDataReader> TResult</a0ActivityFunc<TResult><DbDataReaderTResult>>. В первом случае сопоставление совершается на одном шаге выполнения. Поэтому этот способ быстрее, но сериализация в XAML невозможна. Во втором случае сопоставление выполняется в несколько шагов. Поэтому может потребоваться больше времени, зато возможны сериализация в XAML и декларативное авторство (любое существующее действие может участвовать в сопоставлении).

public class DbQuery<TResult> : AsyncCodeActivity<IList<TResult>> where TResult : class
{
    // public arguments
    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DefaultValue(null)]
    public InArgument<string> ProviderName { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DependsOn("ProviderName")]
    [DefaultValue(null)]
    public InArgument<string> ConnectionString { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConfigFileSectionName")]
    [DefaultValue(null)]
    public InArgument<string> ConfigName { get; set; }

    [DefaultValue(null)]
    public CommandType CommandType { get; set; }

    [RequiredArgument]
    public InArgument<string> Sql { get; set; }

    [DependsOn("Sql")]
    [DefaultValue(null)]
    public IDictionary<string, Argument> Parameters { get; }

    [OverloadGroup("DirectMapping")]
    [DefaultValue(null)]
    public Func<DbDataReader, TResult> Mapper { get; set; }

    [OverloadGroup("MultiplePulseMapping")]
    [DefaultValue(null)]
    public ActivityFunc<DbDataReader, TResult> MapperFunc { get; set; }
}

Аргумент	Description
ProviderName	Неизменяемое имя поставщика ADO.NET. Если этот аргумент задан, то необходимо задать и аргумент ConnectionString.
ConnectionString	Строка соединения для подключения к базе данных. Если этот аргумент задан, то необходимо задать и аргумент ProviderName.
CommandType	Тип выполняемой команды DbCommand.
ConfigName	Имя раздела файла конфигурации, в котором хранятся сведения о соединении. Если этот аргумент задан, то аргументы ProviderName и ConnectionString не требуются.
SQL	Команда SQL для выполнения.
Параметры	Коллекция параметров SQL-запроса.
Сопоставитель	Функция сопоставления (Func<TResult>DbDataReader<, TResult>) которая принимает запись в полученном в DataReader результате выполнения запроса и возвращает экземпляр объекта типаTResult, добавляемого в Result коллекцию. В этом случае сопоставление совершается на одном шаге выполнения, но декларативное авторство с использованием конструктора невозможно.
MapperFunc	Функция сопоставления (ActivityFunc<TResult>DbDataReader<, TResult>) которая принимает запись в полученном в DataReader результате выполнения запроса и возвращает экземпляр объекта типаTResult, добавляемого в Result коллекцию. В этом случае сопоставление совершается в несколько шагов выполнения. Для этой функции возможны сериализация в XAML и декларативное авторство (любое существующее действие может участвовать в сопоставлении).
Результат	Список объектов, полученный в результате выполнения запроса и выполнения функции сопоставления для каждой записи в DataReader.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

DbQueryDataSet

Выполняет запрос, который возвращает DataSet. Этот класс выполняет работу асинхронно. Он является производным от AsyncCodeActivity<TResult> асинхронных возможностей.

Чтобы настроить сведения о соединении, можно задать неизменяемое имя поставщика (ProviderName) и строку соединения (ConnectionString) или использовать имя конфигурации строки соединения (ConfigFileSectionName) из файла конфигурации приложения.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

Запрос для выполнения настраивается в свойстве Sql, а параметры передаются через коллекцию Parameters.

DbQueryDataSet После выполнения DataSet возвращается в Result out аргументе (типTResult, определенный в базовом классеAsyncCodeActivity<TResult>).

public class DbQueryDataSet : AsyncCodeActivity<DataSet>
{
    // public arguments
    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DefaultValue(null)]
    public InArgument<string> ProviderName { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConnectionString")]
    [DependsOn("ProviderName")]
    [DefaultValue(null)]
    public InArgument<string> ConnectionString { get; set; }

    [RequiredArgument]
    [OverloadGroup("ConfigFileSectionName")]
    [DefaultValue(null)]
    public InArgument<string> ConfigName { get; set; }

    [DefaultValue(null)]
    public CommandType CommandType { get; set; }

    [RequiredArgument]
    public InArgument<string> Sql { get; set; }

    [DependsOn("Sql")]
    [DefaultValue(null)]
    public IDictionary<string, Argument> Parameters { get; }
}

Аргумент	Description
ProviderName	Неизменяемое имя поставщика ADO.NET. Если этот аргумент задан, то необходимо задать и аргумент ConnectionString.
ConnectionString	Строка соединения для подключения к базе данных. Если этот аргумент задан, то необходимо задать и аргумент ProviderName.
ConfigName	Имя раздела файла конфигурации, в котором хранятся сведения о соединении. Если этот аргумент задан, то аргументы ProviderName и ConnectionString не требуются.
CommandType	Тип выполняемой команды DbCommand.
SQL	Команда SQL для выполнения.
Параметры	Коллекция параметров SQL-запроса.
Результат	DataSet, полученный после выполнения запроса.

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

Настройка сведений о подключении

Все DbActivities используют одни и те же параметры конфигурации. Их можно настроить двумя способами.

• ConnectionString + InvariantName: Укажите неизменяемое имя поставщика ADO.NET и строку соединения.

  Activity dbSelectCount = new DbQueryScalar<DateTime>()
  {
      ProviderName = "System.Data.SqlClient",
      ConnectionString = @"Data Source=.\SQLExpress;
                            Initial Catalog=DbActivitiesSample;
                            Integrated Security=True",
      Sql = "SELECT GetDate()"
  };
  

• ConfigName: Укажите имя раздела конфигурации, в котором содержатся сведения о соединении.

  <connectionStrings>
      <add name="DbActivitiesSample"
            providerName="System.Data.SqlClient"
            connectionString="Data Source=.\SQLExpress;Initial Catalog=DbActivitiesSample;Integrated Security=true"/>
    </connectionStrings>
  

  В действии:

  Activity dbSelectCount = new DbQueryScalar<int>()
  {
      ConfigName = "DbActivitiesSample",
      Sql = "SELECT COUNT(*) FROM Roles"
  };
  

Внимание

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Если вы подключаетесь к SQL Azure, управляемые удостоверения для ресурсов Azure — это рекомендуемый метод проверки подлинности.

Запустите этот пример

Инструкции по установке

Этот образец использует базу данных. Вместе с образцом предоставляется скрипт установки и загрузки (Setup.cmd). Этот файл необходимо выполнить из командной строки.

Скрипт Setup.cmd вызывает файл скрипта CreateDb.sql, который содержит команды SQL и выполняет следующие операции.

• Создает базу данных под именем DbActivitiesSample.
• Создает таблицу Roles.
• Создает таблицу Employees.
• Вставляет 3 записи в таблицу Roles.
• Вставляет двенадцать записей в таблицу Employees.

Запуск команды Setup.cmd

1. Откройте командную строку.

2. Перейдите в папку образца DbActivities.

3. Введите "setup.cmd" и нажмите клавишу ВВОД.

   Примечание.

   Скрипт Setup.cmd пытается установить образец базы данных на экземпляр SQLExpress на локальном компьютере. Если образец необходимо установить на другом экземпляре сервера SQL, измените Setup.cmd, указав другое имя экземпляра.

Запуск образца

1. Откройте решение в Visual Studio.
2. Чтобы скомпилировать решение, нажмите клавиши CTRL+SHIFT+B.
3. Чтобы запустить пример без отладки, нажмите клавиши CTRL+F5.

Чтобы удалить образец базы данных, запустите Cleanup.cmd из папки образца в командной строке.

Внимание

На компьютере уже могут быть установлены примеры. Перед продолжением проверьте следующий каталог (по умолчанию).

<InstallDrive>:\WF_WCF_Samples

Если этот каталог не существует, перейдите в примеры Windows Communication Foundation (WCF) и Windows Workflow Foundation (WF) для платформа .NET Framework скачивания всех примеров Windows Communication Foundation (WCF) и WF. Этот образец расположен в следующем каталоге.

<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\DbActivities