Attività di accesso al database

Articolo
04/08/2023

Le attività di accesso al database consentono di accedere a un database all'interno di un flusso di lavoro. Queste attività consentono l'accesso ai database per recuperare o modificare informazioni e usare ADO.NET per accedere al database.

Attività di database

Nelle sezioni seguenti viene descritto in dettaglio l'elenco delle attività incluse nell'esempio DbActivities.

DbUpdate

Esegue una query SQL che produce una modifica nel database (inserimento, aggiornamento, eliminazione e altre modifiche).

Questa classe esegue le relative operazioni in modo asincrono (deriva da AsyncCodeActivity e usa le relative funzionalità asincrone).

È possibile configurare le informazioni di connessione impostando un nome invariante del provider (ProviderName) e la stringa di connessione (ConnectionString) o solo usando un nome di configurazione della stringa di connessione (ConfigFileSectionName) dal file di configurazione dell'applicazione.

La query da eseguire viene configurata nella relativa proprietà Sql e i parametri vengono passati tramite la raccolta Parameters.

Dopo l'esecuzione di DbUpdate, il numero di record interessati viene restituito nella proprietà 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; }
}

Argomento	Descrizione
ProviderName	Nome invariante del provider ADO.NET. Se viene impostato questo argomento, è necessario impostare anche `ConnectionString`.
ConnectionString	Stringa di connessione per connettersi al database. Se viene impostato questo argomento, è necessario impostare anche `ProviderName`.
ConfigName	Nome della sezione del file di configurazione in cui sono archiviate le informazioni di connessione. Quando viene impostato questo argomento, `ProviderName` e `ConnectionString` non sono richiesti.
CommandType	Tipo di DbCommand da eseguire.
Sql	Comando SQL da eseguire.
Parametri	Raccolta di parametri della query SQL.
AffectedRecords	Numero di record interessato dall'ultima operazione.

DbQueryScalar

Esegue una query che recupera un singolo valore dal database.

Questa classe esegue le relative operazioni in modo asincrono (deriva da AsyncCodeActivity<TResult> e usa le relative funzionalità asincrone).

La query da eseguire viene configurata nella relativa proprietà Sql e i parametri vengono passati tramite la raccolta Parameters.

Dopo l'esecuzione di DbQueryScalar, il valore scalare viene restituito nell'argomento Result out (di tipo TResult, definito nella classe di base 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; }
}

Argomento	Descrizione
ProviderName	Nome invariante del provider ADO.NET. Se viene impostato questo argomento, è necessario impostare anche `ConnectionString`.
ConnectionString	Stringa di connessione per connettersi al database. Se viene impostato questo argomento, è necessario impostare anche `ProviderName`.
ConfigName	Nome della sezione del file di configurazione in cui sono archiviate le informazioni di connessione. Quando viene impostato questo argomento, `ProviderName` e `ConnectionString` non sono richiesti.
CommandType	Tipo di DbCommand da eseguire.
Sql	Comando SQL da eseguire.
Parametri	Raccolta di parametri della query SQL.
Risultato	Valore scalare ottenuto dopo l'esecuzione della query. Questo argomento è di tipo `TResult`.

DbQuery

Esegue una query che recupera un elenco di oggetti. Dopo l'esecuzione della query, viene eseguita una funzione di mapping (può essere Func<TResult><DbDataReader, TResult> o una funzione ActivityFunc<TResult><DbDataReader, TResult>). Questa funzione di mapping ottiene un record in un oggetto DbDataReader e ne esegue il mapping all'oggetto da restituire.

La query da eseguire viene configurata nella relativa proprietà Sql e i parametri vengono passati tramite la raccolta Parameters.

I risultati della query SQL vengono recuperati usando un oggetto DbDataReader. L'attività scorre DbDataReader ed esegue il mapping delle righe in DbDataReader a un'istanza di TResult. L'utente di DbQuery deve fornire il codice di mapping. Questa operazione può essere effettuata in due modi: usando una funzione Func<TResult><DbDataReader, TResult> oppure ActivityFunc<TResult><DbDataReader, TResult>. Nel primo caso, il mapping viene eseguito in un singolo impulso. È pertanto più veloce, ma non può essere serializzato in XAML. Nel secondo caso, il mapping viene eseguito in più impulsi. Può quindi risultare più lento, ma può essere serializzato in XAML e modificato in modo dichiarativo (qualsiasi attività esistente può partecipare al mapping).

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; }
}

