WorkflowRuntime Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
S’applique à
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.WorkflowRuntimePublic Sub New (configSectionName As String)Paramètres
- configSectionName
- String
Nom d'une section workflowSettings valide dans le fichier de configuration de l'application.
Exceptions
configSectionName est une référence Null (Nothing en Visual Basic).
Une section workflowSettings valide n'a pas pu être trouvée dans le fichier de configuration de l'application.
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 :
Service(exécution WorkflowRuntime, paramètres NameValueCollection)
Service(exécution WorkflowRuntime)
Service(paramètres NameValueCollection)
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.
S’applique à
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.WorkflowRuntimePublic Sub New (settings As WorkflowRuntimeSection)Paramètres
Exceptions
settings est une référence Null (Nothing en Visual Basic).
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 :
Service(exécution WorkflowRuntime, paramètres NameValueCollection)
Service(exécution WorkflowRuntime)
Service(paramètres NameValueCollection)
Service()
Toutes les classes de service spécifiées dans settings doivent implémenter au moins l’une de ces signatures de constructeur.