Variabili e argomenti

Articolo
02/27/2011

Le informazioni contenute in questo argomento sono valide per Windows Workflow Foundation 4.

In Windows Workflow Foundation (WF) le variabili rappresentano l'archivio di dati mentre gli argomenti il flusso di dati all'interno e all'esterno di un'attività. Un'attività dispone di un set di argomenti che costituiscono la firma dell'attività. Inoltre, un'attività può gestire un elenco di variabili a cui uno sviluppatore può aggiungere o rimuovere variabili durante la progettazione di un flusso di lavoro. Un argomento viene associato utilizzando un'espressione che restituisce un valore.

Variabili

Le variabili sono percorsi di archiviazione per i dati e vengono dichiarate come parte della definizione di un flusso di lavoro. Le variabili accettano valori in fase di esecuzione che vengono poi archiviati come parte dello stato di un'istanza del flusso di lavoro. Una definizione di variabile specifica il tipo di variabile e, facoltativamente, il nome. Nel codice seguente viene mostrato come dichiarare una variabile, assegnarvi un valore utilizzando un'attività Assign, quindi come visualizzare il relativo valore nella console utilizzando un'attività WriteLine.

// Define a variable named "str" of type string.
Variable<string> var = new Variable<string>
{
    Name = "str"
};

// Declare the variable within a Sequence, assign
// a value to it, and then display it.
Activity wf = new Sequence()
{
    Variables = { var },
    Activities =
    {
        new Assign<string>
        {
            To = var,
            Value = "Hello World."
        },
        new WriteLine
        {
            Text = var
        }
    }
};

WorkflowInvoker.Invoke(wf);

Un'espressione del valore predefinito può essere specificata facoltativamente come parte di una dichiarazione di variabile. Le variabili possono disporre anche di modificatori. Se ad esempio una variabile è di sola lettura, può essere applicato il modificatore VariableModifiers di sola lettura. Nell'esempio seguente viene creata una variabile di sola lettura con un valore predefinito assegnato.

// Define a read-only variable with a default value.
Variable<string> var = new Variable<string>
{
    Default = "Hello World.",
    Modifiers = VariableModifiers.ReadOnly
};

Ambito di variabili

La durata di una variabile in fase di esecuzione corrisponde alla durata dell'attività che la dichiara. Quando un'attività viene completata, le relative variabili vengono pulite e non possono essere più utilizzate come riferimento.

Argomenti

Gli autori di attività utilizzano gli argomenti per definire la modalità in cui i dati fluiscono all'interno e all'esterno di un'attività. Ogni argomento ha una direzione specificata: In, Out o InOut.

L'esecuzione del flusso di lavoro assicura le seguenti garanzie relativamente agli intervalli di spostamento dei dati all'interno e all'esterno di attività:

Quando si avvia l'esecuzione di un'attività, vengono calcolati i valori di tutti i relativi argomenti di input e di input/output. Ad esempio, indipendentemente da quando viene chiamato il metodo Get, il valore restituito sarà quello calcolato dal runtime antecedente alla chiamata di Execute.
Quando viene chiamato il metodo Set, il valore viene impostato immediatamente dal runtime.
Gli argomenti possono disporre facoltativamente della relativa proprietà EvaluationOrder specificata. La proprietà EvaluationOrder è un valore in base zero che specifica l'ordine in cui viene valutato l'argomento. Per impostazione predefinita, l'ordine di valutazione dell'argomento non è specificato e corrisponde al valore UnspecifiedEvaluationOrder. Impostare la proprietà EvaluationOrder su un valore maggiore o uguale a zero per specificare un ordine di valutazione per questo argomento. In Windows Workflow Foundation gli argomenti vengono valutati in base a un ordine di valutazione specificato crescente. Si noti che gli argomenti con un ordine di valutazione non specificato vengono valutati prima di quelli aventi un ordine di valutazione specificato.

Un autore di attività può utilizzare un meccanismo fortemente tipizzato per esporre gli argomenti. A tale scopo, vengono dichiarate proprietà di tipo InArgument, OutArgument e InOutArgument. In questo modo un autore di attività può stabilire un contratto specifico sui dati in ingresso o in uscita da un'attività.

Definizione di argomenti in un'attività

