(0) exportieren Drucken
Alle erweitern
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

CloudQueue.AddMessage Method (CloudQueueMessage, Nullable, Nullable)

Updated: September 27, 2013

[This topic is part of the Microsoft Azure Storage Client Library 1.7, which has been deprecated. See Storage Client Library for the latest version.]

Adds a message to the queue, with a value specifying its expiration (the length of time it can remain in the queue), and a value specifying how long it must first remain invisible (delayed visibility).

Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)

Dim instance As CloudQueue
Dim message As CloudQueueMessage
Dim timeToLive As Nullable(Of TimeSpan)
Dim initialVisibilityDelay As Nullable(Of TimeSpan)

instance.AddMessage(message, timeToLive, initialVisibilityDelay)

public void AddMessage (
	CloudQueueMessage message,
	Nullable<TimeSpan> timeToLive,
	Nullable<TimeSpan> initialVisibilityDelay



A queue message.


A value indicating the message time-to-live.


The visibility delay for the message.

The AddMessage method adds a message to the back of the queue.

A message can be up to 64 KB in size for SDK version 1.6 or newer, or 8 KB in size for older SDK versions. The storage client library encodes the message content using Base64 when EncodeMessage is set to true, its default. Encode messages if message content can contain characters that are invalid in XML.

Encoding with Base64 adds overhead to the message size. You can use Convert.ToBase64String() to verify content encoded with Base64 fits within the 64 KB message size limit.

The message time-to-live specifies how long a message will remain in the queue, from the time it is added to the time it is retrieved and deleted. If a message is not retrieved before the time-to-live interval expires, the message is removed from the queue.

The message visibility delay specifies the time that the message will be invisible. After the delay expires, the message will become visible. Visibility of a message can be delayed for up to 7 days.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012


© 2014 Microsoft