IEnrichmentTagCollector.Add(String, Object) 方法

定义

命名空间:

Microsoft.Extensions.Diagnostics.Enrichment

程序集:

Microsoft.Extensions.Telemetry.Abstractions.dll

包:

Microsoft.Extensions.Telemetry.Abstractions v9.0.0-preview.6.24353.1

Source:

IEnrichmentTagCollector.cs

以键/值对的形式添加标记。

public:
 void Add(System::String ^ tagName, System::Object ^ tagValue);

public void Add (string tagName, object tagValue);

abstract member Add : string * obj -> unit

Public Sub Add (tagName As String, tagValue As Object)

参数

tagName

String

扩充属性键。

tagValue

Object

扩充属性值。

例外

ArgumentException

tagName 是一个空字符串。

ArgumentNullException

tagName 或 tagValue 为 null。

注解

对于日志扩充， tagValue 将按照以下规则进行序列化：

• 数组：在循环中识别和序列化。
• IDictionary：识别为 IDictionary<字符串、对象> 并在循环中序列化。
• DateTime：在转换为 ToUniversalTime()后识别并序列化。
• 所有其他基元类型：已 String 按原样转换为 并序列化。

对于指标扩充， tagValue 使用 ToString() 方法转换为String格式。