Attività 2: definizione dell'interfaccia IExpenseReportService

Articolo
09/01/2008

In questa attività viene creata l'interfaccia IExpenseReportService. Questa interfaccia consente al flusso di lavoro e all'applicazione host di comunicare utilizzando un protocollo predefinito. L'interfaccia contiene due metodi che vengono utilizzati dal flusso di lavoro per chiamare un metodo definito nell'applicazione host. Vengono inoltre definiti due eventi per l'applicazione host per comunicare al flusso di lavoro quando si verificano determinati eventi.

Nota

Anche se è consigliabile seguire gli esercizi in modo lineare, non è strettamente necessario. È possibile iniziare l'esercizio aprendo il progetto di esempio e procedendo secondo i passaggi illustrati nella sezione seguente.

Definizione e implementazione dell'interfaccia

Definire l'interfaccia come illustrato nella procedura seguente.

Per definire l'interfaccia IExpenseReportService

Nel file di codice sorgente SimpleExpenseReport creare un'interfaccia public denominata IExpenseReportService e aggiungere all'interfaccia l'attributo ExternalDataExchangeAttribute.
Aggiungere un metodo denominato GetLeadApproval che accetta un parametro String denominato message all'interfaccia IExpenseReportService.
Aggiungere un metodo denominato GetManagerApproval che accetta un parametro String denominato message all'interfaccia IExpenseReportService.
Aggiungere un evento generico EventHandler di tipo ExternalDataEventArgs denominato ExpenseReportApproved.

Aggiungere un evento generico EventHandler di tipo ExternalDataEventArgs denominato ExpenseReportRejected.

Il codice seguente mostra la definizione completata dell'interfaccia IExpenseReportService.

[ExternalDataExchange]
public interface IExpenseReportService
{
    void GetLeadApproval(string message);
    void GetManagerApproval(string message);
    event EventHandler<ExternalDataEventArgs> ExpenseReportApproved;
    event EventHandler<ExternalDataEventArgs> ExpenseReportRejected;
}

Implementazione dell'interfaccia

Modificare la classe MainForm in modo che possa implementare l'interfaccia IExpenseReportService.

Per implementare l'interfaccia IExpenseReportService

Modificare la dichiarazione della classe MainForm in modo che possa implementare l'interfaccia IExpenseReportService.

Nota

Questo passaggio rappresenta un passaggio aggiuntivo a quello relativo alla classe Form dalla quale deriva la classe MainForm.
```
public class MainForm : Form, IExpenseReportService
```
Nella classe MainForm creare un metodo delegato private denominato GetApprovalDelegate che accetta un parametro String denominato message.
```
private delegate void GetApprovalDelegate(string message);
```
Nella classe MainForm creare un evento EventHandler generico private di tipo ExternalDataEventArgs denominato reportApproved.
```
private event EventHandler<ExternalDataEventArgs> reportApproved;
```
Nella classe MainForm creare un evento EventHandler generico private di tipo ExternalDataEventArgs denominato reportRejected.
```
private event EventHandler<ExternalDataEventArgs> reportRejected;
```
Nella classe MainForm creare una proprietà di evento EventHandler generico public di tipo ExternalDataEventArgs denominata ExpenseReportApproved.
Nella proprietà di evento ExpenseReportApproved creare le funzioni di accesso add e remove per aggiungere e rimuovere i gestori eventi dall'evento reportApproved.
```
private ExternalDataExchangeService exchangeService = null;
```
Nella classe MainForm creare una proprietà di evento EventHandler generico pubblico di tipo ExternalDataEventArgs denominata ExpenseReportRejected.

Nella proprietà di evento ExpenseReportRejected creare le funzioni di accesso add e remove per aggiungere e rimuovere i gestori eventi dall'evento reportRejected.

public event EventHandler<ExternalDataEventArgs> ExpenseReportApproved
{
    add
    {
        reportApproved += value;
    }
    remove
    {
        reportApproved -= value;
    }
}

Nella classe MainForm, creare un campo privato ExternalDataExchangeService denominato exchangeService.

public event EventHandler<ExternalDataEventArgs> ExpenseReportRejected
{
    add
    {
        reportRejected += value;
    }
    remove
    {
        reportRejected -= value;
    }
}

Nel costruttore MainForm creare una nuova istanza dell'oggetto exchangeService dopo aver creato l'oggetto workflowRuntime.
Chiamare il metodo AddService dell'oggetto workflowRuntime passando l'oggetto exchangeService come un parametro.

Chiamare il metodo AddService dell'oggetto exchangeService passando l'istanza della classe MainForm come un parametro.

this.workflowRuntime = new WorkflowRuntime();

this.exchangeService = new ExternalDataExchangeService();
workflowRuntime.AddService(exchangeService);
exchangeService.AddService(this);
workflowRuntime.StartRuntime();

Nella classe MainForm creare un metodo public denominato GetLeadApproval che accetta un parametro String denominato message.
```
public void GetLeadApproval(string message)
{
}
```
Nella classe MainForm creare un metodo public denominato GetManagerApproval che accetta un parametro String denominato message.
```
public void GetManagerApproval(string message)
{
}
```

Compilazione del codice

Per informazioni sulla compilazione del codice, vedere Compilazione del codice.

Nota

A questo punto, quando si compila il progetto vengono visualizzati due avvisi. Nella prossima attività verranno utilizzati gli eventi ExpenseReportApproved e ExpenseReportRejected.

In Esercizio 3: creare il flusso di lavoro sequenziale del report di spesa semplice verrà completata la creazione del flusso di lavoro sequenziale aggiungendo attività che comunicano con l'applicazione host.

Vedere anche

Footer image

Condividi tramite

Attività 2: definizione dell'interfaccia IExpenseReportService

Definizione e implementazione dell'interfaccia

Per definire l'interfaccia IExpenseReportService

Implementazione dell'interfaccia

Per implementare l'interfaccia IExpenseReportService

Compilazione del codice

Vedere anche

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive