TraceContext.IsEnabled Proprietà
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.
Ottiene o imposta un valore che indica se la traccia è abilitata per la richiesta Web corrente.
public:
property bool IsEnabled { bool get(); void set(bool value); };
public bool IsEnabled { get; set; }
member this.IsEnabled : bool with get, set
Public Property IsEnabled As Boolean
Valore della proprietà
true se la traccia è abilitata; in caso contrario, false.
Esempio
Nell'esempio di codice seguente viene illustrato come determinare se la traccia è abilitata per una pagina. Il codice scorre le righe di un set di dati, scrivendo istruzioni di traccia per ogni riga del set di dati.
if (Context.IsEnabled) {
for (int i=0; i<DS.Tables["Categories"].Rows.Count; i++) {
Trace.Write("ProductCategory", DS.Tables["Categories"].Rows[i][0].ToString());
}
}
If (Context.IsEnabled)
Dim I As Integer
For I = 0 To DS.Tables("Categories").Rows.Count - 1
Trace.Write("ProductCategory",DS.Tables("Categories").Rows(I)(0).ToString())
Next
End If
Commenti
Usare questo flag per verificare se la pagina o l'applicazione devono restituire informazioni di traccia prima di scrivere elementi nel log di traccia.
Il valore della IsEnabled proprietà dipende dalle impostazioni nella trace sottosezione della sezione di system.web configurazione e dal valore dell'attributo trace della @ Page direttiva. L'opzione di traccia impostata nella direttiva page ha la precedenza sull'opzione impostata nel file di configurazione. L'impostazione del valore a livello di codice ha la IsEnabled precedenza sull'attributo della direttiva di pagina e sull'impostazione di configurazione.
Annotazioni
Se si imposta la IsEnabled proprietà su true per un'intera applicazione, è necessario impostare in modo esplicito questa proprietà su false per qualsiasi pagina dell'applicazione per cui non si desidera visualizzare le informazioni di traccia.