AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Container for the parameters to the SendMessage operation.
Delivers a message to the specified queue.
A message can include only XML, JSON, and unformatted text. The following Unicode
characters are allowed. For more information, see the W3C
specification for characters.
Amazon SQS does not throw an exception or completely reject the message if it contains
invalid characters. Instead, it replaces those invalid characters with #x9
| #xA
| #xD
| #x20
to #xD7FF
| #xE000
to #xFFFD
| #x10000
to #x10FFFF
U+FFFD
before storing the message in the queue, as long as the message body contains at least
one valid character.
Namespace: Amazon.SQS.Model
Assembly: AWSSDK.SQS.dll
Version: 3.x.y.z
public class SendMessageRequest : AmazonSQSRequest IAmazonWebServiceRequest
The SendMessageRequest type exposes the following members
Name | Description | |
---|---|---|
SendMessageRequest() |
Empty constructor used to set properties independently even when a simple constructor is available |
|
SendMessageRequest(string, string) |
Instantiates SendMessageRequest with the parameterized properties |
Name | Type | Description | |
---|---|---|---|
DelaySeconds | System.Int32 |
Gets and sets the property DelaySeconds.
The length of time, in seconds, for which to delay a specific message. Valid values:
0 to 900. Maximum: 15 minutes. Messages with a positive
When you set |
|
MessageAttributes | System.Collections.Generic.Dictionary<System.String, Amazon.SQS.Model.MessageAttributeValue> |
Gets and sets the property MessageAttributes.
Each message attribute consists of a |
|
MessageBody | System.String |
Gets and sets the property MessageBody. The message to send. The minimum size is one character. The maximum size is 256 KiB. A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the W3C specification for characters.
Amazon SQS does not throw an exception or completely reject the message if it contains
invalid characters. Instead, it replaces those invalid characters with |
|
MessageDeduplicationId | System.String |
Gets and sets the property MessageDeduplicationId. This parameter applies only to FIFO (first-in-first-out) queues.
The token used for deduplication of sent messages. If a message with a particular
The
If a message is sent successfully but the acknowledgement is lost and the message
is resent with the same Amazon SQS continues to keep track of the message deduplication ID even after the message is received and deleted.
The maximum length of
For best practices of using |
|
MessageGroupId | System.String |
Gets and sets the property MessageGroupId. This parameter applies only to FIFO (first-in-first-out) queues.
The tag that specifies that a message belongs to a specific message group. Messages
that belong to the same message group are processed in a FIFO manner (however, messages
in different message groups might be processed out of order). To interleave multiple
ordered streams within a single queue, use
The maximum length of
For best practices of using
|
|
MessageSystemAttributes | System.Collections.Generic.Dictionary<System.String, Amazon.SQS.Model.MessageSystemAttributeValue> |
Gets and sets the property MessageSystemAttributes.
The message system attribute to send. Each message system attribute consists of a
|
|
QueueUrl | System.String |
Gets and sets the property QueueUrl. The URL of the Amazon SQS queue to which a message is sent. Queue URLs and names are case-sensitive. |
This example shows how to send a message.
var client = new AmazonSQSClient(); var request = new SendMessageRequest { DelaySeconds = (int)TimeSpan.FromSeconds(5).TotalSeconds, MessageAttributes = new Dictionary<string, MessageAttributeValue> { { "MyNameAttribute", new MessageAttributeValue { DataType = "String", StringValue = "John Doe" } }, { "MyAddressAttribute", new MessageAttributeValue { DataType = "String", StringValue = "123 Main St." } }, { "MyRegionAttribute", new MessageAttributeValue { DataType = "String", StringValue = "Any Town, United States" } } }, MessageBody = "John Doe customer information.", QueueUrl = "https://sqs.us-east-1.amazonaws.com/80398EXAMPLE/MyTestQueue" }; var response = client.SendMessage(request); Console.WriteLine("For message ID '" + response.MessageId + "':"); Console.WriteLine(" MD5 of message attributes: " + response.MD5OfMessageAttributes); Console.WriteLine(" MD5 of message body: " + response.MD5OfMessageBody);
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5