MessageEnumerator.RemoveCurrent Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tar bort det aktuella meddelandet från kön och returnerar meddelandet till det anropande programmet. Om du tar bort meddelandet tas det bort från kön.
Överlagringar
| Name | Description |
|---|---|
| RemoveCurrent() |
Tar bort det aktuella meddelandet från en transaktionell eller icke-transaktionell kö och returnerar meddelandet till det anropande programmet. Ingen tidsgräns har angetts för att ett meddelande ska tas emot i kön. |
| RemoveCurrent(MessageQueueTransaction) |
Tar bort det aktuella meddelandet från en transaktionskö och returnerar meddelandet till det anropande programmet. Ingen tidsgräns har angetts för att ett meddelande ska tas emot i kön. |
| RemoveCurrent(MessageQueueTransactionType) |
Tar bort det aktuella meddelandet från en kö och returnerar meddelandet till det anropande programmet. Ingen tidsgräns har angetts för att ett meddelande ska tas emot i kön. |
| RemoveCurrent(TimeSpan) |
Tar bort det aktuella meddelandet från kön och returnerar meddelandet till det anropande programmet. Om det finns ett meddelande att ta bort returnerar metoden den omedelbart. Annars väntar metoden på den angivna tidsgränsen för att ett nytt meddelande ska tas emot. |
| RemoveCurrent(TimeSpan, MessageQueueTransaction) |
Tar bort det aktuella meddelandet från en transaktionskö och returnerar meddelandet till det anropande programmet. Om det finns ett meddelande att ta bort returnerar metoden den omedelbart. Annars väntar metoden på den angivna tidsgränsen för att ett nytt meddelande ska tas emot. |
| RemoveCurrent(TimeSpan, MessageQueueTransactionType) |
Tar bort det aktuella meddelandet från en kö och returnerar meddelandet till det anropande programmet. Om det finns ett meddelande att ta bort returnerar metoden den omedelbart. Annars väntar metoden på den angivna tidsgränsen för att ett nytt meddelande ska tas emot. |
Kommentarer
Det beteende som beskrivs för dessa överlagringar gäller endast om instansen MessageEnumerator hämtas med hjälp GetMessageEnumerator2av . Använd GetMessageEnumerator inte för att hämta en instans av MessageEnumerator eftersom den här metoden har föråldrats.
RemoveCurrent()
Tar bort det aktuella meddelandet från en transaktionell eller icke-transaktionell kö och returnerar meddelandet till det anropande programmet. Ingen tidsgräns har angetts för att ett meddelande ska tas emot i kön.
public:
System::Messaging::Message ^ RemoveCurrent();public System.Messaging.Message RemoveCurrent();member this.RemoveCurrent : unit -> System.Messaging.MessagePublic Function RemoveCurrent () As MessageReturer
En Message som refererar till det första meddelandet som är tillgängligt i kön.
Kommentarer
RemoveCurrent tar bort och returnerar meddelandet på markörens aktuella plats.
Om du använder köjournaler, gör borttagning av meddelandet att en kopia sparas i journalkön, precis som MessageQueue klassens Receive metod gör.
När du tar bort det aktuella meddelandet flyttas markören till nästa meddelande. Du behöver inte ringa MoveNext efter att du har ringt RemoveCurrent.
Om du anropar den här överbelastningen i en transaktionskö skapar Message Queuing en enda intern transaktion.
Se även
Gäller för
RemoveCurrent(MessageQueueTransaction)
Tar bort det aktuella meddelandet från en transaktionskö och returnerar meddelandet till det anropande programmet. Ingen tidsgräns har angetts för att ett meddelande ska tas emot i kön.
public:
System::Messaging::Message ^ RemoveCurrent(System::Messaging::MessageQueueTransaction ^ transaction);public System.Messaging.Message RemoveCurrent(System.Messaging.MessageQueueTransaction transaction);member this.RemoveCurrent : System.Messaging.MessageQueueTransaction -> System.Messaging.MessagePublic Function RemoveCurrent (transaction As MessageQueueTransaction) As MessageParametrar
- transaction
- MessageQueueTransaction
Objektet MessageQueueTransaction som anger transaktionen där meddelandet ska tas bort.
Returer
En Message som refererar till det första meddelandet som är tillgängligt i kön.
Undantag
Parametern transaction är null.
Kommentarer
RemoveCurrent tar bort och returnerar meddelandet på markörens aktuella plats med hjälp av den interna transaktionskontext som definieras av parametern transaction .
Om du använder köjournaler, gör borttagning av meddelandet att en kopia sparas i journalkön, precis som MessageQueue klassens Receive metod gör.
När du arbetar med transaktionsköer gör en återställning av en transaktion att RemoveCurrent meddelanden som tas bort av ett anrop returneras till kön. Borttagningen kan inte ångras förrän transaktionen har checkats in.
När du tar bort det aktuella meddelandet flyttas markören till nästa meddelande. Du behöver inte ringa MoveNext efter att du har ringt RemoveCurrent.
Se även
Gäller för
RemoveCurrent(MessageQueueTransactionType)
Tar bort det aktuella meddelandet från en kö och returnerar meddelandet till det anropande programmet. Ingen tidsgräns har angetts för att ett meddelande ska tas emot i kön.
public:
System::Messaging::Message ^ RemoveCurrent(System::Messaging::MessageQueueTransactionType transactionType);public System.Messaging.Message RemoveCurrent(System.Messaging.MessageQueueTransactionType transactionType);member this.RemoveCurrent : System.Messaging.MessageQueueTransactionType -> System.Messaging.MessagePublic Function RemoveCurrent (transactionType As MessageQueueTransactionType) As MessageParametrar
- transactionType
- MessageQueueTransactionType
Ett av MessageQueueTransactionType värdena som beskriver vilken typ av transaktionskontext som ska associeras med meddelandet.
Returer
En Message som refererar till det första meddelandet som är tillgängligt i kön.
Undantag
Parametern transactionType är inte en av MessageQueueTransactionType medlemmarna.
Kommentarer
RemoveCurrent tar bort och returnerar meddelandet på markörens aktuella plats med hjälp av en transaktionskontext som definieras av parametern transactionType .
Ange Automatic för parametern transactionType om det redan finns en extern transaktionskontext kopplad till tråden som du vill använda för att ta emot meddelandet. Ange Single om du vill ta emot meddelandet som en enda intern transaktion. Du kan ange None om du vill ta emot ett meddelande från en transaktionskö utanför en transaktionskontext.
Om du använder köjournaler, gör borttagning av meddelandet att en kopia sparas i journalkön, precis som MessageQueue klassens Receive metod gör.
När du arbetar med transaktionsköer gör en återställning av en transaktion att RemoveCurrent meddelanden som tas bort av ett anrop returneras till kön. Borttagningen kan inte ångras förrän transaktionen har checkats in.
När du tar bort det aktuella meddelandet flyttas markören till nästa meddelande. Du behöver inte ringa MoveNext efter att du har ringt RemoveCurrent.
Se även
Gäller för
RemoveCurrent(TimeSpan)
Tar bort det aktuella meddelandet från kön och returnerar meddelandet till det anropande programmet. Om det finns ett meddelande att ta bort returnerar metoden den omedelbart. Annars väntar metoden på den angivna tidsgränsen för att ett nytt meddelande ska tas emot.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout);public System.Messaging.Message RemoveCurrent(TimeSpan timeout);member this.RemoveCurrent : TimeSpan -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan) As MessageParametrar
- timeout
- TimeSpan
Tidsintervallet för att vänta på att ett meddelande ska tas emot i kön.
Returer
En Message som refererar till det första meddelandet som är tillgängligt i kön.
Undantag
Värdet som anges för parametern timeout är ogiltigt.
Tidsgränsen har upphört att gälla.
Kommentarer
RemoveCurrent tar bort och returnerar meddelandet på markörens aktuella plats. Om markören är i slutet av kön väntar den här överlagringen av metoden tills ett meddelande är tillgängligt eller det intervall som anges av parametern timeout har upphört att gälla.
Om du använder köjournaler, gör borttagning av meddelandet att en kopia sparas i journalkön, precis som MessageQueue klassens Receive metod gör.
När du tar bort det aktuella meddelandet flyttas markören till nästa meddelande. Du behöver inte ringa MoveNext efter att du har ringt RemoveCurrent.
Om du anropar den här överbelastningen i en transaktionskö skapar Message Queuing en enda intern transaktion.
Se även
Gäller för
RemoveCurrent(TimeSpan, MessageQueueTransaction)
Tar bort det aktuella meddelandet från en transaktionskö och returnerar meddelandet till det anropande programmet. Om det finns ett meddelande att ta bort returnerar metoden den omedelbart. Annars väntar metoden på den angivna tidsgränsen för att ett nytt meddelande ska tas emot.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout, System::Messaging::MessageQueueTransaction ^ transaction);public System.Messaging.Message RemoveCurrent(TimeSpan timeout, System.Messaging.MessageQueueTransaction transaction);member this.RemoveCurrent : TimeSpan * System.Messaging.MessageQueueTransaction -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transaction As MessageQueueTransaction) As MessageParametrar
- timeout
- TimeSpan
Tidsintervallet för att vänta tills meddelandet tas bort.
- transaction
- MessageQueueTransaction
Objektet MessageQueueTransaction som anger transaktionskontexten för meddelandet.
Returer
En Message som refererar till det första meddelandet som är tillgängligt i kön.
Undantag
Värdet som anges för parametern timeout är ogiltigt.
Parametern transaction är null.
Tidsgränsen har upphört att gälla.
Kommentarer
RemoveCurrent tar bort och returnerar meddelandet på markörens aktuella plats. Om markören är i slutet av kön väntar den här överlagringen av metoden tills ett meddelande är tillgängligt eller det intervall som anges av parametern timeout har upphört att gälla.
När du arbetar med transaktionsköer gör en återställning av en transaktion att RemoveCurrent meddelanden som tas bort av ett anrop returneras till kön. Borttagningen kan inte ångras förrän transaktionen har checkats in.
Om du använder köjournaler, gör borttagning av meddelandet att en kopia sparas i journalkön, precis som MessageQueue klassens Receive metod gör.
När du tar bort det aktuella meddelandet flyttas markören till nästa meddelande. Du behöver inte ringa MoveNext efter att du har ringt RemoveCurrent.
Se även
Gäller för
RemoveCurrent(TimeSpan, MessageQueueTransactionType)
Tar bort det aktuella meddelandet från en kö och returnerar meddelandet till det anropande programmet. Om det finns ett meddelande att ta bort returnerar metoden den omedelbart. Annars väntar metoden på den angivna tidsgränsen för att ett nytt meddelande ska tas emot.
public:
System::Messaging::Message ^ RemoveCurrent(TimeSpan timeout, System::Messaging::MessageQueueTransactionType transactionType);public System.Messaging.Message RemoveCurrent(TimeSpan timeout, System.Messaging.MessageQueueTransactionType transactionType);member this.RemoveCurrent : TimeSpan * System.Messaging.MessageQueueTransactionType -> System.Messaging.MessagePublic Function RemoveCurrent (timeout As TimeSpan, transactionType As MessageQueueTransactionType) As MessageParametrar
- timeout
- TimeSpan
Tidsintervallet för att vänta tills meddelandet tas bort.
- transactionType
- MessageQueueTransactionType
Ett av MessageQueueTransactionType värdena som beskriver vilken typ av transaktionskontext som ska associeras med meddelandet.
Returer
En Message som refererar till det första meddelandet som är tillgängligt i kön.
Undantag
Värdet som anges för parametern timeout är ogiltigt.
Tidsgränsen har upphört att gälla.
Parametern transactionType är inte en av MessageQueueTransactionType medlemmarna.
Kommentarer
RemoveCurrent tar bort och returnerar meddelandet på markörens aktuella plats med hjälp av en transaktionskontext som definieras av parametern transactionType . Om markören är i slutet av kön väntar den här överlagringen av metoden tills ett meddelande är tillgängligt eller det intervall som anges av parametern timeout har upphört att gälla.
Ange Automatic för parametern transactionType om det redan finns en extern transaktionskontext kopplad till tråden som du vill använda för att ta emot meddelandet. Ange Single om du vill ta emot meddelandet som en enda intern transaktion. Du kan ange None om du vill ta emot ett meddelande från en transaktionskö utanför en transaktionskontext.
Om du använder köjournaler, gör borttagning av meddelandet att en kopia sparas i journalkön, precis som MessageQueue klassens Receive metod gör.
När du arbetar med transaktionsköer gör en återställning av en transaktion att RemoveCurrent meddelanden som tas bort av ett anrop returneras till kön. Borttagningen kan inte ångras förrän transaktionen har checkats in.
När du tar bort det aktuella meddelandet flyttas markören till nästa meddelande. Du behöver inte ringa MoveNext efter att du har ringt RemoveCurrent.
