Debug.Assert Methode

Definitie

Naamruimte:: System.Diagnostics

Assembly's:: System.dll, System.Diagnostics.Debug.dll

Assembly:: System.dll

Assembly:: System.Diagnostics.Debug.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, String, String, Object[])	Controleert op een voorwaarde; als de voorwaarde is `false`, worden twee berichten uitgevoerd (eenvoudig en opgemaakt) en wordt een berichtvak weergegeven 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("DEBUG")]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
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 maakt u een index voor een matrix, voert u een actie uit om de waarde van de index in te stellen en roept u vervolgens Assert aan om te bevestigen dat de indexwaarde geldig is. Als deze niet geldig is, Assert wordt de aanroepstack uitgevoerd.

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

// Perform some action that sets the index.
index = -40;

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

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

' Perform some action that sets the index.
index = -40

' Test that the index value is valid. 
Debug.Assert((index > - 1))

Opmerkingen

De methode werkt standaard Debug.Assert alleen in builds voor foutopsporing. Gebruik de Trace.Assert methode als u asserties wilt uitvoeren in release-builds. 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 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 berichtvenster 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

Windows 8.x-apps bieden geen ondersteuning voor modale dialoogvensters, zodat ze hetzelfde werken in de gebruikersinterfacemodus en niet-gebruikersinterfacemodus. Het bericht wordt geschreven naar de actieve tracelisteners in de foutopsporingsmodus of er wordt geen bericht geschreven in de releasemodus.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </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("DEBUG")]
public static void Assert(bool condition, string message);

[<System.Diagnostics.Conditional("DEBUG")>]
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 type dat het is null, Assert wordt een bericht uitgevoerd.

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

    // Perform some processing.
}

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

Opmerkingen

Normaal gesproken wordt de Assert 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 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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </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("DEBUG")]
public static void Assert(bool condition, string message, string detailMessage);

[<System.Diagnostics.Conditional("DEBUG")>]
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 type dat het is null, Assert voert u twee berichten uit.

public static void MyMethod(Type type, Type baseType)
{
    Debug.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)
    Debug.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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Zie ook

Van toepassing op

Assert(Boolean, String, String, Object[])

Controleert op een voorwaarde; als de voorwaarde is false, worden twee berichten uitgevoerd (eenvoudig en opgemaakt) en wordt een berichtvak weergegeven waarin de aanroepstack wordt weergegeven.

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessageFormat, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert(bool condition, string message, string detailMessageFormat, params object[] args);

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

Public Shared Sub Assert (condition As Boolean, message As String, detailMessageFormat As String, ParamArray args As Object())

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.

detailMessageFormat: String

De tekenreeks voor samengestelde indeling die naar de Listeners verzameling moet worden verzonden. Dit bericht bevat tekst die is gemengd met nul of meer opmaakitems, die overeenkomen met objecten in de args matrix.

args: Object[]

Een objectmatrix die nul of meer objecten bevat die moeten worden opgemaakt.

Kenmerken: ConditionalAttribute

Opmerkingen

Deze methode maakt gebruik van de functie .NET samengestelde opmaak om de waarde van een object te converteren naar de tekstweergave en die weergave in te sluiten in een tekenreeks. De resulterende tekenreeks wordt verzonden naar de Listeners verzameling.

Normaal gesproken wordt de Assert(Boolean, String, String, Object[]) methode gebruikt om logische fouten te identificeren tijdens het ontwikkelen van programma's. Assert evalueert de voorwaarde. Als het resultaat is false, wordt de String.Format(String, Object[]) methode aangeroepen en worden de detailMessageFormat tekenreeks en args matrix als parameters doorgegeven. Assert(Boolean, String, String, Object[]) verzendt vervolgens het opgegeven tekstbericht en het opgemaakte tekstbericht naar de Listeners verzameling. U kunt dit gedrag aanpassen door een TraceListener verzameling toe te voegen aan of te verwijderen uit de Listeners verzameling.

Note

<configuration>
  <system.diagnostics>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Van toepassing op

Feedback

Is deze pagina nuttig?