TraceSource Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe TraceSource.
Overload
| Nome | Descrizione |
|---|---|
| TraceSource(String) |
Inizializza una nuova istanza della TraceSource classe utilizzando il nome specificato per l'origine. |
| TraceSource(String, SourceLevels) |
Inizializza una nuova istanza della TraceSource classe utilizzando il nome specificato per l'origine e il livello di origine predefinito in cui deve verificarsi la traccia. |
TraceSource(String)
Inizializza una nuova istanza della TraceSource classe utilizzando il nome specificato per l'origine.
public:
TraceSource(System::String ^ name);public TraceSource(string name);new System.Diagnostics.TraceSource : string -> System.Diagnostics.TraceSourcePublic Sub New (name As String)Parametri
- name
- String
Nome dell'origine (in genere, nome dell'applicazione).
Eccezioni
name è null.
name è una stringa vuota ("").
Esempio
Nell'esempio di codice seguente viene illustrato l'uso del TraceSource costruttore per creare un nuovo TraceSource oggetto . Questo esempio di codice fa parte di un esempio più ampio fornito per la TraceSource classe .
// Initialize the trace source.
static TraceSource ts = new TraceSource("TraceTest");
' Initialize the trace source.
Private Shared ts As New TraceSource("TraceTest")
Commenti
Il nome dell'origine viene usato per identificare le tracce. Viene utilizzato da un oggetto SourceFilter per determinare se un listener di traccia deve produrre la traccia. La procedura consigliata consiste nell'usare il nome dell'applicazione per il nome di origine.
Annotazioni
Non è necessario creare una nuova TraceSource istanza per ogni richiesta di traccia. Creare un'istanza TraceSource e usarla per tutte le richieste di traccia per l'applicazione.
Si applica a
TraceSource(String, SourceLevels)
Inizializza una nuova istanza della TraceSource classe utilizzando il nome specificato per l'origine e il livello di origine predefinito in cui deve verificarsi la traccia.
public:
TraceSource(System::String ^ name, System::Diagnostics::SourceLevels defaultLevel);public TraceSource(string name, System.Diagnostics.SourceLevels defaultLevel);new System.Diagnostics.TraceSource : string * System.Diagnostics.SourceLevels -> System.Diagnostics.TraceSourcePublic Sub New (name As String, defaultLevel As SourceLevels)Parametri
- name
- String
Nome dell'origine, in genere il nome dell'applicazione.
- defaultLevel
- SourceLevels
Combinazione bit per bit dei valori di enumerazione che specifica il livello di origine predefinito in corrispondenza del quale tracciare.
Eccezioni
name è null.
name è una stringa vuota ("").
Commenti
Il nome dell'origine viene usato per identificare le tracce. Può essere utilizzato da un SourceSwitch oggetto per determinare se la traccia deve verificarsi e da un SourceFilter oggetto per determinare se produrre la traccia. Il livello di origine predefinito viene utilizzato da un oggetto EventTypeFilter per determinare se la traccia deve verificarsi in base al livello di origine del messaggio da tracciare.
Annotazioni
Non è necessario creare una nuova TraceSource istanza per ogni richiesta di traccia. Creare un'istanza TraceSource e usarla per tutte le richieste di traccia per l'applicazione.