TraceSource.TraceData Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skriver spårningsdata till spårningslyssnare Listeners i samlingen.
Överlagringar
| Name | Description |
|---|---|
| TraceData(TraceEventType, Int32, Object) |
Skriver spårningsdata till spårningslyssnare Listeners i samlingen med den angivna händelsetypen, händelseidentifieraren och spårningsdata. |
| TraceData(TraceEventType, Int32, Object[]) |
Skriver spårningsdata till spårningslyssnare Listeners i samlingen med den angivna händelsetypen, händelseidentifieraren och spårningsdatamatrisen. |
TraceData(TraceEventType, Int32, Object)
Skriver spårningsdata till spårningslyssnare Listeners i samlingen med den angivna händelsetypen, händelseidentifieraren och spårningsdata.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData(System.Diagnostics.TraceEventType eventType, int id, object data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)Parametrar
- eventType
- TraceEventType
Ett av uppräkningsvärdena som anger händelsetypen för spårningsdata.
- id
- Int32
En numerisk identifierare för händelsen.
- data
- Object
Spårningsdata.
- Attribut
Undantag
Ett försök gjordes att spåra en händelse under slutförande.
Exempel
I följande kodexempel visas hur metoden används TraceData(TraceEventType, Int32, Object) för att filtrera och vidarebefordra ett spårningsmeddelande till lyssnarna. Det här kodexemplet är en del av ett större exempel för TraceSource klassen.
// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
"SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
"SourceFilter should let this message through on the console trace listener.");
' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")
Kommentarer
Metoden TraceData är, precis som TraceEvent metoden, avsedd för automatiserade verktyg, men tillåter även att ytterligare ett objekt, till exempel en undantagsinstans, kopplas till spårningen.
Metoden TraceData anropar metoden för SourceSwitch.ShouldTrace objektet som SourceSwitch returneras av egenskapen Switch . Om ShouldTrace returnerar TraceDatatrueanropar motsvarande TraceData metod på alla lyssnare. Annars TraceData returneras utan att anropa lyssnarnas metoder.
Note
Objektet EventLogTraceListener är begränsat till ett maximalt id värde på 65 535. Om det id angivna värdet är större än 65 535 använder EventLogTraceListener objektet 65 535.
Gäller för
TraceData(TraceEventType, Int32, Object[])
Skriver spårningsdata till spårningslyssnare Listeners i samlingen med den angivna händelsetypen, händelseidentifieraren och spårningsdatamatrisen.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData(System.Diagnostics.TraceEventType eventType, int id, params object[] data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())Parametrar
- eventType
- TraceEventType
Ett av uppräkningsvärdena som anger händelsetypen för spårningsdata.
- id
- Int32
En numerisk identifierare för händelsen.
- data
- Object[]
En objektmatris som innehåller spårningsdata.
- Attribut
Undantag
Ett försök gjordes att spåra en händelse under slutförande.
Kommentarer
Metoden TraceData är, precis som TraceEvent metoden, avsedd för automatiserade verktyg, men tillåter även att ytterligare objekt, till exempel en undantagsinstans och en stackspårning, kan kopplas till spårningen.
Metoden TraceData anropar metoden för ShouldTrace objektet som SourceSwitch returneras av egenskapen Switch . Om ShouldTrace returnerar TraceDatatrueanropar motsvarande TraceData metod på alla lyssnare. Annars TraceData returneras utan att anropa lyssnarnas metoder.
Note
Objektet EventLogTraceListener är begränsat till ett maximalt id värde på 65 535. Om det id angivna värdet är större än 65 535 använder EventLogTraceListener objektet 65 535.