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