MessageEnumerator.MoveNext 方法

  • 參考

定義

命名空間:
System.Messaging
組件:
System.Messaging.dll

讓列舉值前進至佇列中的下一個訊息。

多載

MoveNext()

如果目前有可用的列舉值，讓列舉值前進至佇列中的下一個訊息。
MoveNext(TimeSpan)

讓列舉值前進至佇列中的下一個訊息。 如果列舉值已位於佇列的結尾，MoveNext() 會一直等待，直到有可用的訊息或指定的逾時到期為止。

MoveNext()

如果目前有可用的列舉值，讓列舉值前進至佇列中的下一個訊息。

public:
 virtual bool MoveNext();
public bool MoveNext ();
abstract member MoveNext : unit -> bool
override this.MoveNext : unit -> bool
Public Function MoveNext () As Boolean

傳回

Boolean

如果列舉值成功地前移至下一則訊息，則為 true；如果列舉值已到達佇列結尾，則為 false。

實作

MoveNext()

例外狀況

MessageQueueException

擲回訊息佇列的特定例外狀況。

備註

如果佇列中沒有訊息，此多載會立即傳回。 有另一個多載會等候指定的 TimeSpan ，讓訊息送達。

如果訊息目前無法使用，因為佇列是空的，或因為您已移至集合中的最後一個專案，則會 MoveNext 返回 false 呼叫方法。

建立時，列舉值在佇列的第一個訊息之前，而第一次呼叫 MoveNext 會將佇列的第一個訊息帶入檢視中。

另請參閱

適用於

MoveNext(TimeSpan)

讓列舉值前進至佇列中的下一個訊息。 如果列舉值已位於佇列的結尾，MoveNext() 會一直等待，直到有可用的訊息或指定的逾時到期為止。

public:
 bool MoveNext(TimeSpan timeout);
public bool MoveNext (TimeSpan timeout);
member this.MoveNext : TimeSpan -> bool
Public Function MoveNext (timeout As TimeSpan) As Boolean

參數

timeout
TimeSpan

如果列舉值已經位於佇列的末端，TimeSpan 等待訊息變成可用所需的時間。

傳回

Boolean

如果列舉值成功地前進到下一個訊息，則為 true；如果列舉值已經到達佇列的末端，而且在 timeout 參數指定的時間之內訊息尚未變成可用，則為 false。

例外狀況

ArgumentException

為逾時參數指定的值無效。 可能表示負數。

MessageQueueException

擲回訊息佇列的特定例外狀況。

-或-

已經逾時。

備註

如果佇列中沒有訊息，或數據指標已到達佇列結尾，則此多載會等候。 如果訊息目前無法使用，因為佇列是空的，或因為您已移至集合中的最後一個專案， MoveNext 請等候指定的逾時。

如果數據指標已經在佇列結尾， MoveNext 則只有在新訊息在指定的時間間隔內抵達時，才會傳回 true ，優先順序低於佇列中目前所有訊息，並放置在佇列結尾。 如果沒有進一步的訊息位於佇列中，則沒有參數的多載會立即傳回。

建立時，列舉值在列舉的第一個訊息之前的概念上定位，第一次呼叫 MoveNext 會將列舉的第一個訊息帶入檢視中。

另請參閱

適用於