WorkflowQueue Klasse

Definition

Achtung

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

Stellt eine Workflowwarteschlange dar.Represents a workflow queue.

public ref class WorkflowQueue
public class WorkflowQueue
[System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")]
public class WorkflowQueue
type WorkflowQueue = class
[<System.Obsolete("The System.Workflow.* types are deprecated.  Instead, please use the new types from System.Activities.*")>]
type WorkflowQueue = class
Public Class WorkflowQueue
Vererbung
WorkflowQueue
Attribute

Beispiele

Das folgende Codebeispiel zeigt, wie Sie eine WorkflowQueue erstellen können, indem Sie die WorkflowQueuingService.GetWorkflowQueue-Methode aufrufen.The following code example demonstrates how you can create a WorkflowQueue by calling the WorkflowQueuingService.GetWorkflowQueue method. Im Beispiel wird auch die Count-Eigenschaft verwendet, um zu bestimmen, ob in der aktuellen Warteschlange Meldungen vorhanden sind.It also uses the Count property to determine whether any messages exist in the current queue. Im Code wird außerdem die Dequeue-Methode verwendet, um das erste Objekt in der Warteschlange zu entfernen und zurückzugeben.Finally, the code uses the Dequeue method to remove and return the first object in the queue.

Dieses Codebeispiel stammt aus dem File Watcher Activity SDK-Beispiel in der Datei FileSystemEvent.cs.This code example is part of the File Watcher Activity SDK Sample from the FileSystemEvent.cs file. Weitere Informationen finden Sie unter Aktivität "Datei System-Watcher".For more information, see File System Watcher Activity.

private bool ProcessQueueItem(ActivityExecutionContext context)
{
    WorkflowQueuingService qService = context.GetService<WorkflowQueuingService>();
    if (!qService.Exists(this.QueueName))
    {
        return false;
    }

    WorkflowQueue queue = qService.GetWorkflowQueue(this.QueueName);

    // If the queue has messages, then process the first one
    if (queue.Count == 0)
    {
        return false;
    }

    FileWatcherEventArgs e = (FileWatcherEventArgs)queue.Dequeue();

    // Raise the FileSystemEvent
    base.RaiseGenericEvent<FileWatcherEventArgs>(FileSystemEvent.FileWatcherEventHandlerEvent, this, e);

    DoUnsubscribe(context, this);
    DeleteQueue(context);
    return true;
}
Private Function ProcessQueueItem(ByVal context As ActivityExecutionContext) As Boolean

    Dim qService As WorkflowQueuingService = context.GetService(Of WorkflowQueuingService)()

    If Not qService.Exists(Me.QueueName) Then
        Return False
    End If

    Dim Queue As WorkflowQueue = qService.GetWorkflowQueue(Me.QueueName)

    ' If the queue has messages, then process the first one
    If Queue.Count = 0 Then
        Return False
    End If

    Dim e As FileWatcherEventArgs = CType(Queue.Dequeue(), FileWatcherEventArgs)

    ' Raise the FileSystemEvent
    MyBase.RaiseGenericEvent(Of FileWatcherEventArgs)(FileSystemEvent.FileWatcherEventHandlerEvent, Me, e)
    DoUnsubscribe(context, Me)
    DeleteQueue(context)
    Return True
End Function

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.

Workflowwarteschlangen werden verwendet, um Meldungen zwischen einem Host oder Hostdiensten und den Aktivitäten in einem Workflow zu übergeben.Workflow queues are used to pass messages between a host or host services and activities in a workflow. Eine beliebige Aktivität kann eine WorkflowQueue erstellen, indem sie WorkflowQueuingService.CreateWorkflowQueue aufruft, und ein Host, ein Dienst oder eine andere Aktivität kann Enqueue aufrufen, um der WorkflowQueue ein Element hinzuzufügen.Any activity can create a WorkflowQueue by calling WorkflowQueuingService.CreateWorkflowQueue, and a host, a service, or another activity can call Enqueue to add an item to that WorkflowQueue. Sie können das QueueItemAvailable-Ereignis abonnieren, um benachrichtigt zu werden, wenn in der WorkflowQueue ein Element ankommt.You can subscribe to the QueueItemAvailable event to be notified when an item arrives on the WorkflowQueue. Sie können Peek verwenden, um ein Element am Anfang von WorkflowQueue und Dequeue zu untersuchen und ein Element aus der WorkflowQueue zu entfernen.You can use Peek to examine an item at the beginning of the WorkflowQueue and Dequeue to remove an item from the WorkflowQueue. Jeder WorkflowQueue ist ein WorkflowQueuingService zugeordnet, mit dem Sie andere Verwaltungsvorgänge für die WorkflowQueue durchführen können, zum Beispiel das Löschen der Warteschlange.Each WorkflowQueue is associated with a WorkflowQueuingService that you can use to perform other management operations on the WorkflowQueue, such as deleting the queue. Der QueuingService legt den WorkflowQueuingService offen, der dieser WorkflowQueue zugeordnet ist.QueuingService exposes the WorkflowQueuingService associated with this WorkflowQueue.

Eigenschaften

Count

Ruft die Anzahl der Elemente in WorkflowQueue ab.Gets the number of items contained in the WorkflowQueue.

Enabled

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob die WorkflowQueue aktiviert ist.Gets or sets a value that specifies whether the WorkflowQueue is enabled.

QueueName

Ruft den Namen der Workflowwarteschlange ab.Gets the name of the workflow queue.

QueuingService

Ruft den Warteschlangendienst ab, der dieser WorkflowQueue zugeordnet ist.Gets the queuing service associated with this WorkflowQueue.

Methoden

Dequeue()

Entfernt das Objekt am Anfang der WorkflowQueue und gibt es zurück.Removes and returns the object at the beginning of the WorkflowQueue.

Enqueue(Object)

Fügt ein Objekt am Ende von WorkflowQueue hinzu.Adds an object to the end of the WorkflowQueue.

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
Peek()

Gibt das Objekt am Anfang der WorkflowQueue zurück, ohne es zu entfernen.Returns the object at the beginning of the WorkflowQueue without removing it.

RegisterForQueueItemArrived(IActivityEventListener<QueueEventArgs>)

Registriert einen Abonnenten für das QueueItemArrived-Ereignis.Registers a subscriber to the QueueItemArrived event.

RegisterForQueueItemAvailable(IActivityEventListener<QueueEventArgs>)

Registriert einen Abonnenten für das QueueItemAvailable-Ereignis.Registers a subscriber to the QueueItemAvailable event.

RegisterForQueueItemAvailable(IActivityEventListener<QueueEventArgs>, String)

Registriert einen Abonnenten für das QueueItemAvailable-Ereignis.Registers a subscriber to the QueueItemAvailable event.

ToString()

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

(Geerbt von Object)
UnregisterForQueueItemArrived(IActivityEventListener<QueueEventArgs>)

Hebt die Registrierung eines Abonnenten des QueueItemArrived-Ereignisses auf.Unregisters a subscriber to the QueueItemArrived event.

UnregisterForQueueItemAvailable(IActivityEventListener<QueueEventArgs>)

Hebt die Registrierung eines Abonnenten des QueueItemAvailable-Ereignisses auf.Unregisters a subscriber to the QueueItemAvailable event.

Ereignisse

QueueItemArrived

Tritt ein, wenn ein Element an diese WorkflowQueue gesendet wird.Occurs when an item is delivered on this WorkflowQueue.

QueueItemAvailable

Tritt auf, wenn ein Element in dieser WorkflowQueue verfügbar ist.Occurs when an item is available on this WorkflowQueue.

Gilt für: