Trace.Assert Methode

Definitie

Naamruimte:: System.Diagnostics

Assembly:: System.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Controleert op een voorwaarde; als de voorwaarde is false, voert u berichten uit en geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.

Overloads

Name	Description
Assert(Boolean)	Controleert op een voorwaarde; als de voorwaarde is `false`, geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.
Assert(Boolean, String)	Controleert op een voorwaarde; als de voorwaarde is `false`, voert u een opgegeven bericht uit en geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.
Assert(Boolean, String, String)	Controleert op een voorwaarde; als de voorwaarde is `false`, voert u twee opgegeven berichten uit en geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.

Assert(Boolean)

Controleert op een voorwaarde; als de voorwaarde is false, geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

Parameters

condition: Boolean

De voorwaardelijke expressie die moet worden geëvalueerd. Als de voorwaarde is true, wordt er geen foutbericht verzonden en wordt het berichtvak niet weergegeven.

Kenmerken: ConditionalAttribute

Voorbeelden

In het volgende voorbeeld wordt een index voor een matrix gemaakt. Vervolgens wordt er een actie uitgevoerd waarmee de waarde van de index wordt ingesteld. Vervolgens worden de code aanroepen Assert om te controleren of de indexwaarde geldig is. Als deze niet geldig is, wordt de Assert aanroepstack uitgevoerd.

// Create an index for an array.
int index;

void Method()
{
    // Perform some action that sets the index.

    // Test that the index value is valid.
    Trace.Assert(index > -1);
}

' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

Opmerkingen

Gebruik de Trace.Assert methode als u asserties wilt uitvoeren in release-builds. De Debug.Assert methode werkt alleen in builds voor foutopsporing. Zie Assertions in Managed Code voor meer informatie.

Normaal gesproken wordt de Assert(Boolean) methode gebruikt om logische fouten te identificeren tijdens het ontwikkelen van programma's. Assert(Boolean) evalueert de voorwaarde. Als het resultaat is false, wordt er een foutbericht naar de Listeners verzameling verzonden. U kunt dit gedrag aanpassen door een TraceListener verzameling toe te voegen aan of te verwijderen uit de Listeners verzameling.

Wanneer de toepassing wordt uitgevoerd in de gebruikersinterfacemodus, wordt er een berichtvak weergegeven met de aanroepstack met bestands- en regelnummers. Het berichtvak bevat drie knoppen: Afbreken, Opnieuw proberen en Negeren. Als u op de knop Afbreken klikt, wordt de toepassing beëindigd. Als u op Opnieuw proberen klikt, wordt u naar de code in het foutopsporingsprogramma verzonden als uw toepassing wordt uitgevoerd in een foutopsporingsprogramma of biedt u aan om een foutopsporingsprogramma te openen als dat niet zo is. Als u op Negeren klikt, gaat u verder met de volgende instructie in de code.

Note

De weergave van het berichtvak is afhankelijk van de aanwezigheid van de DefaultTraceListener. Als de DefaultTraceListener verzameling zich niet in de Listeners verzameling bevindt, wordt het berichtvak niet weergegeven. De DefaultTraceListener kan worden verwijderd door de Clear methode op de eigenschap (System.Diagnostics.Trace.Listeners.Clear()) aan te Listeners roepen. Voor .NET Framework-apps kunt u ook de <cleaire> element en de <remove> element in het configuratiebestand van uw app gebruiken.

Voor .NET Framework-apps kunt u het gedrag van de DefaultTraceListener wijzigen in het configuratiebestand dat overeenkomt met de naam van uw toepassing. In dit bestand kunt u het berichtvak assert in- en uitschakelen of de DefaultTraceListener.LogFileName eigenschap instellen. Het configuratiebestand moet als volgt worden opgemaakt:

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Zie ook

Van toepassing op

Assert(Boolean, String)

Controleert op een voorwaarde; als de voorwaarde is false, voert u een opgegeven bericht uit en geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.

public:
 static void Assert(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string message);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String)

Parameters

condition: Boolean

De voorwaardelijke expressie die moet worden geëvalueerd. Als de voorwaarde is true, wordt het opgegeven bericht niet verzonden en wordt het berichtvak niet weergegeven.

message: String

Het bericht dat naar de Listeners verzameling moet worden verzonden.

Kenmerken: ConditionalAttribute

Voorbeelden

In het volgende voorbeeld wordt gecontroleerd of de type parameter geldig is. Als de doorgegeven is typenull, wordt er Assert een bericht uitgevoerd.

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

Opmerkingen

Normaal gesproken wordt de Assert(Boolean, String) methode gebruikt om logische fouten te identificeren tijdens het ontwikkelen van programma's. Assert(Boolean, String) evalueert de voorwaarde. Als het resultaat is false, wordt het opgegeven diagnostische bericht naar de Listeners verzameling verzonden. U kunt dit gedrag aanpassen door een TraceListener verzameling toe te voegen aan of te verwijderen uit de Listeners verzameling.

Note

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Zie ook

Van toepassing op

Assert(Boolean, String, String)

Controleert op een voorwaarde; als de voorwaarde is false, voert u twee opgegeven berichten uit en geeft u een berichtvak weer waarin de aanroepstack wordt weergegeven.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string message, string detailMessage);

[<System.Diagnostics.Conditional("TRACE")>]
static member Assert : bool * string * string -> unit

Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

Parameters

condition: Boolean

De voorwaardelijke expressie die moet worden geëvalueerd. Als de voorwaarde is true, worden de opgegeven berichten niet verzonden en wordt het berichtvak niet weergegeven.

message: String

Het bericht dat naar de Listeners verzameling moet worden verzonden.

detailMessage: String

Het gedetailleerde bericht dat naar de Listeners verzameling moet worden verzonden.

Kenmerken: ConditionalAttribute

Voorbeelden

In het volgende voorbeeld wordt gecontroleerd of de type parameter geldig is. Als de doorgegeven is typenull, wordt er Assert een bericht uitgevoerd.

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null",
       "Can't get object for null type");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null", _
        "Can't get object for null type")

    ' Perform some processing.
End Sub

Opmerkingen

Normaal gesproken wordt de Assert(Boolean, String, String) methode gebruikt om logische fouten te identificeren tijdens het ontwikkelen van programma's. Assert evalueert de voorwaarde. Als het resultaat is false, wordt het opgegeven diagnostische bericht en het gedetailleerde bericht naar de Listeners verzameling verzonden. U kunt dit gedrag aanpassen door een TraceListener verzameling toe te voegen aan of te verwijderen uit de Listeners verzameling.

Note

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?