You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#create-a-queue)
37
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
38
38
39
39
This example shows how to create a queue:
40
40
@@ -55,7 +55,7 @@ queue.CreateIfNotExists();
55
55
56
56
## Insert a message into a queue
57
57
58
-
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#insert-a-message-into-a-queue)
58
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
59
59
60
60
To insert a message into an existing queue, first create a new [`CloudQueueMessage`](/dotnet/api/microsoft.azure.storage.queue.cloudqueuemessage?view=azure-dotnet-legacy&preserve-view=true). Next, call the [`AddMessage`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.addmessage?view=azure-dotnet-legacy&preserve-view=true) method. A `CloudQueueMessage` can be created from either a string (in UTF-8 format) or a byte array. The following code example creates a queue (if it doesn't already exist) and inserts the message `Hello, World`:
61
61
@@ -80,7 +80,7 @@ queue.AddMessage(message);
80
80
81
81
## Peek at the next message
82
82
83
-
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#peek-at-the-next-message)
83
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
84
84
85
85
You can peek at the message in the front of a queue without removing it from the queue by calling the [`PeekMessage`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.peekmessage?view=azure-dotnet-legacy&preserve-view=true) method.
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#change-the-contents-of-a-queued-message)
107
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
108
108
109
109
```csharp
110
110
// Retrieve storage account from connection string.
@@ -127,7 +127,7 @@ queue.UpdateMessage(message,
127
127
128
128
## Dequeue the next message
129
129
130
-
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#dequeue-the-next-message)
130
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
131
131
132
132
Your code dequeues a message from a queue in two steps. When you call [`GetMessage`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.getmessage?view=azure-dotnet-legacy&preserve-view=true), you get the next message in a queue. A message returned from `GetMessage` becomes invisible to any other code reading messages from this queue. By default, this message stays invisible for 30 seconds. To finish removing the message from the queue, you must also call [`DeleteMessage`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.deletemessage?view=azure-dotnet-legacy&preserve-view=true). This two-step process of removing a message assures that if your code fails to process a message due to hardware or software failure, another instance of your code can get the same message and try again. Your code calls `DeleteMessage` right after the message has been processed.
## Use the async-await pattern with common Queue Storage APIs
153
153
154
-
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#use-the-async-await-pattern-with-common-queue-storage-apis)
154
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#use-additional-options-for-dequeuing-messages)
185
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
186
186
187
187
The following code example uses the [`GetMessages`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.getmessages?view=azure-dotnet-legacy&preserve-view=true) method to get 20 messages in one call. Then it processes each message using a `foreach` loop. It also sets the invisibility timeout to five minutes for each message. The timeout starts for all messages at the same time, so after five minutes have passed since the call to `GetMessages`, any messages that haven't been deleted will become visible again.
188
188
@@ -206,7 +206,7 @@ foreach (CloudQueueMessage message in queue.GetMessages(20, TimeSpan.FromMinutes
206
206
207
207
## Get the queue length
208
208
209
-
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#get-the-queue-length)
209
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
210
210
211
211
You can get an estimate of the number of messages in a queue. The [`FetchAttributes`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.fetchattributes?view=azure-dotnet-legacy&preserve-view=true) method returns queue attributes including the message count. The [`ApproximateMessageCount`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.approximatemessagecount?view=azure-dotnet-legacy&preserve-view=true) property returns the last value retrieved by the `FetchAttributes` method, without calling Queue Storage.
212
212
@@ -233,7 +233,7 @@ Console.WriteLine("Number of messages in queue: " + cachedMessageCount);
233
233
234
234
## Delete a queue
235
235
236
-
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli#delete-a-queue)
236
+
Related article: [Get started with Azure Queue Storage using .NET](storage-quickstart-queues-dotnet.md?tabs=passwordless%2Croles-azure-portal%2Cenvironment-variable-windows%2Csign-in-azure-cli)
237
237
238
238
To delete a queue and all the messages contained in it, call the [`Delete`](/dotnet/api/microsoft.azure.storage.queue.cloudqueue.delete?view=azure-dotnet-legacy&preserve-view=true) method on the queue object.
0 commit comments