DiagnosticSource.Write Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Sobrecargas

Write(String, Object)	Fornece uma maneira genérica de registro em log de conteúdos complexos.
Write<T>(String, T)

Write(String, Object)

Origem:

DiagnosticSource.cs

Fornece uma maneira genérica de registro em log de conteúdos complexos.

public:
 abstract void Write(System::String ^ name, System::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)

Parâmetros

name

String

O nome do evento que está sendo gravado.

value

Object

Um objeto que representa o valor sendo passado como um conteúdo para o evento. Isso geralmente é um tipo anônimo que contém vários valores inferiores.

Comentários

Cada notificação recebe um nome que a identifica, bem como um objeto (normalmente um tipo anônimo) que fornece informações arbitrárias a serem passadas para a notificação.

name deve ser curto. Não use um nome totalmente qualificado, a menos que você precise evitar ambiguidade, pois name deve ser globalmente exclusivo. Normalmente, componentName.eventName, em que componentName e eventName são cadeias de caracteres com menos de 10 caracteres, são um bom comprometimento.

Os nomes de notificação não devem ter . neles porque os nomes dos componentes têm ponto e, para ambos, ter os ponto leva à ambiguidade. Sugerimos que você use _ em vez disso.

Suponha que os ouvintes usarão o prefixo de cadeia de caracteres para filtrar grupos. Portanto, ter uma hierarquia de nomes de componentes é uma boa prática.

Write<T>(String, T)

Origem:

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)

Parâmetros de tipo

T

Parâmetros

name

String

value

T