DiagnosticSource.Write(String, Object) Método

Definición

Proporciona una manera genérica de registrar cargas complejas.Provides a generic way of logging complex payloads.

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

Nombre del evento que se va a escribir.The name of the event being written.

value
Object

Objeto que representa el valor que se va a pasar como una carga para el evento.An object that represents the value being passed as a payload for the event. Suele ser un tipo anónimo que contiene varios subvalores.This is often an anonymous type which contains several sub-values.

Comentarios

A cada notificación se le asigna un nombre que la identifica, así como un objeto (normalmente un tipo anónimo) que proporciona información arbitraria para pasar a la notificación.Each notification is given a name that identifies it, as well as an object (typically an anonymous type) that provides arbitrary information to pass to the notification.

name debe ser breve.name should be short. No use un nombre completo a menos que tenga que evitar la ambigüedad, ya que name debe ser único globalmente.Don't use a fully qualified name unless you have to to avoid ambiguity, since name must be globally unique. Normalmente, componentName. eventName, donde componentName y eventName son cadenas de menos de 10 caracteres, son un buen compromiso.Typically, componentName.eventName, where componentName and eventName are strings less than 10 characters, are a good compromise.

Los nombres de notificación no deberían tener . en ellos porque los nombres de componente tienen puntos, y para que ambos tengan puntos, la ambigüedad.Notification names should not have . in them because component names have dots, and for them both to have dots leads to ambiguity. Se recomienda usar _ en su lugar.We suggest that you use _ instead.

Supongamos que los agentes de escucha usarán el prefijo de cadena para filtrar grupos.Assume that listeners will use string prefixing to filter groups. Por lo tanto, es recomendable tener una jerarquía de nombres de componentes.Therefore, having a hierarchy of component names is a good practice.

Se aplica a