WorkflowQueuingService.CreateWorkflowQueue Method (IComparable, Boolean)

 

Creates a WorkflowQueue by using the specified name and transactional scope.

Namespace:   System.Workflow.Runtime
Assembly:  System.Workflow.Runtime (in System.Workflow.Runtime.dll)

public WorkflowQueue CreateWorkflowQueue(
	IComparable queueName,
	bool transactional
)

Parameters

queueName
Type: System.IComparable

The name of the queue.

transactional
Type: System.Boolean

A value that specifies whether the WorkflowQueue is visible outside the scope of the current transaction.

Exception Condition
ArgumentNullException

queueName is a null reference (Nothing in Visual Basic).

InvalidOperationException

A WorkflowQueue with the name specified by queueName already exists.

A WorkflowQueue is created with the specified queueName. If transactional is true, the WorkflowQueue is only visible inside the current transaction.

The following code example demonstrates a method, named CreateQueue, that initializes a WorkflowQueuingService object by calling the ActivityExecutionContext.GetService<T> method. The code then uses the Exists method to determine if a WorkflowQueue with a specified name exists. If it does not exist, the code calls the CreateWorkflowQueue method; if it does the code calls the GetWorkflowQueue method.

This code example is part of the File Watcher Activity SDK Sample from the FileSystemEvent.cs file. For more information, see File System Watcher Activity.

private WorkflowQueue CreateQueue(ActivityExecutionContext context)
{
    Console.WriteLine("CreateQueue");
    WorkflowQueuingService qService = context.GetService<WorkflowQueuingService>();

    if (!qService.Exists(this.QueueName))
    {
        qService.CreateWorkflowQueue(this.QueueName, true);
    }

    return qService.GetWorkflowQueue(this.QueueName);
}

.NET Framework
Available since 3.0
Return to top
Show: