tencent cloud

TDMQ for RocketMQ

C# SDK

PDF
フォーカスモード
フォントサイズ
最終更新日: 2026-01-23 17:52:25

Scenarios

This document uses the C# SDK as an example to describe how to send and receive messages through an open-source software development kit (SDK), helping you better understand the complete process of sending and receiving messages.

Prerequisites

You have obtained the client connection parameters as instructed in SDK Overview.

Operation Steps

Step 1: Preparing the Environment

Create a project based on your integrated development environment (IDE), and install the NewLife.RocketMQ dependency.
dotnet add package NewLife.RocketMQ --version 2.0.2022.325-beta0806

Step 2: Producing Messages

Create, compile, and run a message production program.
//Producer.
var mq = new Producer
{
Topic = "TopicTest1", //For a non-general cluster, you need to concatenate the complete topic, such as MQ_INSTxxx_aaa%TopicTest.
NameServerAddress = "127.0.0.1:9876",// Enter it on the Tencent Cloud page.
Log = XTrace.Log,
AclOptions = new AclOptions
{
AccessKey = "AccessKey of the page",
SecretKey = "SecretKey of the page",
},
};
mq.Start();
for (var i = 0; i < 10; i++)
{
var str = "Message production test" + i;
var sr = mq.Publish(str, "TagA");
}
Note:
You can log in to the TDMQ for RocketMQ console to obtain the following parameters.
Parameter
Description
Topic
Topic name. You can copy the name from the Topic Management page in the console.
4.x virtual/exclusive cluster: Concatenate the namespace name in the format of full namespace name%topic name, such as MQ_INSTxxx_aaa%TopicTest.
4.x general cluster/5.x cluster: The namespace name does not need to be concatenated. Enter the topic name.
NameServerAddress
Cluster access address. You can obtain the access address from the Access Information module on the Cluster Basic Information page in the console.
SecretKey
Role name. You can copy the role name from the SecretKey column on the Cluster Permissions page in the console.
AccessKey
Role token. You can copy the token from the AccessKey column on the Cluster Permissions page in the console.
TAGS
Tags associated with the message.

Step 3: Consuming Messages

Create, compile, and run a message consumption program.
//Consumer.
var consumer = new Consumer
{
Topic = "TopicTest1", //For a non-general cluster, you need to concatenate a complete topic, such as MQ_INSTxxx_aaa%TopicTest.
Group = "test", // For a non-general cluster, you need to concatenate a complete group, such as MQ_INSTxxx_aaa%GroupTest.
NameServerAddress = "127.0.0.1:9876",
FromLastOffset = true,
SkipOverStoredMsgCount = 0,
BatchSize = 20,
Log = XTrace.Log,
AclOptions = new AclOptions
{
AccessKey = "AccessKey of the page",
SecretKey = "SecretKey of the page",
},
};
consumer.OnConsume = (q, ms) =>
{
XTrace.WriteLine("[{0}@{1}] received message [{2}]", q.BrokerName, q.QueueId, ms.Length);
foreach (var item in ms.ToList())
{
XTrace.WriteLine($"message {item.Keys}, sending time {item.BornTimestamp.ToDateTime()}, content {item.Body.ToStr()}");
}
return true;
};
consumer.Start();
Note:
You can log in to the TDMQ for RocketMQ console to obtain the following parameters.
Parameter
Description
Topic
Topic name. You can copy the name from the Topic Management page in the console.
4.x virtual/exclusive cluster: Concatenate the namespace name in the format of full namespace name%topic name, such as MQ_INSTxxx_aaa%TopicTest.
4.x general cluster/5.x cluster: The namespace name does not need to be concatenated. Enter the topic name.
Group
Group name. You can copy the name from the Group Management page in the console.
4.x virtual cluster/exclusive cluster: Concatenate the namespace name in the format of full namespace name%group name, such as MQ_INSTxxx_aaa%GroupTest.
4.x general cluster/5.x cluster: The namespace name does not need to be concatenated. Enter the group name.
NameServerAddress
Cluster access address. You can obtain the access address from the Access Information module on the Cluster Basic Information page in the console.
SecretKey
Role name. You can copy the role name from the SecretKey column on the Cluster Permissions page in the console.
AccessKey
Role token. You can copy the token from the AccessKey column on the Cluster Permissions page in the console.

Step 4: Viewing Consumption Details

Log in to the TDMQ for RocketMQ console, choose Cluster > Group to view the list of clients connected to the group. Click View Details in the operation column to view consumer details.

Step 5: Viewing Message Details

After a message is sent, you will receive a message ID (messageID). You can choose Message Query > General Query in the console to query the recently sent message, including the message details and trace.


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック