DiagnosticSource.Write Метод

Определение

Перегрузки

Write(String, Object)

Обеспечивает универсальный способ ведения журнала сложных полезных данных.

Write<T>(String, T)

Write(String, Object)

Исходный код:
DiagnosticSource.cs
Исходный код:
DiagnosticSource.cs
Исходный код:
DiagnosticSource.cs

Обеспечивает универсальный способ ведения журнала сложных полезных данных.

public:
 abstract void Write(System::String ^ name, System::Object ^ value);
public abstract void Write (string name, object? value);
public abstract void Write (string name, object value);
abstract member Write : string * obj -> unit
Public MustOverride Sub Write (name As String, value As Object)

Параметры

name
String

Имя записываемого события.

value
Object

Объект, представляющий значение, которое передается в виде полезных данных для события. Как правило, это анонимный тип, который содержит несколько вложенных значений.

Комментарии

Каждому уведомлению присваивается имя, которое его идентифицирует, а также объект (обычно анонимный тип), предоставляющий произвольные сведения для передачи в уведомление.

name должен быть коротким. Не используйте полное имя, если только не нужно избежать неоднозначности, так как name должно быть глобально уникальным. Как правило, componentName.eventName, где componentName и eventName являются строками менее 10 символов, являются хорошим компромиссом.

Имена уведомлений не должны содержаться . в них, так как имена компонентов содержат точки, и для них обоих, чтобы иметь точки, приводит к неоднозначности. Вместо этого рекомендуется использовать _ .

Предположим, что прослушиватели будут использовать префикс строк для фильтрации групп. Поэтому рекомендуется иметь иерархию имен компонентов.

Применяется к

Write<T>(String, T)

Исходный код:
DiagnosticSource.cs
Исходный код:
DiagnosticSource.cs
public:
generic <typename T>
 void Write(System::String ^ name, T value);
public void Write<T> (string name, T value);
member this.Write : string * 'T -> unit
Public Sub Write(Of T) (name As String, value As T)

Параметры типа

T

Параметры

name
String
value
T

Применяется к