佇列和訊息集合

更新:2007 年 11 月

您可以使用 MessageQueue 類別 (Class) 中許多可用的擷取方法,在訊息佇列網路上擷取佇列清單及所包含的訊息。如果您要執行管理工作、產生佇列內容的報表或是搜尋佇列的內容以找出符合特定準則的訊息,您可能需要擷取佇列和訊息的清單。

您主要可以透過兩種方式擷取訊息和訊息佇列:擷取網路上訊息或佇列的靜態 (Static) 快照集 (Snapshot),或是使用列舉值來逐一查看訊息和佇列。擷取佇列或訊息的靜態清單要比擷取列舉型別 (Enumeration) 來得快,但所產生資料集的正確性卻比較較低,而且您也較無法對其進行控制。如果您需要在網路中的所有公用佇列上執行管理工作,可以使用靜態快照集來擷取。

列舉值則讓您能夠進一步控制您要如何與擷取結果互動。您可以使用列舉值找出符合特定準則的佇列或訊息,而不需逐一評估傳回集合中的每個項目。例如,如果您要檢視佇列的內容並只要使用某個屬性設定為 true 的訊息,則可使用列舉值。

訊息佇列擷取

您可以利用下列幾種方式來擷取訊息佇列的資訊:

  • 可以擷取網路上所有公用或私用佇列的靜態陣列。

  • 可以擷取網路上所有公用佇列的靜態子集,方式是指定像是佇列的建立或修改日期和時間等特定準則,或是指定用來擷取佇列的分類、標籤 (Label) 或電腦。

  • 可以使用列舉值來反覆查看網路上的佇列,或是指定電腦名稱、建立日期和時間及分類來重複網路上所有佇列的子集。

您也可以使用 Exists 方法,來判斷所要的佇列是否存在。Exists 方法會利用您定義的路徑來搜尋特定佇列。

如需擷取訊息佇列清單的指示,請參閱 HOW TO:擷取佇列

訊息擷取

當您擷取陣列或列舉值當中的訊息時,您實際上並不是像讀取或接收訊息時一般地將這些訊息從佇列中取出。您反而是擷取佇列中項目的資訊,而想接收訊息的使用者還是可以取得真正的訊息。

您可利用下列方式來擷取訊息:

  • 您可擷取佇列中所有訊息的靜態陣列。

  • 您可使用列舉值來反覆查看佇列中的訊息。

如需擷取訊息清單的指示,請參閱 HOW TO:擷取訊息

使用列舉值中的項目

在您建立訊息或佇列的列舉之後,在概念上,列舉值是位於列舉型別的第一個項目之前。您可以呼叫 MoveNext 方法,移至清單中的第一個項目,並往後移至接下來的項目。您也可以使用 Current 方法,來傳回目前在列舉型別中位置所在的項目。

請參閱

工作

HOW TO:擷取佇列

HOW TO:擷取訊息