Argomento	Descrizione
ProviderName	Nome invariante del provider ADO.NET. Se viene impostato questo argomento, è necessario impostare anche `ConnectionString`.
ConnectionString	Stringa di connessione per connettersi al database. Se viene impostato questo argomento, è necessario impostare anche `ProviderName`.
ConfigName	Nome della sezione del file di configurazione in cui sono archiviate le informazioni di connessione. Quando viene impostato questo argomento, `ProviderName` e `ConnectionString` non sono richiesti.
CommandType	Tipo di DbCommand da eseguire.
Sql	Comando SQL da eseguire.
Parametri	Raccolta di parametri della query SQL.
Mapper	Funzione di mapping (Func<TResult><`DbDataReader`, `TResult`>) che accetta un record nell'oggetto `DataReader` ottenuto come risultato dell'esecuzione della query e restituisce un'istanza di un oggetto di tipo `TResult` da aggiungere alla raccolta `Result`. In questo caso, il mapping viene eseguito in un singolo impulso, ma non può essere modificato in modo dichiarativo tramite la finestra di progettazione.
MapperFunc	Funzione di mapping (ActivityFunc<TResult><`DbDataReader`, `TResult`>) che accetta un record nell'oggetto `DataReader` ottenuto come risultato dell'esecuzione della query e restituisce un'istanza di un oggetto di tipo `TResult` da aggiungere alla raccolta `Result`. In questo caso, il mapping viene eseguito in più impulsi. Questa funzione può essere serializzata in XAML e modificata in modo dichiarativo (qualsiasi attività esistente può partecipare al mapping).
Risultato	Elenco di oggetti ottenuto come risultato dell'esecuzione della query e dell'esecuzione della funzione di mapping per ogni record in `DataReader`.

DbQueryDataSet

Esegue una query che restituisce un oggetto DataSet. Questa classe esegue le relative operazioni in modo asincrono. Deriva da AsyncCodeActivity<TResult> e usa le relative funzionalità asincrone.

La query da eseguire viene configurata nella relativa proprietà Sql e i parametri vengono passati tramite la raccolta Parameters.

Dopo l'esecuzione di DbQueryDataSet, DataSet viene restituito nell'argomento Result out (di tipo TResult, definito nella classe di base 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; }
}

Argomento	Descrizione
ProviderName	Nome invariante del provider ADO.NET. Se viene impostato questo argomento, è necessario impostare anche `ConnectionString`.
ConnectionString	Stringa di connessione per connettersi al database. Se viene impostato questo argomento, è necessario impostare anche `ProviderName`.
ConfigName	Nome della sezione del file di configurazione in cui sono archiviate le informazioni di connessione. Quando viene impostato questo argomento, `ProviderName` e `ConnectionString` non sono richiesti.
CommandType	Tipo di DbCommand da eseguire.
Sql	Comando SQL da eseguire.
Parametri	Raccolta di parametri della query SQL.
Risultato	DataSet ottenuto dopo l'esecuzione della query.

Configurazione delle informazioni di connessione

Tutte le attività DbActivities condividono gli stessi parametri di configurazione. Possono essere configurate in due modi:

ConnectionString + InvariantName: impostare il nome invariante del provider ADO.NET e la stringa di connessione.

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

ConfigName: impostare il nome della sezione di configurazione che contiene le informazioni di connessione.

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

Nell'attività:

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

Esecuzione dell'esempio

Istruzioni di impostazione

In questo esempio viene usato un database. Con l'esempio viene fornito uno script di impostazione e caricamento (Setup.cmd) . È necessario eseguire il file dal prompt dei comandi.

Lo script Setup.cmd richiama il file di script CreateDb.sql che contiene i comandi SQL per l'esecuzione delle operazioni seguenti:

Crea un database denominato DbActivitiesSample.
Crea la tabella Ruoli.
Crea la tabella Employees.
Inserisce tre record nella tabella Ruoli.
Inserisce dodici record nella tabella Employees.

Per eseguire Setup.cmd

Apri un prompt dei comandi.
Passare alla cartella di esempio DbActivities.
Digitare "setup.cmd" e premere INVIO.

Nota

Setup.cmd tenta di installare l'esempio nell'istanza di SqlExpress del computer locale. Se si desidera installarlo in un'altra istanza del server SQL, modificare Setup.cmd specificando il nome della nuova istanza.

Per disinstallare il database di esempio

Eseguire Cleanup.cmd dalla cartella di esempio in un prompt dei comandi.

Per eseguire l'esempio

Aprire la soluzione in Visual Studio
Per compilare la soluzione, premere CTRL+MAIUSC+B.
Per eseguire l'esempio senza debug, premere CTRL+F5.

Importante

È possibile che gli esempi siano già installati nel computer. Verificare la directory seguente (impostazione predefinita) prima di continuare.

<InstallDrive>:\WF_WCF_Samples

Se questa directory non esiste, andare alla sezione relativa agli esempi di Windows Communication Foundation (WCF) e Windows Workflow Foundation (WF) per .NET Framework 4 per scaricare tutti gli esempi di Windows Communication Foundation (WCF) e WF. Questo esempio si trova nella directory seguente.

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

Attività di accesso al database

Attività di database

DbUpdate

DbQueryScalar

DbQuery

DbQueryDataSet

Configurazione delle informazioni di connessione

Esecuzione dell'esempio

Istruzioni di impostazione

Per eseguire Setup.cmd

Per disinstallare il database di esempio

Per eseguire l'esempio

Commenti e suggerimenti

Risorse aggiuntive