Gli argomenti possono essere definiti in un'attività specificando proprietà di tipo InArgument, OutArgument e InOutArgument. Nel codice seguente viene mostrato come definire gli argomenti per un'attività Prompt che include una stringa da visualizzare all'utente e restituisce una stringa che contiene la risposta dell'utente.

public class Prompt : Activity
{
    public InArgument<string> Text { get; set; }
    public OutArgument<string> Response { get; set; }
    // Rest of activity definition omitted.
}

Nota:
Le attività che restituiscono un singolo valore possono derivare dagli oggetti Activity, NativeActivity o CodeActivity. Queste attività dispongono di un oggetto OutArgument ben definito denominato Result che contiene il valore restituito dell'attività.

Utilizzo di variabili e argomenti nei flussi di lavoro

Nell'esempio seguente viene mostrato come vengono utilizzati variabili e argomenti in un flusso di lavoro. Il flusso di lavoro è una sequenza che dichiara tre variabili: var1, var2 e var3. La prima attività nel flusso di lavoro è un'attività Assign che assegna il valore di variabile var1 alla variabile var2. Questa attività è seguita da un'attività WriteLine che stampa il valore della variabile var2. La successiva è un'altra attività Assign che assegna il valore di variabile var2 alla variabile var3. Infine è disponibile un'altra attività WriteLine che stampa il valore della variabile var3. La prima attività Assign utilizza gli oggetti InArgument<string> e OutArgument<string> che rappresentano in modo esplicito le associazioni per gli argomenti dell'attività. L'oggetto InArgument<string> viene utilizzato per la proprietà Value perché il valore viene propagato all'interno dell'attività Assign tramite il relativo argomento Value, mentre l'oggetto OutArgument<string> viene utilizzato per la proprietà To perché il valore viene propagato all'esterno dell'argomento To nella variabile. La seconda attività Assign esegue la stessa operazione più compatta, ma con sintassi equivalente che utilizza cast impliciti. Anche le attività WriteLine utilizzano la sintassi compatta.

// Declare three variables; the first one is given an initial value.
Variable<string> var1 = new Variable<string>()
{
    Default = "one"
};
Variable<string> var2 = new Variable<string>();
Variable<string> var3 = new Variable<string>();

// Define the workflow
Activity wf = new Sequence
{
    Variables = { var1, var2, var3 },
    Activities = 
    {
        new Assign<string>()
        {
            Value = new InArgument<string>(var1),
            To = new OutArgument<string>(var2)
        },
        new WriteLine() { Text = var2 },
        new Assign<string>()
        {
            Value = var2,
            To = var3
        },
        new WriteLine() { Text = var3 }
    }
};

WorkflowInvoker.Invoke(wf);

Utilizzo di variabili e argomenti in attività basate su codice

Negli esempi precedenti viene mostrato come utilizzare argomenti e variabili in flussi di lavoro e attività dichiarative. Gli argomenti e le variabili vengono utilizzati anche in attività basate su codice. Dal punto di vista concettuale l'utilizzo è molto simile. Le variabili rappresentano l'archivio dati all'interno dell'attività, mentre gli argomenti rappresentano il flusso di dati all'interno o all'esterno dell'attività e vengono associati dall'autore del flusso di lavoro alle altre variabili o argomenti nel flusso di lavoro che rappresentano il punto dal quale o verso il quale fluiscono i dati. Per ottenere o impostare il valore di una variabile o di un argomento in un'attività, deve essere utilizzato un contesto di attività che rappresenta l'ambiente di esecuzione corrente dell'attività. Questo viene passato nel metodo Execute dell'attività dall'esecuzione del flusso di lavoro. In questo esempio viene definita un'attività Add personalizzata che dispone di due argomenti In. Per accedere al valore degli argomenti, vengono utilizzati il metodo Get e il contesto passato dall'esecuzione del flusso di lavoro.

public sealed class Add : CodeActivity<int>
{
    [RequiredArgument]
    public InArgument<int> Operand1 { get; set; }

    [RequiredArgument]
    public InArgument<int> Operand2 { get; set; }

    protected override int Execute(CodeActivityContext context)
    {
        return Operand1.Get(context) + Operand2.Get(context);
    }
}

Per ulteriori informazioni su utilizzo di argomenti, variabili ed espressioni nel codice, vedere Creazione di flussi di lavoro tramite codice imperativo e Argomenti obbligatori e gruppi di overload.

Condividi tramite