WorkflowRuntime WorkflowRuntime WorkflowRuntime WorkflowRuntime Class

Definition

Warnung

Diese API ist jetzt veraltet.

Stellt die konfigurierbare Ausführungsumgebung dar, die die Workflowruntime-Engine für Workflows bereitstellt.Represents the configurable execution environment provided by the workflow run-time engine for workflows.

public ref class WorkflowRuntime : IDisposable, IServiceProvider
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class WorkflowRuntime : IDisposable, IServiceProvider
type WorkflowRuntime = class
    interface IServiceProvider
    interface IDisposable
Public Class WorkflowRuntime
Implements IDisposable, IServiceProvider
Vererbung
WorkflowRuntimeWorkflowRuntimeWorkflowRuntimeWorkflowRuntime
Attribute
Implementiert

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die WorkflowRuntime-Funktionalität eines Workflowhosts verwenden können.The following code example demonstrates how to use WorkflowRuntime functionality from a workflow host. Es enthält Beispiele dafür, wie der WorkflowRuntime-Konstruktor und die Methoden AddService, StartRuntime und StopRuntime verwendet werden.It provides examples of how to use the WorkflowRuntime constructor and the AddService, StartRuntime, and StopRuntime methods. Der Code zeigt außerdem die empfohlene Methode zum Erstellen eines WorkflowInstance-Objekts in einem Workflowhost mithilfe der CreateWorkflow-Methode.The code also shows the recommended way to create a WorkflowInstance object in a workflow host using the CreateWorkflow method. Der Code zeigt außerdem, wie Sie Ereignishandler für die Ereignisse WorkflowCompleted, WorkflowIdled und WorkflowTerminated festlegen.It also shows how to set event handlers for the WorkflowCompleted, WorkflowIdled, and WorkflowTerminated 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

Hinweis

In diesem Material werden veraltete Typen und Namespaces erläutert.This material discusses types and namespaces that are obsolete. Weitere Informationen finden Sie unter Veraltete Typen in Windows Workflow Foundation 4.5.For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

WorkflowRuntime legt die Funktionalität offen, die für eine Hostanwendung und Dienste erforderlich ist, um die Workflowruntime-Engine zu konfigurieren und zu steuern und um über Änderungen an der Workflowruntime-Engine und ihrer Workflowinstanzen benachrichtigt zu werden.WorkflowRuntime exposes functionality required by a host application and services to configure and control the workflow run-time engine and to be notified of changes to both the workflow run-time engine and any of its workflow instances.

Konstruktoren

WorkflowRuntime() 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.

Eigenschaften

IsStarted IsStarted IsStarted IsStarted

Ruft einen Wert ab, der angibt, ob die Workflowruntime-Engine gestartet wurde.Gets a value that indicates whether the workflow run-time engine has been started.

Name Name Name Name

Ruft den Namen ab bzw. legt den Namen fest, der WorkflowRuntime zugeordnet ist.Gets or sets the name associated with the WorkflowRuntime.

Methoden

AddService(Object) AddService(Object) AddService(Object) AddService(Object)

Fügt den angegebenen Dienst der Workflowruntime-Engine hinzu.Adds the specified service to the workflow run-time engine.

CreateWorkflow(Type) CreateWorkflow(Type) CreateWorkflow(Type) CreateWorkflow(Type)

Erstellt mit dem Type des angegebenen Workflows eine neue Workflowinstanz.Creates a new workflow instance by using the specified workflow Type.

CreateWorkflow(Type, Dictionary<String,Object>) CreateWorkflow(Type, Dictionary<String,Object>) CreateWorkflow(Type, Dictionary<String,Object>) CreateWorkflow(Type, Dictionary<String,Object>)

Erstellt eine Workflowinstanz, indem der angegebene Type des Workflows und seine Argumente verwendet werden, die im angegebenen Dictionary<TKey,TValue> enthalten sind.Creates a workflow instance by using the specified workflow Type and the arguments to the workflow contained in the specified Dictionary<TKey,TValue>.

CreateWorkflow(Type, Dictionary<String,Object>, Guid) CreateWorkflow(Type, Dictionary<String,Object>, Guid) CreateWorkflow(Type, Dictionary<String,Object>, Guid) CreateWorkflow(Type, Dictionary<String,Object>, Guid)

Erstellt durch das Verwenden der angegebenen Parameter eine Workflowinstanz.Creates a workflow instance by using the specified parameters.

CreateWorkflow(XmlReader) CreateWorkflow(XmlReader) CreateWorkflow(XmlReader) CreateWorkflow(XmlReader)

Erstellt mit dem angegebenen XmlReader eine Workflowinstanz.Creates a workflow instance by using the specified XmlReader.

CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>) CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>) CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>) CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>)

Erstellt eine Workflowinstanz, indem die angegebenen XmlReader-Objekte und die Argumente verwendet werden, die im angegebenen Dictionary<TKey,TValue> enthalten sind.Creates a workflow instance by using the specified XmlReader objects and the arguments contained in the specified Dictionary<TKey,TValue>.

CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>, Guid) CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>, Guid) CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>, Guid) CreateWorkflow(XmlReader, XmlReader, Dictionary<String,Object>, Guid)

Erstellt durch das Verwenden der angegebenen Parameter eine Workflowinstanz.Creates a workflow instance by using the specified parameters.

Dispose() Dispose() Dispose() Dispose()

Gibt die von der WorkflowRuntime verwendeten Ressourcen frei.Releases the resources used by the WorkflowRuntime.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAllServices(Type) GetAllServices(Type) GetAllServices(Type) GetAllServices(Type)

