WorkflowRuntime WorkflowRuntime WorkflowRuntime WorkflowRuntime Constructors

Definition

Überlädt

WorkflowRuntime() WorkflowRuntime() WorkflowRuntime()

Initialisiert eine neue Instanz der WorkflowRuntime-Klasse.Initializes a new instance of the WorkflowRuntime class.

WorkflowRuntime(String) WorkflowRuntime(String) WorkflowRuntime(String) WorkflowRuntime(String)

Initialisiert eine neue Instanz der WorkflowRuntime-Klasse, indem der angegebene Abschnitt der Anwendungskonfigurationsdatei verwendet wird.Initializes a new instance of the WorkflowRuntime class by using the specified section of the application configuration file.

WorkflowRuntime(WorkflowRuntimeSection) WorkflowRuntime(WorkflowRuntimeSection) WorkflowRuntime(WorkflowRuntimeSection) WorkflowRuntime(WorkflowRuntimeSection)

Initialisiert eine neue Instanz der WorkflowRuntime-Klasse mithilfe der Einstellungen im angegebenen WorkflowRuntimeSection.Initializes a new instance of the WorkflowRuntime class by using the settings in the specified WorkflowRuntimeSection.

WorkflowRuntime() WorkflowRuntime() WorkflowRuntime()

Initialisiert eine neue Instanz der WorkflowRuntime-Klasse.Initializes a new instance of the WorkflowRuntime class.

public:
 WorkflowRuntime();
public WorkflowRuntime ();
Public Sub New ()

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die WorkflowRuntime-Funktionalität eines Workflowhosts verwenden können.The following code example demonstrates how you can use WorkflowRuntime functionality from a workflow host. Es enthält ein Beispiel dafür, wie Sie den WorkflowRuntime-Konstruktor verwenden, um eine WorkflowRuntime-Instanz zu erstellen und auf die dazugehörigen Methoden und Ereignisse zuzugreifen.It provides an example of how to use the WorkflowRuntime constructor to create an instance of a WorkflowRuntime and access its methods and events.

Dieses Codebeispiel ist Teil des Beispiels für das Abbrechen eines Workflows .This code example is part of the Canceling a Workflow sample.

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

Hinweise

WorkflowRuntime wird mit den Standardeigenschaftswerten initialisiert und enthält die Standardbasisdienste.The WorkflowRuntime is initialized with the default property values and contains the default core services. Um zusätzlich die Workflowruntime-Engine zu konfigurieren, können Sie Dienste hinzufügen bzw. entfernen, indem Sie AddService und RemoveService verwenden, und Sie können Name festlegen.To additionally configure the workflow run-time engine, you can add and remove services by using AddService and RemoveService, and you can set Name. Nachdem WorkflowRuntime konfiguriert wurde, rufen Sie StartRuntime auf, um die Workflowruntime-Engine und ihre Dienste zu starten.After the WorkflowRuntime is configured, call StartRuntime to start the workflow run-time engine and its services.

In der folgenden Tabelle werden die anfänglichen Eigenschaftswerte für eine Instanz der WorkflowRuntime-Klasse angezeigt.The following table shows initial property values for an instance of WorkflowRuntime class.

EigenschaftProperty AnfangswertInitial Value
Name WorkflowRuntime"WorkflowRuntime"
IsStarted false

Die Standardbasisdienste lauten DefaultWorkflowCommitWorkBatchService und DefaultWorkflowSchedulerService.The default core services are DefaultWorkflowCommitWorkBatchService and DefaultWorkflowSchedulerService.

WorkflowRuntime(String) WorkflowRuntime(String) WorkflowRuntime(String) WorkflowRuntime(String)

Initialisiert eine neue Instanz der WorkflowRuntime-Klasse, indem der angegebene Abschnitt der Anwendungskonfigurationsdatei verwendet wird.Initializes a new instance of the WorkflowRuntime class by using the specified section of the application configuration file.

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)

Parameter

configSectionName
String String String String

Der Name eines gültigen workflowSettings-Abschnitts in der Anwendungskonfigurationsdatei.The name of a valid workflowSettings section in the application configuration file.

Ausnahmen

configSectionName ist ein NULL-Verweis (Nothing in Visual Basic).configSectionName is a null reference (Nothing in Visual Basic).

In der Anwendungskonfigurationsdatei konnte kein gültiger workflowSettings-Abschnitt gefunden werden.A valid workflowSettings section could not be found in the application configuration file.

Für diese Anwendungsdomäne ist bereits ein WorkflowRuntime-Element vorhanden.A WorkflowRuntime already exists for this application domain.

Hinweise

WorkflowRuntime wird basierend auf den Einstellungen in dem Abschnitt initialisiert, der in der Anwendungskonfigurationsdatei mithilfe von configSectionName angegeben ist.The WorkflowRuntime is initialized according to the settings in the section specified by configSectionName in the application configuration file. configSectionNamemuss einem gültigen workflowSettings Abschnitt einer Konfigurationsdatei entsprechen.configSectionName must correspond to a valid workflowSettings section of a configuration file.

