LoggingFields 类

定义

命名空间:

Windows.Foundation.Diagnostics

表示事件字段的序列，并提供用于将字段添加到序列的方法。

public ref class LoggingFields sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class LoggingFields final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LoggingFields

function LoggingFields()

Public NotInheritable Class LoggingFields

继承

Object Platform::Object IInspectable LoggingFields

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

可以将此对象传递给 LoggingChannel。LogEvent 方法，用于为事件提供有效负载 (数据) 。

此类不是线程安全的。 确保多个线程不会同时修改此类的实例。

此类可以创建嵌套结构。 若要创建结构，请调用 BeginStruct 以标记结构的开头。 然后添加属于 结构的字段。 最后，调用 EndStruct 以标记结构的末尾。 结构最多可嵌套八层深。

提示

字段名称和字段标记应用于不经常更改的元数据，而不是频繁更改的数据。 字段名称和标记的值通常应为常量，而不是变量。 事件名称、事件标记、字段名称、字段标记和字段格式是事件标识的一部分， LoggingChannel 跟踪每个唯一的事件标识。 对字段名称和标记使用频繁更改的值会导致应用程序中的内存使用量增加，并可能使事件解码或分析更加复杂。

构造函数

LoggingFields()

初始化新的 LoggingFields 实例。

方法

AddBoolean(String, Boolean)	添加具有指定字段名称的布尔字段。
AddBoolean(String, Boolean, LoggingFieldFormat)	添加具有指定字段名称和格式的布尔字段。
AddBoolean(String, Boolean, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的布尔字段。
AddBooleanArray(String, Boolean[])	添加具有指定字段名称的布尔数组字段。
AddBooleanArray(String, Boolean[], LoggingFieldFormat)	添加具有指定字段名称和格式的布尔数组字段。
AddBooleanArray(String, Boolean[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的布尔数组字段。
AddChar16(String, Char)	添加具有指定字段名称的 16 位字符字段。
AddChar16(String, Char, LoggingFieldFormat)	添加具有指定字段名称和格式的 16 位字符字段。
AddChar16(String, Char, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 16 位字符字段。
AddChar16Array(String, Char[])	添加具有指定字段名称的 16 位字符数组字段。
AddChar16Array(String, Char[], LoggingFieldFormat)	添加具有指定字段名称和格式的 16 位字符数组字段。
AddChar16Array(String, Char[], LoggingFieldFormat, Int32)	添加具有指定字段名称和格式以及标记的 16 位字符数组字段。
AddDateTime(String, DateTime)	添加具有指定字段名称的 DateTime 字段。
AddDateTime(String, DateTime, LoggingFieldFormat)	添加具有指定字段名称和格式的 DateTime 字段。
AddDateTime(String, DateTime, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 DateTime 字段。
AddDateTimeArray(String, DateTime[])	添加具有指定字段名称的 DateTime 数组字段。
AddDateTimeArray(String, DateTime[], LoggingFieldFormat)	添加具有指定字段名称和格式的 DateTime 数组字段。
AddDateTimeArray(String, DateTime[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 DateTime 数组字段。
AddDouble(String, Double)	添加具有指定字段名称的 Double 字段。
AddDouble(String, Double, LoggingFieldFormat)	添加具有指定字段名称和格式的 Double 字段。
AddDouble(String, Double, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 Double 字段。
AddDoubleArray(String, Double[])	添加具有指定字段名称的 Double 数组字段。
AddDoubleArray(String, Double[], LoggingFieldFormat)	添加具有指定字段名称和格式的 Double 数组字段。
AddDoubleArray(String, Double[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 Double 数组字段。
AddEmpty(String)	添加一个空字段。
AddEmpty(String, LoggingFieldFormat)	添加一个空字段。
AddEmpty(String, LoggingFieldFormat, Int32)	添加一个空字段。
AddGuid(String, Guid)	添加具有指定字段名称的 GUID 字段。
AddGuid(String, Guid, LoggingFieldFormat)	添加具有指定字段名称和格式的 GUID 字段。
AddGuid(String, Guid, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 GUID 字段。
AddGuidArray(String, Guid[])	添加具有指定字段名称的 GUID 数组字段。
AddGuidArray(String, Guid[], LoggingFieldFormat)	添加具有指定字段名称和格式的 GUID 数组字段
AddGuidArray(String, Guid[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 GUID 数组字段。
AddInt16(String, Int16)	添加具有指定字段名称的 16 位整数字段。
AddInt16(String, Int16, LoggingFieldFormat)	添加具有指定字段名称和格式的 16 位整数字段。
AddInt16(String, Int16, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 16 位整数字段。
AddInt16Array(String, Int16[])	添加具有指定字段名称的 16 位整数数组字段。
AddInt16Array(String, Int16[], LoggingFieldFormat)	添加具有指定字段名称和格式的 16 位整数数组字段。
AddInt16Array(String, Int16[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 16 位整数数组字段。
AddInt32(String, Int32)	添加具有指定字段名称的 32 位整数数组字段。
AddInt32(String, Int32, LoggingFieldFormat)	添加具有指定字段名称和格式的 32 位整数数组字段。
AddInt32(String, Int32, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 32 位整数数组字段。
AddInt32Array(String, Int32[])	添加具有指定字段名称的 32 位整数数组字段。
AddInt32Array(String, Int32[], LoggingFieldFormat)	添加具有指定字段名称和格式的 32 位整数数组字段。
AddInt32Array(String, Int32[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 32 位整数数组字段。
AddInt64(String, Int64)	添加具有指定字段名称的 64 位整数数组字段。
AddInt64(String, Int64, LoggingFieldFormat)	添加具有指定字段名称和格式的 64 位整数数组字段。
AddInt64(String, Int64, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 64 位整数字段。
AddInt64Array(String, Int64[])	添加具有指定字段名称的 64 位整数数组字段。
AddInt64Array(String, Int64[], LoggingFieldFormat)	添加具有指定字段名称和格式的 64 位整数数组字段。
AddInt64Array(String, Int64[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 64 位整数数组字段。
AddPoint(String, Point)	添加具有指定名称的 Point 字段。
AddPoint(String, Point, LoggingFieldFormat)	添加具有指定名称和格式的 Point 字段。
AddPoint(String, Point, LoggingFieldFormat, Int32)	添加具有指定名称、格式和标记的 Point 字段。
AddPointArray(String, Point[])	添加具有指定字段名称的 Point 数组字段。
AddPointArray(String, Point[], LoggingFieldFormat)	添加具有指定字段名称和格式的 Point 数组字段。
AddPointArray(String, Point[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 Point 数组字段。
AddRect(String, Rect)	添加具有指定字段名称的 Rect 字段。
AddRect(String, Rect, LoggingFieldFormat)	添加具有指定字段名称和格式的 Rect 字段。
AddRect(String, Rect, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 Rect 字段。
AddRectArray(String, Rect[])	添加具有指定字段名称的 Rect 数组字段。
AddRectArray(String, Rect[], LoggingFieldFormat)	添加具有指定字段名称和格式的 Rect 数组字段。
AddRectArray(String, Rect[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 Rect 数组字段。
AddSingle(String, Single)	添加具有指定字段名称的 单个 字段。
AddSingle(String, Single, LoggingFieldFormat)	添加具有指定字段名称和格式的 单个 字段。
AddSingle(String, Single, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 单个 字段。
AddSingleArray(String, Single[])	添加具有指定字段名称的 单个 数组字段。
AddSingleArray(String, Single[], LoggingFieldFormat)	添加具有指定字段名称和格式的 单个 数组字段。
AddSingleArray(String, Single[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 单个 数组字段。
AddSize(String, Size)	添加具有指定字段名称的 Size 字段。
AddSize(String, Size, LoggingFieldFormat)	添加具有指定字段名称和格式 的 Size 字段。
AddSize(String, Size, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记 的 Size 字段。
AddSizeArray(String, Size[])	添加具有指定字段名称 的 Size 数组字段。
AddSizeArray(String, Size[], LoggingFieldFormat)	添加具有指定字段名称和格式的 Size 数组字段。
AddSizeArray(String, Size[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记 的 Size 数组字段。
AddString(String, String)	添加具有指定字段名称的 字符串 字段。
AddString(String, String, LoggingFieldFormat)	添加具有指定字段名称和格式的 字符串 字段。
AddString(String, String, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 字符串 字段。
AddStringArray(String, String[])	添加具有指定字段名称的 字符串 数组字段。
AddStringArray(String, String[], LoggingFieldFormat)	添加具有指定字段名称和格式的 字符串 数组字段。
AddStringArray(String, String[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 字符串 数组字段。
AddTimeSpan(String, TimeSpan)	添加具有指定字段名称的时间跨度字段。
AddTimeSpan(String, TimeSpan, LoggingFieldFormat)	添加具有指定字段名称和格式的时间跨度字段。
AddTimeSpan(String, TimeSpan, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的时间跨度字段。
AddTimeSpanArray(String, TimeSpan[])	添加具有指定字段名称的时间跨度数组字段。
AddTimeSpanArray(String, TimeSpan[], LoggingFieldFormat)	添加具有指定字段名称和格式的时间跨度数组字段。
AddTimeSpanArray(String, TimeSpan[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的时间跨度数组字段。
AddUInt16(String, UInt16)	添加具有指定字段名称的 16 位无符号整数字段。
AddUInt16(String, UInt16, LoggingFieldFormat)	添加具有指定字段名称和格式的 16 位无符号整数字段。
AddUInt16(String, UInt16, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 16 位无符号整数字段。
AddUInt16Array(String, UInt16[])	添加具有指定字段名称的 16 位无符号整数字段。
AddUInt16Array(String, UInt16[], LoggingFieldFormat)	添加具有指定字段名称和格式的 16 位无符号整数数组字段。
AddUInt16Array(String, UInt16[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 16 位无符号整数数组字段。
AddUInt32(String, UInt32)	添加具有指定字段名称的 32 位无符号整数字段。
AddUInt32(String, UInt32, LoggingFieldFormat)	添加具有指定字段名称和格式的 32 位无符号整数字段。
AddUInt32(String, UInt32, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 32 位无符号整数字段。
AddUInt32Array(String, UInt32[])	添加具有指定字段名称的 32 位无符号整数数组字段。
AddUInt32Array(String, UInt32[], LoggingFieldFormat)	添加具有指定字段名称和格式的 32 位无符号整数数组字段。
AddUInt32Array(String, UInt32[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 32 位无符号整数数组字段。
AddUInt64(String, UInt64)	添加具有指定字段名称的 64 位无符号整数字段。
AddUInt64(String, UInt64, LoggingFieldFormat)	添加具有指定字段名称和格式的 64 位无符号整数字段。
AddUInt64(String, UInt64, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 64 位无符号整数字段。
AddUInt64Array(String, UInt64[])	添加具有指定字段名称的 64 位无符号整数数组字段。
AddUInt64Array(String, UInt64[], LoggingFieldFormat)	添加具有指定字段名称和格式的 64 位无符号整数数组字段。
AddUInt64Array(String, UInt64[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 64 位无符号整数数组字段。
AddUInt8(String, Byte)	添加具有指定字段名称的 8 位无符号整数字段。
AddUInt8(String, Byte, LoggingFieldFormat)	添加具有指定字段名称和格式的 8 位无符号整数字段。
AddUInt8(String, Byte, LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 8 位无符号整数字段。
AddUInt8Array(String, Byte[])	添加具有指定字段名称的 8 位无符号整数数组字段。
AddUInt8Array(String, Byte[], LoggingFieldFormat)	添加具有指定字段名称和格式的 8 位无符号整数数组字段。
AddUInt8Array(String, Byte[], LoggingFieldFormat, Int32)	添加具有指定字段名称、格式和标记的 8 位无符号整数数组字段。
BeginStruct(String)	使用指定的字段名称开始新的结构化字段。
BeginStruct(String, Int32)	使用指定的字段名称和标记开始新的结构化字段。
Clear()	删除对象中存储的所有字段，并将对象重置为其新构造的状态。
EndStruct()	结束结构化字段。