如何在 TPL 数据流中设置/获取/使用块的名称？

Question

MSDN documentation 表明在DataflowBlockOptions 类上有一个NameFormat 属性，描述为：

获取或设置查询块名称时使用的格式字符串。

那么......你如何设置名称？名称如何可用？什么时候使用？

或者......我怀疑......这只是设计的残余，并没有真正得到实施？

Answer 1

你没有设置名字，你设置了一个NameFormat，它最终会产生一个名字（你当然可以忽略参数并设置你想要的任何东西，比如NameFormat = "bar"）。您可以使用ToString获取名称，例如：

var block = new ActionBlock<int>(_ => { }, new ExecutionDataflowBlockOptions
{
    NameFormat = "The name format may contain up to two format items. {0} will be substituted with the block's name. {1} will be substituted with the block's Id, as is returned from the block's Completion.Id property."
});

Console.WriteLine(block.ToString());

输出：

名称格式最多可以包含两个格式项。 ActionBlock`1 将替换为块的名称。 1 将替换为块的 ID，从块的 Completion.Id 属性返回。

---

如果我们查看source code on .Net Core，ToString 的实现基本上：

return string.Format(options.NameFormat, block.GetType().Name, block.Completion.Id);