Variabili e argomenti
In Windows Workflow Foundation, le variabili rappresentano l'archiviazione dei dati, mentre gli argomenti rappresentano 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 usando 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 usando un'attività Assign<T>, quindi come visualizzare il relativo valore nella console usando 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ù usate come riferimento.
Argomenti
Gli autori di attività usano 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.
Facoltativamente gli argomenti possono avere il proprio EvaluationOrder specificato. 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. Windows Workflow Foundation valuta gli argomenti 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ò usare un meccanismo fortemente tipizzato per esporre gli argomenti. A tale scopo, vengono dichiarate proprietà di tipo InArgument<T>, OutArgument<T> e InOutArgument<T>. 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<T>, OutArgument<T> e InOutArgument<T>. 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<TResult>, NativeActivity<TResult> o CodeActivity<TResult>. Queste attività dispongono di un oggetto OutArgument<T> ben definito denominato Result che contiene il valore restituito dell'attività.
Uso di variabili e argomenti nei flussi di lavoro
Nell'esempio seguente viene mostrato come vengono usati 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 usa gli oggetti InArgument<string> e OutArgument<string> che rappresentano in modo esplicito le associazioni per gli argomenti dell'attività. L'oggetto InArgument<string> viene usato per Value in quanto il valore passa nell'attività Assign<T> attraverso il relativo argomento Value; l'oggetto OutArgument<string> viene usato per To in quanto il valore passa dall'argomento To alla variabile. La seconda attività Assign esegue la stessa operazione più compatta, ma con sintassi equivalente che usa cast impliciti. Anche le attività WriteLine usano 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);
Uso di variabili e argomenti in attività basate su codice
Negli esempi precedenti viene mostrato come usare argomenti e variabili in flussi di lavoro e attività dichiarative. Gli argomenti e le variabili vengono usati anche in attività basate su codice. Dal punto di vista concettuale l'uso è 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 usato 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 usati 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 altre informazioni sull'uso di argomenti, variabili ed espressioni nel codice, vedere Creazione di flussi di lavoro, attività ed espressioni tramite codice imperativo e Argomenti obbligatori e gruppi di overload.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per