Wenn das Workflow Lauf Zeit Modul mithilfe einer Anwendungs Konfigurationsdatei konfiguriert wird, lädt und instanziiert es Klassen der Typen, die im Services -Abschnitt der Konfigurationsdatei aufgelistet sind.When the workflow run-time engine is configured by using an application configuration file, it loads and instantiates classes of the types listed in the Services section of the configuration file. Wenn die Workflowruntime-Engine diese Klassen erstellt, sucht sie nach Klassenkonstruktoren mit den folgenden Signaturen in der folgenden Reihenfolge:When the workflow run-time engine constructs these classes it looks for class constructors with the following signatures in the following order:

  1. Dienst(WorkflowRuntime-Laufzeit, NameValueCollection-Parameter)Service(WorkflowRuntime runtime, NameValueCollection parameters)

  2. Dienst(WorkflowRuntime-Laufzeit)Service(WorkflowRuntime runtime)

  3. Dienst(NameValueCollection-Parameter)Service(NameValueCollection parameters)

  4. Dienst()Service()

Alle Dienstklassen, die aus einer Konfigurationsdatei geladen werden, müssen mindestens eine dieser Konstruktorsignaturen implementieren.All service classes that are loaded from a configuration file must implement at least one of these constructor signatures.

Weitere Informationen finden Sie unter WorkflowRuntimeSection.For more information, see WorkflowRuntimeSection.

WorkflowRuntime(WorkflowRuntimeSection) WorkflowRuntime(WorkflowRuntimeSection) WorkflowRuntime(WorkflowRuntimeSection) WorkflowRuntime(WorkflowRuntimeSection)

Initialisiert eine neue Instanz der WorkflowRuntime-Klasse mithilfe der Einstellungen im angegebenen WorkflowRuntimeSection.Initializes a new instance of the WorkflowRuntime class by using the settings in the specified WorkflowRuntimeSection.

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)

Parameter

Ausnahmen

settings ist ein NULL-Verweis (Nothing in Visual Basic).settings is a null reference (Nothing in Visual Basic).

Für diese Anwendungsdomäne ist bereits ein WorkflowRuntime-Element vorhanden.A WorkflowRuntime already exists for this application domain.

Hinweise

Dieser Konstruktor stellt einen Mechanismus zum Konfigurieren der Workflowruntime-Engine bereit. Dabei wird ein einzelner Methodenaufruf für Hosts verwendet, die keine Anwendungskonfigurationsdatei verwenden.This constructor provides a mechanism to configure the workflow run-time engine using a single method call for hosts that do not use an application configuration file. Es kann viele Gründe dafür geben, die Anwendungskonfigurationsdatei nicht zu verwenden.There are many reasons for not using the application configuration file. Ein Host kann beispielsweise in einer Umgebung ausgeführt werden, in der die Verwendung von Konfigurationsdateien nicht zulässig ist. Dies kann in vertrauenswürdigen Umgebungen der Fall sein, die aus Sicherheitsgründen das Lesen aus der Anwendungskonfigurationsdatei nicht zulassen.A host can run in an environment that does not allow using configuration files; for example, in trusted environments that do not allow reading from the application configuration file for security reasons. Zudem kann ein Host ein eigenes Konfigurationsverfahren verwenden. Hosts können die Konfigurationseinstellungen der Workflowruntime-Engine beispielsweise in einer SQL-Datenbank speichern.Also, a host can use a proprietary configuration mechanism; for example, the host can store the workflow run-time engine configuration settings in a SQL database.

Die Workflowruntime-Engine lädt und instanziiert Klassen der Typen, die in WorkflowRuntimeSection.Services enthalten sind.The workflow run-time engine loads and instantiates classes of the types contained in WorkflowRuntimeSection.Services. Wenn die Workflowruntime-Engine diese Klassen erstellt, sucht sie nach Klassenkonstruktoren mit den folgenden Signaturen in der folgenden Reihenfolge:When the workflow run-time engine constructs these classes it looks for class constructors with the following signatures in the following order:

  1. Dienst(WorkflowRuntime-Laufzeit, NameValueCollection-Parameter)Service(WorkflowRuntime runtime, NameValueCollection parameters)

  2. Dienst(WorkflowRuntime-Laufzeit)Service(WorkflowRuntime runtime)

  3. Dienst(NameValueCollection-Parameter)Service(NameValueCollection parameters)

  4. Dienst()Service()

Alle Dienstklassen, die unter settings angegeben werden, müssen mindestens eine dieser Konstruktorsignaturen implementieren.All service classes that are specified in settings must implement at least one of these constructor signatures.

Gilt für: