Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MessageQueue.PeekById (String)

 

Data di pubblicazione: ottobre 2016

Visualizza il messaggio il cui identificatore corrisponde il id parametro.

Spazio dei nomi:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

public Message PeekById(
	string id
)

Parametri

id
Type: System.String

Il Id del messaggio da leggere.

Valore restituito

Type: System.Messaging.Message

Il Message cui Id proprietà corrispondenze di id parametro.

Exception Condition
ArgumentNullException

Il valore del parametro id è null.

InvalidOperationException

Nessun messaggio con l'oggetto specificato id esiste.

MessageQueueException

Si è verificato un errore quando si accede a un metodo di Accodamento messaggi.

Utilizzare PeekById(String) per leggere, senza rimuoverlo dalla coda, un messaggio che contiene un identificatore di messaggio conosciuto. L'identificatore di un messaggio è univoca all'interno dell'azienda di Accodamento messaggi, esisterà al massimo un messaggio in coda a cui corrisponde il determinato id parametro. Questo overload genera un'eccezione se la coda non è attualmente contiene il messaggio.

Altri due metodi consentono di leggere i messaggi in una coda: Peek e PeekByCorrelationId(String). Il Peek metodo restituisce il primo messaggio della coda; PeekByCorrelationId(String) restituisce un riconoscimento, report o il messaggio di risposta generati dall'applicazione che è stato creato come risultato di un messaggio inviato alla coda.

Nella tabella seguente indica se questo metodo è disponibile in diverse modalità gruppo di lavoro.

Modalità gruppo di lavoro

Disponibile

Computer locale

Computer locale e il nome di formato direct

Computer remoto

No

Computer remoto e il nome di formato direct

L'esempio di codice seguente illustra l'uso di PeekById(String).


// Connect to a queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleQueue");

// Create a new message.
Message msg = new Message("Example Message Body");

// Send the message.
queue.Send(msg, "Example Message Label");

// Get the message's Id property value.
string id = msg.Id;

// Simulate doing other work so the message has time to arrive.
System.Threading.Thread.Sleep(TimeSpan.FromSeconds(10.0));

// Peek at the message.
msg = queue.PeekById(id);

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: