NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

MessageQueue.Create

Creates a new backend queue resource with the specified path.

Overload List

Creates a nontransactional Message Queuing backend queue resource with the specified path.

[Visual Basic] Overloads Public Shared Function Create(String) As MessageQueue
[C#] public static MessageQueue Create(String);
[C++] public: static MessageQueue* Create(String*);
[JScript] public static function Create(String) : MessageQueue;

Creates a transactional or nontransactional Message Queuing backend queue resource with the specified path.

[Visual Basic] Overloads Public Shared Function Create(String, Boolean) As MessageQueue
[C#] public static MessageQueue Create(String, bool);
[C++] public: static MessageQueue* Create(String*, bool);
[JScript] public static function Create(String, Boolean) : MessageQueue;

Example [Visual Basic]

The following example verifies whether a queue named "myNewQueue" exists on the local computer. If it doesn't, one is created and set to be transactional. If a queue named "myNewQueue" already exists, it is examined to see if it is transactional.

If the queue is transactional or was created by the procedure (and hence is transactional), a message is sent to the queue.

Note   This example shows how to use one of the overloaded versions of Create. For other examples that may be available, see the individual overload topics.

[Visual Basic]

Private Sub CreateTransactionalQueue(ByVal msg As Message)
    'Define a new MessageQueue.
    Dim messageQueue1 As MessageQueue

    If Not MessageQueue.Exists(".\myNewQueue") Then
        'Create a new transactional queue on the local computer.
        messageQueue1 = MessageQueue.Create(".\myNewQueue", True)
    Else
        'The queue exists already. Verify that it is transactional.
        messageQueue1 = New MessageQueue(".\myNewQueue")
        If Not messageQueue1.Transactional Then
Exit Sub
        End If
    End If

    'Send a message to the queue.
    messageQueue1.Send(msg)
End Sub

See Also

MessageQueue Class | MessageQueue Members | System.Messaging Namespace