WorkflowRuntime Constructeurs

Définition

Espace de noms:

System.Workflow.Runtime

Assembly:

System.Workflow.Runtime.dll

Initialise une nouvelle instance de la classe WorkflowRuntime.

Surcharges

WorkflowRuntime()	Initialise une nouvelle instance de la classe WorkflowRuntime.
WorkflowRuntime(String)	Initialise une nouvelle instance de la classe WorkflowRuntime en utilisant la section spécifiée du fichier de configuration de l'application.
WorkflowRuntime(WorkflowRuntimeSection)	Initialise une nouvelle instance de la classe WorkflowRuntime en utilisant les paramètres de la WorkflowRuntimeSection spécifiée.

WorkflowRuntime()

Initialise une nouvelle instance de la classe WorkflowRuntime.

public:
 WorkflowRuntime();

public WorkflowRuntime ();

Public Sub New ()

Exemples

L'exemple de code suivant montre comment vous pouvez utiliser les fonctionnalités WorkflowRuntime d'un hôte de workflow. Il fournit un exemple sur l'utilisation du constructeur WorkflowRuntime pour créer une instance de WorkflowRuntime et accéder à ses méthodes et événements.

Cet exemple de code fait partie de l’exemple d’annulation d’un flux de travail .

static void Main()
{
    string connectionString = "Initial Catalog=SqlPersistenceService;Data Source=localhost;Integrated Security=SSPI;";

    using (WorkflowRuntime workflowRuntime = new WorkflowRuntime())
    {
        ExternalDataExchangeService dataService = new ExternalDataExchangeService();
        workflowRuntime.AddService(dataService);
        dataService.AddService(expenseService);

        workflowRuntime.AddService(new SqlWorkflowPersistenceService(connectionString));
        workflowRuntime.StartRuntime();

        workflowRuntime.WorkflowCompleted += OnWorkflowCompleted;
        workflowRuntime.WorkflowTerminated += OnWorkflowTerminated;
        workflowRuntime.WorkflowIdled += OnWorkflowIdled;
        workflowRuntime.WorkflowAborted += OnWorkflowAborted;

        Type type = typeof(SampleWorkflow1);
        WorkflowInstance workflowInstance = workflowRuntime.CreateWorkflow(type);
        workflowInstance.Start();

        waitHandle.WaitOne();

        workflowRuntime.StopRuntime();
    }
}

Shared Sub Main()
    Dim connectionString As String = "Initial Catalog=SqlPersistenceService;Data Source=localhost;Integrated Security=SSPI;"
    Using workflowRuntime As New WorkflowRuntime()
        Dim dataService As New ExternalDataExchangeService()
        workflowRuntime.AddService(dataService)
        dataService.AddService(expenseService)

        workflowRuntime.AddService(New SqlWorkflowPersistenceService(connectionString))


        AddHandler workflowRuntime.WorkflowCompleted, AddressOf OnWorkflowCompleted
        AddHandler workflowRuntime.WorkflowTerminated, AddressOf OnWorkflowTerminated
        AddHandler workflowRuntime.WorkflowIdled, AddressOf OnWorkflowIdled
        AddHandler workflowRuntime.WorkflowAborted, AddressOf OnWorkflowAborted


        Dim workflowInstance As WorkflowInstance
        workflowInstance = workflowRuntime.CreateWorkflow(GetType(SampleWorkflow))
        workflowInstance.Start()

        waitHandle.WaitOne()

        workflowRuntime.StopRuntime()
    End Using
End Sub

Remarques

Le WorkflowRuntime est initialisé avec les valeurs de propriété par défaut et contient les services principaux par défaut. Pour configurer également le moteur d'exécution de workflow, vous pouvez ajouter et supprimer des services à l'aide des méthodes AddService et RemoveService, et vous pouvez définir la propriété Name. Après avoir configuré l'objet WorkflowRuntime, appelez la méthode StartRuntime pour démarrer le moteur d'exécution de workflow et ses services.

Le tableau suivant indique les valeurs de propriétés initiales d'une instance de la classe WorkflowRuntime.

Propriété	Valeur initiale
Name	"WorkflowRuntime"
IsStarted	false

Les services principaux par défaut sont les objets DefaultWorkflowCommitWorkBatchService et DefaultWorkflowSchedulerService.

WorkflowRuntime(String)

Initialise une nouvelle instance de la classe WorkflowRuntime en utilisant la section spécifiée du fichier de configuration de l'application.

public:
 WorkflowRuntime(System::String ^ configSectionName);

public WorkflowRuntime (string configSectionName);

new System.Workflow.Runtime.WorkflowRuntime : string -> System.Workflow.Runtime.WorkflowRuntime

Public Sub New (configSectionName As String)

Paramètres

configSectionName

String

Nom d'une section workflowSettings valide dans le fichier de configuration de l'application.

Exceptions

ArgumentNullException

configSectionName est une référence Null (Nothing en Visual Basic).

ArgumentException

Une section workflowSettings valide n'a pas pu être trouvée dans le fichier de configuration de l'application.

InvalidOperationException

Il existe déjà un WorkflowRuntime pour ce domaine d'application.

Remarques

Le WorkflowRuntime est initialisé d'après les paramètres dans la section spécifiée par configSectionName dans le fichier de configuration de l'application. configSectionName doit correspondre à une section valide workflowSettings d’un fichier de configuration.

Lorsque le moteur d’exécution du workflow est configuré à l’aide d’un fichier de configuration d’application, il charge et instancie les classes des types répertoriés dans la Services section du fichier de configuration. Lorsque le moteur d'exécution de workflow construit ces classes, il recherche des constructeurs de classe avec les signatures suivantes dans l'ordre suivant :

1. Service(exécution WorkflowRuntime, paramètres NameValueCollection)

2. Service(exécution WorkflowRuntime)

3. Service(paramètres NameValueCollection)

4. Service()

Toutes les classes de service chargées à partir d'un fichier de configuration doivent implémenter au moins l'une de ces signatures de constructeur.

Pour plus d'informations, consultez WorkflowRuntimeSection.

WorkflowRuntime(WorkflowRuntimeSection)

Initialise une nouvelle instance de la classe WorkflowRuntime en utilisant les paramètres de la WorkflowRuntimeSection spécifiée.

public:
 WorkflowRuntime(System::Workflow::Runtime::Configuration::WorkflowRuntimeSection ^ settings);

public WorkflowRuntime (System.Workflow.Runtime.Configuration.WorkflowRuntimeSection settings);

new System.Workflow.Runtime.WorkflowRuntime : System.Workflow.Runtime.Configuration.WorkflowRuntimeSection -> System.Workflow.Runtime.WorkflowRuntime

Public Sub New (settings As WorkflowRuntimeSection)

Paramètres

settings

WorkflowRuntimeSection

WorkflowRuntimeSection

Exceptions

ArgumentNullException

settings est une référence Null (Nothing en Visual Basic).

InvalidOperationException

Il existe déjà un WorkflowRuntime pour ce domaine d'application.

Remarques

Ce constructeur fournit un mécanisme pour configurer le moteur d'exécution de workflow à l'aide d'un appel de méthode unique pour les hôtes qui n'utilisent pas de fichier de configuration d'application. Il existe de nombreuses raisons pour lesquelles ne pas utiliser le fichier de configuration d'application. Un hôte peut s'exécuter dans un environnement qui n'autorise pas l'utilisation de fichiers de configuration ; par exemple, dans les environnements approuvés qui n'autorisent pas la lecture du fichier de configuration d'application pour des raisons de sécurité. De plus, un hôte peut utiliser un mécanisme de configuration privé ; par exemple, l'hôte peut stocker les paramètres de configuration du moteur d'exécution de workflow dans une base de données SQL.

Le moteur d'exécution de workflow charge et instancie les classes des types contenus dans la propriété WorkflowRuntimeSection.Services. Lorsque le moteur d'exécution de workflow construit ces classes, il recherche des constructeurs de classe avec les signatures suivantes dans l'ordre suivant :

1. Service(exécution WorkflowRuntime, paramètres NameValueCollection)

2. Service(exécution WorkflowRuntime)

3. Service(paramètres NameValueCollection)

4. Service()

Toutes les classes de service spécifiées dans settings doivent implémenter au moins l’une de ces signatures de constructeur.