DiagnosticSource.Write Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
| Write(String, Object) |
Обеспечивает универсальный способ ведения журнала сложных полезных данных. |
| Write<T>(String, T) |
- Исходный код:
- 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 -> unitPublic MustOverride Sub Write (name As String, value As Object)Параметры
- name
- String
Имя записываемого события.
- value
- Object
Объект, представляющий значение, которое передается в виде полезных данных для события. Как правило, это анонимный тип, который содержит несколько вложенных значений.
Комментарии
Каждому уведомлению присваивается имя, которое его идентифицирует, а также объект (обычно анонимный тип), предоставляющий произвольные сведения для передачи в уведомление.
name должен быть коротким. Не используйте полное имя, если только не нужно избежать неоднозначности, так как name должно быть глобально уникальным. Как правило, componentName.eventName, где componentName и eventName являются строками менее 10 символов, являются хорошим компромиссом.
Имена уведомлений не должны содержаться . в них, так как имена компонентов содержат точки, и для них обоих, чтобы иметь точки, приводит к неоднозначности. Вместо этого рекомендуется использовать _ .
Предположим, что прослушиватели будут использовать префикс строк для фильтрации групп. Поэтому рекомендуется иметь иерархию имен компонентов.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
- Исходный код:
- 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 -> unitPublic Sub Write(Of T) (name As String, value As T)Параметры типа
- T
Параметры
- name
- String
- value
- T
Применяется к
.NET 9 и .NET 8
| Продукт | Версии |
|---|---|
| .NET | 8, 9 |
