如何：指定与消息一起检索的属性

更新：2007 年 11 月

创建 MessageQueue 组件的实例时，可以设置一系列属性以指示当组件从队列中获取消息时要检索的属性。这些属性在一个名为 MessagePropertyFilter 的类中，它对应于 Message 类上的实际属性。将这些属性中一个属性的值设置为 true 时，每次从队列中移除消息，组件都将检索相应的属性。

提示：
如果不需要访问检索的消息中的某些属性，并且希望提高性能，可以将 MessagePropertyFilter 设置为 false。

默认情况下，与消息一起检索的属性包括：指示消息的发送和到达时间的属性，指示消息的若干标识符的属性，指示消息标签的属性，指示响应队列的属性，以及指示消息正文的属性。

指定要与消息一起检索的属性

1. 创建 MessageQueue 组件的一个实例，并将其 Path 属性设置为要引用的队列。有关更多信息，请参见如何：创建 MessageQueue 组件实例。

2. 在“属性”窗口中，展开“MessageReadPropertyFilter”节点。

3. 将要检索的属性的值设置为 true。

   说明：
   也可以使用代码完成以上设置。在使用代码进行设置时，可以使用 SetAll 方法将所有筛选器属性设置为 true，或者使用 ClearAll 方法将所有筛选器属性设置为 false。

请参见

任务

如何：以编程方式接收消息

如何：查看消息

如何：异步接收消息

如何：创建 MessageQueue 组件实例

其他资源

读取和接收消息