WorkflowRuntime Класс

Определение

Внимание!

The System.Workflow.* types are deprecated. Instead, please use the new types from System.Activities.*

Представляет настраиваемую среду выполнения, обеспечиваемую механизмом среды выполнения рабочих процессов.Represents the configurable execution environment provided by the workflow run-time engine for workflows.

public ref class WorkflowRuntime : IDisposable, IServiceProvider
public 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
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type WorkflowRuntime = class
    interface IServiceProvider
    interface IDisposable
Public Class WorkflowRuntime
Implements IDisposable, IServiceProvider
Наследование
WorkflowRuntime
Атрибуты
Реализации

Примеры

В следующем примере кода показано использование функций класса WorkflowRuntime с узла рабочего процесса.The following code example demonstrates how to use WorkflowRuntime functionality from a workflow host. Он содержит примеры использования конструктора WorkflowRuntime и методов AddService, StartRuntime и StopRuntime.It provides examples of how to use the WorkflowRuntime constructor and the AddService, StartRuntime, and StopRuntime methods. Код также демонстрирует метод, рекомендуемый для создания объекта WorkflowInstance в узле рабочего процесса с помощью метода CreateWorkflow.The code also shows the recommended way to create a WorkflowInstance object in a workflow host using the CreateWorkflow method. В нем также показано задание обработчиков для событий WorkflowCompleted, WorkflowIdled и WorkflowTerminated.It also shows how to set event handlers for the WorkflowCompleted, WorkflowIdled, and WorkflowTerminated events.

Этот пример кода является частью примера отмены рабочего процесса .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

Комментарии

Примечание

В этом материале обсуждаются устаревшие типы и пространства имен.This material discusses types and namespaces that are obsolete. Дополнительные сведения см. в статье о нерекомендуемых типах в Windows Workflow Foundation 4.5.For more information, see Deprecated Types in Windows Workflow Foundation 4.5.

Класс WorkflowRuntime предоставляет функции, которые требуются ведущему приложению и службам для настройки и управления механизмом среды выполнения рабочих процессов и для получения уведомлений об изменениях механизма среды выполнения рабочих процессов и всех экземпляров его рабочих процессов.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.

Конструкторы

WorkflowRuntime()

Инициализирует новый экземпляр класса WorkflowRuntime.Initializes a new instance of the WorkflowRuntime class.

WorkflowRuntime(String)

Инициализирует новый экземпляр класса WorkflowRuntime, используя указанный раздел файла конфигурации приложения.Initializes a new instance of the WorkflowRuntime class by using the specified section of the application configuration file.

WorkflowRuntime(WorkflowRuntimeSection)

Инициализирует новый экземпляр класса WorkflowRuntime, используя настройки в указанном разделе WorkflowRuntimeSection.Initializes a new instance of the WorkflowRuntime class by using the settings in the specified WorkflowRuntimeSection.

Свойства

IsStarted

Возвращает значение, показывающее, был ли запущен механизм среды выполнения рабочих процессов.Gets a value that indicates whether the workflow run-time engine has been started.

Name

Возвращает или задает имя, связанное с объектом WorkflowRuntime.Gets or sets the name associated with the WorkflowRuntime.

Методы

AddService(Object)

Добавляет указанную службу к механизму среды выполнения рабочих процессов.Adds the specified service to the workflow run-time engine.

CreateWorkflow(Type)

Создает новый экземпляр рабочего процесса, используя заданный тип рабочего процесса Type.Creates a new workflow instance by using the specified workflow Type.

CreateWorkflow(Type, Dictionary<String,Object>)

Создает экземпляр рабочего процесса, используя указанный тип рабочего процесса Type и аргументы рабочего процесса, содержащиеся в указанной коллекции Dictionary<TKey,TValue>.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)

Создает экземпляр рабочего процесса, используя указанные параметры.Creates a workflow instance by using the specified parameters.

CreateWorkflow(XmlReader)

Создает экземпляр рабочего процесса, используя заданный объект XmlReader.Creates a workflow instance by using the specified XmlReader.

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

