TraceSwitch Costruttori
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 TraceSwitch.
TraceSwitch(String, String) |
Inizializza una nuova istanza della classe TraceSwitch utilizzando il nome visualizzato e la descrizione specificati. |
TraceSwitch(String, String, String) |
Inizializza una nuova istanza della classe TraceSwitch utilizzando il nome visualizzato, la descrizione e il valore predefinito specificati per l'opzione. |
- Origine:
- TraceSwitch.cs
- Origine:
- TraceSwitch.cs
- Origine:
- TraceSwitch.cs
Inizializza una nuova istanza della classe TraceSwitch utilizzando il nome visualizzato e la descrizione specificati.
public:
TraceSwitch(System::String ^ displayName, System::String ^ description);
public TraceSwitch (string displayName, string? description);
public TraceSwitch (string displayName, string description);
new System.Diagnostics.TraceSwitch : string * string -> System.Diagnostics.TraceSwitch
Public Sub New (displayName As String, description As String)
Parametri
- displayName
- String
Nome da visualizzare in un'interfaccia utente.
- description
- String
Descrizione dell'opzione.
Esempio
Nell'esempio di codice seguente viene creato un nuovo TraceSwitch e viene utilizzata l'opzione per determinare se stampare i messaggi di errore. L'opzione viene creata a livello di classe.
MyMethod
scrive il primo messaggio di errore se la proprietà Level è impostata su TraceLevel.Error o versione successiva. Tuttavia, MyMethod
non scrive il secondo messaggio di errore se il Level è minore di TraceLevel.Verbose.
// Class-level declaration.
/* Create a TraceSwitch to use in the entire application.*/
private:
static TraceSwitch^ mySwitch = gcnew TraceSwitch( "General", "Entire Application" );
public:
static void MyMethod()
{
// Write the message if the TraceSwitch level is set to Error or higher.
if ( mySwitch->TraceError )
Console::WriteLine( "My error message." );
// Write the message if the TraceSwitch level is set to Verbose.
if ( mySwitch->TraceVerbose )
Console::WriteLine( "My second error message." );
}
static void main()
{
// Run the method that prints error messages based on the switch level.
MyMethod();
}
//Class-level declaration.
/* Create a TraceSwitch to use in the entire application.*/
static TraceSwitch mySwitch = new TraceSwitch("General", "Entire Application");
static public void MyMethod()
{
// Write the message if the TraceSwitch level is set to Error or higher.
if (mySwitch.TraceError)
Console.WriteLine("My error message.");
// Write the message if the TraceSwitch level is set to Verbose.
if (mySwitch.TraceVerbose)
Console.WriteLine("My second error message.");
}
public static void Main(string[] args)
{
// Run the method that prints error messages based on the switch level.
MyMethod();
}
' Class-level declaration.
' Create a TraceSwitch to use in the entire application.
Private Shared mySwitch As New TraceSwitch("General", "Entire Application")
Public Shared Sub MyMethod()
' Write the message if the TraceSwitch level is set to Error or higher.
If mySwitch.TraceError Then
Console.WriteLine("My error message.")
End If
' Write the message if the TraceSwitch level is set to Verbose.
If mySwitch.TraceVerbose Then
Console.WriteLine("My second error message.")
End If
End Sub
Public Shared Sub Main()
' Run the method that prints error messages based on the switch level.
MyMethod()
End Sub
Commenti
Per le app .NET Framework, per impostare il livello di TraceSwitch, modificare il file di configurazione corrispondente al nome dell'applicazione. In questo file è possibile aggiungere un'opzione e impostarne il valore, rimuovere un'opzione o cancellare tutte le opzioni impostate in precedenza dall'applicazione. Il file di configurazione deve essere formattato come nell'esempio seguente:
<configuration>
<system.diagnostics>
<switches>
<add name="mySwitch" value="1" />
</switches>
</system.diagnostics>
</configuration>
È anche possibile usare il testo per specificare il valore di un'opzione. Ad esempio, true
per un BooleanSwitch o il testo che rappresenta un valore di enumerazione, ad esempio Error
per un TraceSwitch. L'<add name="mySwitch" value="Error" />
di riga equivale a <add name="mySwitch" value="1" />
.
Nell'applicazione è possibile usare il livello di commutatore configurato creando un TraceSwitch con lo stesso nome, come illustrato nell'esempio seguente:
private:
static TraceSwitch^ appSwitch = gcnew TraceSwitch("mySwitch",
"Switch in config file");
public:
static void Main(array<String^>^ args)
{
//...
Console::WriteLine("Trace switch {0} configured as {1}",
appSwitch->DisplayName, appSwitch->Level.ToString());
if (appSwitch->TraceError)
{
//...
}
}
private static TraceSwitch appSwitch = new TraceSwitch("mySwitch",
"Switch in config file");
public static void Main(string[] args)
{
//...
Console.WriteLine("Trace switch {0} configured as {1}",
appSwitch.DisplayName, appSwitch.Level.ToString());
if (appSwitch.TraceError)
{
//...
}
}
Private Shared appSwitch As new TraceSwitch("mySwitch", _
"Switch in config file")
Public Shared Sub Main(args As String())
'...
Console.WriteLine("Trace switch {0} configured as {1}",
appSwitch.DisplayName, appSwitch.Level.ToString())
If appSwitch.TraceError = True Then
'...
End If
End Sub
Questo costruttore imposta la proprietà Level della nuova opzione su TraceLevel.Off. In alternativa, per le app .NET Framework, le impostazioni del commutatore vengono ottenute dal file di configurazione, se disponibile.
La classe TraceSwitch fornisce le proprietà TraceError, TraceWarning, TraceInfoe TraceVerbose per testare il Level dell'opzione. La proprietà Level ottiene o imposta il TraceLeveldell'opzione.
Nota
Per migliorare le prestazioni, è possibile creare TraceSwitch membri static
nella classe.
Vedi anche
Si applica a
.NET 9 e altre versioni
Prodotto | Versioni |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Origine:
- TraceSwitch.cs
- Origine:
- TraceSwitch.cs
- Origine:
- TraceSwitch.cs
Inizializza una nuova istanza della classe TraceSwitch utilizzando il nome visualizzato, la descrizione e il valore predefinito specificati per l'opzione.
public:
TraceSwitch(System::String ^ displayName, System::String ^ description, System::String ^ defaultSwitchValue);
public TraceSwitch (string displayName, string? description, string defaultSwitchValue);
public TraceSwitch (string displayName, string description, string defaultSwitchValue);
new System.Diagnostics.TraceSwitch : string * string * string -> System.Diagnostics.TraceSwitch
Public Sub New (displayName As String, description As String, defaultSwitchValue As String)
Parametri
- displayName
- String
Nome da visualizzare in un'interfaccia utente.
- description
- String
Descrizione dell'opzione.
- defaultSwitchValue
- String
Valore predefinito dell'opzione.
Commenti
Il parametro displayName
viene utilizzato per impostare il valore della proprietà DisplayName, il parametro description
viene utilizzato per impostare il valore della proprietà Description e il parametro defaultSwitchValue
viene salvato come campo e utilizzato per inizializzare la proprietà Value al primo riferimento. Per altre informazioni e un esempio di codice, vedere il costruttore TraceSwitch(String, String).
Si applica a
.NET 9 e altre versioni
Prodotto | Versioni |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: