你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 .NET 的 Azure.Messaging.EventGrid 库的 CloudNative CloudEvent 支持

项目
04/18/2023

此库可用于启用使用 Azure 事件网格库发布 CloudNative CloudEvents。

入门

安装包

从 NuGet 安装客户端库：

dotnet add package Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents --prerelease

先决条件

必须具有 Azure 订阅和具有自定义事件网格主题或域的 Azure 资源组。按照此分步教程注册事件网格资源提供程序并使用Azure 门户创建事件网格主题。有一个类似的教程使用 Azure CLI。

验证客户端

为了使客户端库与主题或域交互，需要 endpoint 事件网格主题的和 credential，可以使用主题的访问密钥创建。

可以在 Azure 门户中或使用下面的 Azure CLI 代码片段找到事件网格主题的终结点。

az eventgrid topic show --name <your-resource-name> --resource-group <your-resource-group-name> --query "endpoint"

还可以通过门户或使用下面的 Azure CLI 代码片段找到访问密钥：

az eventgrid topic key list --name <your-resource-name> --resource-group <your-resource-group-name> --query "key1"

创建和身份验证 `EventGridPublisherClient`

获取访问密钥和主题终结点后，可以按如下所示创建发布者客户端：

EventGridPublisherClient client = new EventGridPublisherClient(
    new Uri("<endpoint>"),
    new AzureKeyCredential("<access-key>"));

关键概念

有关常规事件网格概念的信息：Azure 事件网格中的概念。

有关事件网格客户端库概念的详细信息：事件网格客户端库

示例

EventGridPublisherClient client = new EventGridPublisherClient(
        new Uri(TestEnvironment.CloudEventTopicHost),
        new AzureKeyCredential(TestEnvironment.CloudEventTopicKey));

var cloudEvent =
    new CloudEvent
    {
        Type = "record",
        Source = new Uri("http://www.contoso.com"),
        Data = "data"
    };
await client.SendCloudNativeCloudEventAsync(cloudEvent);

故障排除

有关故障排除信息，请参阅事件网格客户端库文档。

后续步骤

在此处查看更多示例，了解库的常见用法。

贡献

本项目欢迎贡献和建议。大多数贡献要求你同意贡献者许可协议 (CLA)，并声明你有权（并且确实有权）授予我们使用你的贡献的权利。有关详细信息，请访问 https://cla.microsoft.com 。

提交拉取请求时，CLA 机器人将自动确定你是否需要提供 CLA，并相应地修饰 PR（例如标签、注释）。直接按机器人提供的说明操作。只需使用 CLA 对所有存储库执行一次这样的操作。

此项目采用了 Microsoft 开放源代码行为准则。有关详细信息，请参阅行为准则常见问题解答，或如果有任何其他问题或意见，请与联系。

通过