DiagnosticSource.Write(String, Object) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapewnia ogólny sposób rejestrowania złożonych ładunków.
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)Parametry
- name
- String
Nazwa zapisywanego zdarzenia.
- value
- Object
Obiekt reprezentujący wartość przekazywaną jako ładunek zdarzenia. Jest to często anonimowy typ, który zawiera kilka podwartych wartości.
Uwagi
Każde powiadomienie ma nazwę, która ją identyfikuje, a także obiekt (zazwyczaj typ anonimowy), który udostępnia dowolne informacje, które mają być przekazywane do powiadomienia.
name powinna być krótka. Nie używaj w pełni kwalifikowanej nazwy, chyba że musisz uniknąć niejednoznaczności, ponieważ name musi być globalnie unikatowa. Zazwyczaj componentName.eventName, gdzie componentName i eventName są ciągami mniejszymi niż 10 znaków, są dobrym kompromisem.
Nazwy powiadomień nie powinny znajdować . się w nich, ponieważ nazwy składników mają kropki, a oba te nazwy mają kropki, co prowadzi do niejednoznaczności. Zalecamy zamiast tego użycie _ .
Załóżmy, że odbiorniki będą używać prefiksów ciągów do filtrowania grup. Dlatego posiadanie hierarchii nazw składników jest dobrym rozwiązaniem.