Ruft alle Dienste ab, die der Workflowruntime-Engine hinzugefügt wurden und über den angegebenen Type implementiert bzw. abgeleitet wurden.Retrieves all the services that are added to the workflow run-time engine that implement or derive from the specified Type.

GetAllServices<T>() GetAllServices<T>() GetAllServices<T>() GetAllServices<T>()

Ruft alle Dienste ab, die der Workflowruntime-Engine hinzugefügt werden und über den angegebenen generischen Typ implementiert bzw. abgeleitet werden.Retrieves all the services that are added to the workflow run-time engine that implement or derive from the specified generic type.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLoadedWorkflows() GetLoadedWorkflows() GetLoadedWorkflows() GetLoadedWorkflows()

Ruft eine Auflistung ab, die alle Workflowinstanzen enthält, die momentan im Arbeitsspeicher geladen sind.Gets a collection that contains all the workflow instances currently loaded in memory.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Ruft einen Dienst vom angegebenen Type aus der Workflowruntime-Engine ab.Retrieves a service of the specified Type from the workflow run-time engine.

GetService<T>() GetService<T>() GetService<T>() GetService<T>()

Ruft einen Dienst des angegebenen generischen Typs aus der Workflowruntime-Engine ab.Retrieves a service of the specified generic type from the workflow run-time engine.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
GetWorkflow(Guid) GetWorkflow(Guid) GetWorkflow(Guid) GetWorkflow(Guid)

Ruft die Workflowinstanz ab, die über die angegebene Guid verfügt.Retrieves the workflow instance that has the specified Guid.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveService(Object) RemoveService(Object) RemoveService(Object) RemoveService(Object)

Entfernt den angegebenen Dienst aus der Workflowruntime-Engine.Removes the specified service from the workflow run-time engine.

StartRuntime() StartRuntime() StartRuntime() StartRuntime()

Startet die Workflowruntime-Engine und die Workflowruntime-Engine-Dienste.Starts the workflow run-time engine and the workflow run-time engine services.

StopRuntime() StopRuntime() StopRuntime() StopRuntime()

Stoppt die Workflowruntime-Engine und die Laufzeitdienste.Stops the workflow run-time engine and the run-time services.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

ServicesExceptionNotHandled ServicesExceptionNotHandled ServicesExceptionNotHandled ServicesExceptionNotHandled

Tritt ein, wenn ein Dienst, der von der WorkflowRuntimeService-Klasse abgeleitet wird, RaiseServicesExceptionNotHandledEvent(Exception, Guid) aufruft.Occurs when a service that is derived from the WorkflowRuntimeService class calls RaiseServicesExceptionNotHandledEvent(Exception, Guid).

Started Started Started Started

Tritt ein, wenn die Workflowruntime-Engine gestartet wird.Occurs when the workflow run-time engine is started.

Stopped Stopped Stopped Stopped

Tritt ein, wenn die Workflowruntime-Engine gestoppt wird.Occurs when the workflow run-time engine is stopped.

WorkflowAborted WorkflowAborted WorkflowAborted WorkflowAborted

Tritt auf, wenn eine Workflowinstanz abgebrochen wird.Occurs when a workflow instance is aborted.

WorkflowCompleted WorkflowCompleted WorkflowCompleted WorkflowCompleted

Tritt auf, wenn eine Workflowinstanz abgeschlossen wurde.Occurs when a workflow instance has completed.

WorkflowCreated WorkflowCreated WorkflowCreated WorkflowCreated

Tritt auf, wenn eine Workflowinstanz erstellt wird.Occurs when a workflow instance is created.

WorkflowIdled WorkflowIdled WorkflowIdled WorkflowIdled

Tritt auf, wenn eine Workflowinstanz in den Leerlaufzustand wechselt.Occurs when a workflow instance enters the idle state.

WorkflowLoaded WorkflowLoaded WorkflowLoaded WorkflowLoaded

Tritt ein, wenn die Workflowinstanz in den Arbeitsspeicher geladen wird.Occurs when the workflow instance is loaded into memory.

WorkflowPersisted WorkflowPersisted WorkflowPersisted WorkflowPersisted

Tritt auf, wenn der Zustand einer Workflowinstanz beibehalten wird.Occurs when the state of a workflow instance is persisted.

WorkflowResumed WorkflowResumed WorkflowResumed WorkflowResumed

Tritt auf, wenn die Ausführung einer Workflowinstanz nach einer Unterbrechung fortgesetzt wird.Occurs when execution of a workflow instance is resumed following a suspension.

WorkflowStarted WorkflowStarted WorkflowStarted WorkflowStarted

Tritt ein, wenn eine Workflowinstanz gestartet wurde.Occurs when a workflow instance has been started.

WorkflowSuspended WorkflowSuspended WorkflowSuspended WorkflowSuspended

Tritt auf, wenn eine Workflowinstanz unterbrochen wird.Occurs when a workflow instance is suspended.

WorkflowTerminated WorkflowTerminated WorkflowTerminated WorkflowTerminated

Tritt auf, wenn eine Workflowinstanz beendet wird.Occurs when a workflow instance is terminated.

WorkflowUnloaded WorkflowUnloaded WorkflowUnloaded WorkflowUnloaded

Tritt ein, wenn die Workflowinstanz aus dem Arbeitsspeicher entladen wird.Occurs when the workflow instance is unloaded from memory.

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.This type is thread safe.