Share via


How to: Set Queue References

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

You have three choices in the way you refer to a queue in your project — you can refer to it by the path to the queue, by the queue's automatically generated format name, or by the non-unique descriptive label of the queue. Each of these ways of referencing a queue has its advantages and disadvantages. For more information, see Queue Reference Recommendations.

Note

When you set a queue reference, you are merely linking the MessageQueue component you created to the existing queue. You are not changing the way the actual queue itself is identified on the server.

To set a queue reference

  1. Create an instance of the MessageQueue component. For more information, see How to: Create MessageQueue Component Instances.

    In the Properties window, select the ellipsis (...) button next to the Path() property to display the Message Queue Browser dialog box.

  2. In the dialog box, browse the Select Message Queue list and select the queue you want to reference.

  3. In the Reference Queue By drop-down list, select one of the following:

    • To refer to the queue by its path, select Path.

    • To refer to the queue by its format name, select FormatName.

    • To refer to the queue by its label, select Label.

  4. Click OK to return to the Properties window. The Path property now shows the path, format name, or label for the queue you selected.

See Also

Concepts

Queue Reference Recommendations

Other Resources

Creating, Deleting, and Administering Queues