Создает экземпляр рабочего процесса, используя указанные объекты XmlReader и аргументы, содержащиеся в указанной коллекции Dictionary<TKey,TValue>.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)

Создает экземпляр рабочего процесса, используя указанные параметры.Creates a workflow instance by using the specified parameters.

Dispose()

Освобождает ресурсы, используемые объектом WorkflowRuntime.Releases the resources used by the WorkflowRuntime.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetAllServices(Type)

Извлекает все службы, добавленные к механизму среды выполнения рабочих процессов, которые реализуют или являются производными от указанного типа Type.Retrieves all the services that are added to the workflow run-time engine that implement or derive from the specified Type.

GetAllServices<T>()

Извлекает все службы, добавленные к механизму среды выполнения рабочих процессов, которые реализуют или являются производными от указанного универсального типа.Retrieves all the services that are added to the workflow run-time engine that implement or derive from the specified generic type.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLoadedWorkflows()

Возвращает коллекцию, содержащую экземпляры рабочего процесса, загруженные в память.Gets a collection that contains all the workflow instances currently loaded in memory.

GetService(Type)

Извлекает из механизма среды выполнения рабочих процессов службу указанного типа Type.Retrieves a service of the specified Type from the workflow run-time engine.

GetService<T>()

Извлекает из механизма среды выполнения рабочих процессов службу указанного универсального типа.Retrieves a service of the specified generic type from the workflow run-time engine.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetWorkflow(Guid)

Извлекает экземпляр рабочего процесса, который имеет указанный тип Guid.Retrieves the workflow instance that has the specified Guid.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
RemoveService(Object)

Удаляет указанную службу из механизма среды выполнения рабочих процессов.Removes the specified service from the workflow run-time engine.

StartRuntime()

Запускает механизм среды выполнения рабочих процессов и его службы.Starts the workflow run-time engine and the workflow run-time engine services.

StopRuntime()

Останавливает механизм среды выполнения рабочих процессов и ее службы.Stops the workflow run-time engine and the run-time services.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

ServicesExceptionNotHandled

Происходит, когда служба, производная от класса WorkflowRuntimeService, вызывает метод RaiseServicesExceptionNotHandledEvent(Exception, Guid).Occurs when a service that is derived from the WorkflowRuntimeService class calls RaiseServicesExceptionNotHandledEvent(Exception, Guid).

Started

Возникает при запуске механизма среды выполнения рабочих процессов.Occurs when the workflow run-time engine is started.

Stopped

Возникает при остановке механизма среды выполнения рабочих процессов.Occurs when the workflow run-time engine is stopped.

WorkflowAborted

Происходит при прерывании выполнения экземпляра рабочего процесса.Occurs when a workflow instance is aborted.

WorkflowCompleted

Происходит при успешном завершении выполнения экземпляра рабочего процесса.Occurs when a workflow instance has completed.

WorkflowCreated

Происходит при создании экземпляра рабочего процесса.Occurs when a workflow instance is created.

WorkflowIdled

Происходит при переходе экземпляра рабочего процесса в состояние бездействия.Occurs when a workflow instance enters the idle state.

WorkflowLoaded

Происходит при загрузке экземпляра рабочего процесса в память.Occurs when the workflow instance is loaded into memory.

WorkflowPersisted

Происходит при сохранении состояния экземпляра рабочего процесса.Occurs when the state of a workflow instance is persisted.

WorkflowResumed

Происходит, когда выполнение экземпляра рабочего процесса возобновляется после приостановки.Occurs when execution of a workflow instance is resumed following a suspension.

WorkflowStarted

Происходит при запуске экземпляра рабочего процесса.Occurs when a workflow instance has been started.

WorkflowSuspended

Происходит при приостановке выполнения экземпляра рабочего процесса.Occurs when a workflow instance is suspended.

WorkflowTerminated

Происходит при завершении выполнения экземпляра рабочего процесса.Occurs when a workflow instance is terminated.

WorkflowUnloaded

Происходит при выгрузке экземпляра рабочего процесса из памяти.Occurs when the workflow instance is unloaded from memory.

Применяется к

Потокобезопасность

Данный тип потокобезопасен.This type is thread safe.