ActivityTraceId 结构

定义

表示 TraceId,其格式基于 W3C 标准。

C#
public readonly struct ActivityTraceId : IEquatable<System.Diagnostics.ActivityTraceId>
继承
ActivityTraceId
实现

注解

结构 ActivityTraceId 反映了 W3C 标准对整个跟踪的 ID 所需的格式。 它由 16 个字节组成,通常表示为 32 个十六进制字符。 ActivityTraceId由 属性返回 TraceId

ActivityTraceId由于 是包含 16 个字节的结构,因此可以通过引用轻松传递它。 ActivityTraceId 包含用于转换到十六进制字符串表示形式和从其转换的方法,尝试避免在必须更改之前更改格式,并在创建后缓存其字符串表示形式。 它主要用作交换类型。

方法

CopyTo(Span<Byte>)

将当前 ActivityTraceId 的 16 个字节复制到指定的范围。

CreateFromBytes(ReadOnlySpan<Byte>)

从一个包含 16 个字节的只读范围创建一个新的 ActivityTraceId 值。

CreateFromString(ReadOnlySpan<Char>)

从一个包含 32 个十六进制字符的只读范围创建一个新的 ActivityTraceId 值。

CreateFromUtf8String(ReadOnlySpan<Byte>)

从一个包含 UTF8 编码字节的只读范围创建一个新的 ActivityTraceId 值。

CreateRandom()

基于一个随机数字(很可能是唯一的数字)创建一个新的 ActivityTraceId

Equals(ActivityTraceId)

确定当前实例与指定的 ActivityTraceId 是否相等。

Equals(Object)

确定此实例是否与指定的对象(也必须是 ActivityTraceId 实例)具有相同的值。

GetHashCode()

返回 TraceId 的哈希代码。

ToHexString()

返回一个 32 个字符的十六进制字符串,表示此范围 ID。

ToString()

返回表示此跟踪 ID 的 32 个字符的十六进制字符串。

运算符

Equality(ActivityTraceId, ActivityTraceId)

确定两个指定的 ActivityTraceId 实例是否具有相同的值。

Inequality(ActivityTraceId, ActivityTraceId)

确定两个指定的 ActivityTraceId 实例是否具有相同的值。

适用于

产品 版本
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9