WorkflowRuntime.CreateWorkflow メソッド

public:
 System::Workflow::Runtime::WorkflowInstance ^ CreateWorkflow(System::Xml::XmlReader ^ workflowDefinitionReader, System::Xml::XmlReader ^ rulesReader, System::Collections::Generic::Dictionary<System::String ^, System::Object ^> ^ namedArgumentValues, Guid instanceId);

public System.Workflow.Runtime.WorkflowInstance CreateWorkflow (System.Xml.XmlReader workflowDefinitionReader, System.Xml.XmlReader rulesReader, System.Collections.Generic.Dictionary<string,object> namedArgumentValues, Guid instanceId);

member this.CreateWorkflow : System.Xml.XmlReader * System.Xml.XmlReader * System.Collections.Generic.Dictionary<string, obj> * Guid -> System.Workflow.Runtime.WorkflowInstance

Public Function CreateWorkflow (workflowDefinitionReader As XmlReader, rulesReader As XmlReader, namedArgumentValues As Dictionary(Of String, Object), instanceId As Guid) As WorkflowInstance

パラメーター

戻り値

WorkflowInstance

作成されたワークフロー インスタンス。

例外

注釈

WorkflowInstance の作成前に、ワークフロー インスタンスの検証が実行されます。 検証エラーが発生した場合は、WorkflowValidationFailedException がスローされます。 これは単純なシナリオでは正しく動作しますが、サーバー環境では、ワークフローをアクティブにするたびにワークフローの再検証を実行すると、不要なオーバーヘッドが生じることがあります。

検証を無効にする方法の詳細については、次を参照してください ValidateOnCreate。

instanceId によって読み込まれた実行中のワークフローの WorkflowRuntime は、一意でなければなりません。 instanceId を渡してワークフローを作成し、実行中のワークフローでその instanceId が既に使用されている場合は、InvalidOperationException がスローされます。

パラメーターを渡す例については、「パラメーターを使用したCreateWorkflowワークフローのサンプル」を参照してください。

XML で定義されているルールの使用例については、「 IfElse with Rules Sample」を参照してください。

public:
 System::Workflow::Runtime::WorkflowInstance ^ CreateWorkflow(Type ^ workflowType, System::Collections::Generic::Dictionary<System::String ^, System::Object ^> ^ namedArgumentValues, Guid instanceId);

public System.Workflow.Runtime.WorkflowInstance CreateWorkflow (Type workflowType, System.Collections.Generic.Dictionary<string,object> namedArgumentValues, Guid instanceId);

member this.CreateWorkflow : Type * System.Collections.Generic.Dictionary<string, obj> * Guid -> System.Workflow.Runtime.WorkflowInstance

Public Function CreateWorkflow (workflowType As Type, namedArgumentValues As Dictionary(Of String, Object), instanceId As Guid) As WorkflowInstance

パラメーター

戻り値

WorkflowInstance

作成されたワークフロー インスタンス。

例外

注釈

WorkflowInstance の作成前に、ワークフロー インスタンスの検証が実行されます。 検証エラーが発生した場合は、WorkflowValidationFailedException がスローされます。 これは単純なシナリオでは正しく動作しますが、サーバー環境では、ワークフローをアクティブにするたびにワークフローの再検証を実行すると、不要なオーバーヘッドが生じることがあります。

検証を無効にする方法の詳細については、次を参照してください ValidateOnCreate。

instanceId によって読み込まれた実行中のワークフローの WorkflowRuntime は、一意でなければなりません。 instanceId を渡してワークフローを作成し、実行中のワークフローでその instanceId が既に使用されている場合は、InvalidOperationException がスローされます。

パラメーターを渡す例については、「パラメーターを使用したCreateWorkflowワークフローのサンプル」を参照してください。

public:
 System::Workflow::Runtime::WorkflowInstance ^ CreateWorkflow(System::Xml::XmlReader ^ workflowDefinitionReader, System::Xml::XmlReader ^ rulesReader, System::Collections::Generic::Dictionary<System::String ^, System::Object ^> ^ namedArgumentValues);

public System.Workflow.Runtime.WorkflowInstance CreateWorkflow (System.Xml.XmlReader workflowDefinitionReader, System.Xml.XmlReader rulesReader, System.Collections.Generic.Dictionary<string,object> namedArgumentValues);

member this.CreateWorkflow : System.Xml.XmlReader * System.Xml.XmlReader * System.Collections.Generic.Dictionary<string, obj> -> System.Workflow.Runtime.WorkflowInstance

Public Function CreateWorkflow (workflowDefinitionReader As XmlReader, rulesReader As XmlReader, namedArgumentValues As Dictionary(Of String, Object)) As WorkflowInstance

パラメーター

戻り値

WorkflowInstance

作成されたワークフロー インスタンス。

例外

注釈

XmlReader によって参照されるワークフロー定義と、namedArgumentValues によって提供される引数から、ワークフロー インスタンスが作成されます。

WorkflowInstance の作成前に、ワークフロー インスタンスの検証が実行されます。 検証エラーが発生した場合は、WorkflowValidationFailedException がスローされます。 これは単純なシナリオでは正しく動作しますが、サーバー環境では、ワークフローをアクティブにするたびにワークフローの再検証を実行すると、不要なオーバーヘッドが生じることがあります。

検証を無効にする方法の詳細については、次を参照してください ValidateOnCreate。

パラメーターを渡す例については、「パラメーターを使用したCreateWorkflowワークフローのサンプル」を参照してください。

XML で定義されているルールの使用例については、「 IfElse with Rules Sample」を参照してください。

public:
 System::Workflow::Runtime::WorkflowInstance ^ CreateWorkflow(System::Xml::XmlReader ^ workflowDefinitionReader);

public System.Workflow.Runtime.WorkflowInstance CreateWorkflow (System.Xml.XmlReader workflowDefinitionReader);

member this.CreateWorkflow : System.Xml.XmlReader -> System.Workflow.Runtime.WorkflowInstance

Public Function CreateWorkflow (workflowDefinitionReader As XmlReader) As WorkflowInstance

パラメーター

戻り値

WorkflowInstance

作成されたワークフロー インスタンス。

例外

例

XAML ベースのワークフロー定義を指定してワークフローを作成する方法を次の例に示します。

static void Main(string[] args)  
{  
    using (WorkflowRuntime workflowRuntime = new WorkflowRuntime())  
    {  
        AutoResetEvent waitHandle = new AutoResetEvent(false);  
        workflowRuntime.WorkflowCompleted += delegate(object sender, WorkflowCompletedEventArgs e)  
        {  
            waitHandle.Set();  
        };  
        workflowRuntime.WorkflowTerminated += delegate(object sender, WorkflowTerminatedEventArgs e)  
        {  
            Console.WriteLine(e.Exception.Message);  
            waitHandle.Set();  
        };  

        TypeProvider typeProvider = new TypeProvider(null);  
        // Add referenced assemblies, if needed  
        // typeProvider.AddAssembly(...);  
        workflowRuntime.AddService(typeProvider);  

        using (XmlReader reader = XmlReader.Create("Workflow1.xoml"))  
        {  
            WorkflowInstance instance = workflowRuntime.CreateWorkflow(reader);  
            instance.Start();  
        }  

        waitHandle.WaitOne();  
    }  
}  

注釈

XmlReader によって参照される XAML ワークフロー定義ファイルからワークフロー インスタンスが作成されます。

WorkflowInstance の作成前に、ワークフロー インスタンスの検証が実行されます。 検証エラーが発生した場合は、WorkflowValidationFailedException がスローされます。 これは単純なシナリオでは正しく動作しますが、サーバー環境では、ワークフローをアクティブにするたびにワークフローの再検証を実行すると、不要なオーバーヘッドが生じることがあります。

検証を無効にする方法の詳細については、次を参照してください ValidateOnCreate。

public:
 System::Workflow::Runtime::WorkflowInstance ^ CreateWorkflow(Type ^ workflowType);

public System.Workflow.Runtime.WorkflowInstance CreateWorkflow (Type workflowType);

member this.CreateWorkflow : Type -> System.Workflow.Runtime.WorkflowInstance

Public Function CreateWorkflow (workflowType As Type) As WorkflowInstance

パラメーター

戻り値

WorkflowInstance

作成されたワークフロー インスタンス。

例外

例

次のコード例は、ワークフロー ホストで WorkflowInstance メソッドを使用して CreateWorkflow オブジェクトを作成するための推奨方法を示しています。

このコード例は、ワークフローの 取り消しサンプルの 一部です。

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

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

注釈

WorkflowInstance の作成前に、ワークフロー インスタンスの検証が実行されます。 検証エラーが発生した場合は、WorkflowValidationFailedException がスローされます。 これは単純なシナリオでは正しく動作しますが、サーバー環境では、ワークフローをアクティブにするたびにワークフローの再検証を実行すると、不要なオーバーヘッドが生じることがあります。

検証を無効にする方法の詳細については、次を参照してください ValidateOnCreate。

public:
 System::Workflow::Runtime::WorkflowInstance ^ CreateWorkflow(Type ^ workflowType, System::Collections::Generic::Dictionary<System::String ^, System::Object ^> ^ namedArgumentValues);

public System.Workflow.Runtime.WorkflowInstance CreateWorkflow (Type workflowType, System.Collections.Generic.Dictionary<string,object> namedArgumentValues);

member this.CreateWorkflow : Type * System.Collections.Generic.Dictionary<string, obj> -> System.Workflow.Runtime.WorkflowInstance

Public Function CreateWorkflow (workflowType As Type, namedArgumentValues As Dictionary(Of String, Object)) As WorkflowInstance

パラメーター

戻り値

WorkflowInstance

作成されたワークフロー インスタンス。

例外

注釈

WorkflowInstance の作成前に、ワークフロー インスタンスの検証が実行されます。 検証エラーが発生した場合は、WorkflowValidationFailedException がスローされます。 これは単純なシナリオでは正しく動作しますが、サーバー環境では、ワークフローをアクティブにするたびにワークフローの再検証を実行すると、不要なオーバーヘッドが生じることがあります。

検証を無効にする方法の詳細については、次を参照してください ValidateOnCreate。

パラメーターを渡す例については、「パラメーターを使用したCreateWorkflowワークフローのサンプル」を参照してください。