Freigeben über


TraceContext.IsEnabled-Eigenschaft

Ruft ein Wert ab, der angibt, ob die Ablaufverfolgung für die aktuelle Webanforderung aktiviert ist, oder legt diesen fest.

Namespace: System.Web
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Property IsEnabled As Boolean
'Usage
Dim instance As TraceContext
Dim value As Boolean

value = instance.IsEnabled

instance.IsEnabled = value
public bool IsEnabled { get; set; }
public:
property bool IsEnabled {
    bool get ();
    void set (bool value);
}
/** @property */
public boolean get_IsEnabled ()

/** @property */
public void set_IsEnabled (boolean value)
public function get IsEnabled () : boolean

public function set IsEnabled (value : boolean)

Eigenschaftenwert

true, wenn die Ablaufverfolgung aktiviert ist, andernfalls false.

Hinweise

Verwenden Sie dieses Flag für die Überprüfung, ob die Seite oder Anwendung Ablaufverfolgungsinformationen ausgeben soll, bevor in das Ablaufverfolgungsprotokoll geschrieben wird.

Der Wert der IsEnabled-Eigenschaft ist von den Einstellungen im trace-Unterabschnitt des system.web-Konfigurationsabschnitts und dem Wert des trace-Attributs der @ Page-Direktive abhängig. Die in der Seitendirektive festgelegten Ablaufverfolgungsoptionen haben Vorrang vor den Optionen in der Konfigurationsdatei. Ein programmgesteuert festgelegter IsEnabled-Wert hat Vorrang gegenüber dem Attribut der Seitendirektive und der Konfigurationseinstellung.

Hinweis

Wenn Sie die IsEnabled-Eigenschaft für eine gesamte Anwendung auf true festlegen, müssen Sie diese Eigenschaft für jede Seite der Anwendung, für die keine Ablaufverfolgungsinformationen angezeigt werden sollen, ausdrücklich auf false festlegen.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie bestimmen, ob die Ablaufverfolgung für eine Seite aktiviert ist. Der Code durchläuft die Zeilen in einem Dataset und schreibt Ablaufverfolgungsanweisungen für jede Zeile in das Dataset.

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
   
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.get_IsEnabled()) {
    for(int i=0;i<ds.get_Tables().get_Item("Categories").
            get_Rows().get_Count();i++) {
        Trace.Write("ProductCategory",
        ds.get_Tables().get_Item("Categories").
        get_Rows().get_Item(i).get_Item(0).ToString());
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TraceContext-Klasse
TraceContext-Member
System.Web-Namespace

Weitere Ressourcen

ASP.NET-Ablaufverfolgung
@ Page
<trace>-Element