Partilhar via


DiagnosticSource.Write Método

Definição

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
Origem:
DiagnosticSource.cs
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);
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.

Aplica-se a

Write<T>(String, T)

Origem:
DiagnosticSource.cs
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

Aplica-se a