Trace.Assert Metoda

Reference

Definice

Obor názvů:: System.Diagnostics

Sestavení:: System.Diagnostics.TraceSource.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Kontroluje podmínku; pokud je falsepodmínka , vypíše zprávy a zobrazí okno se zprávou, které zobrazuje zásobník volání.

Přetížení

Assert(Boolean)	Kontroluje podmínku; Pokud je `false`podmínka , zobrazí okno se zprávou, které zobrazuje zásobník volání.
Assert(Boolean, String)	Kontroluje podmínku; Pokud je `false`podmínka , vypíše zadanou zprávu a zobrazí okno se zprávou, ve které se zobrazí zásobník volání.
Assert(Boolean, String, String)	Kontroluje podmínku; Pokud je `false`podmínka , zobrazí se dvě zadané zprávy a zobrazí se okno se zprávou, které zobrazuje zásobník volání.

Assert(Boolean)

Zdroj:: Trace.cs

Zdroj:: Trace.cs

Zdroj:: Trace.cs

Kontroluje podmínku; Pokud je falsepodmínka , zobrazí okno se zprávou, které zobrazuje zásobník volání.

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)

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , zpráva o selhání se neodesíla a okno se zprávou se nezobrazí.

Atributy: ConditionalAttribute

Příklady

Následující příklad vytvoří index pro pole. Pak se provede nějaká akce, která nastaví hodnotu indexu. Dále volá Assert kód, který ověří, že hodnota indexu je platná. Pokud není platný, Assert výstup zásobník volání.

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

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }

// 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

Poznámky

Pokud chcete provádět kontrolní výrazy v buildech vydaných verzí, použijte metodu Trace.Assert . Metoda Debug.Assert funguje pouze v sestaveních ladění. Další informace najdete v tématu Kontrolní výrazy ve spravovaném kódu.

Metoda se obvykle používá k identifikaci chyb logiky Assert(Boolean) během vývoje programu. Assert(Boolean) vyhodnotí podmínku. Pokud je falsevýsledek , odešle do kolekce zprávu Listeners o selhání. Toto chování můžete přizpůsobit přidáním nebo odebráním TraceListener Listeners kolekce.

Když aplikace běží v režimu uživatelského rozhraní, zobrazí se okno se zprávou se zásobníkem volání s čísly souborů a řádků. Okno se zprávou obsahuje tři tlačítka: Přerušit, Opakovat a Ignorovat. Kliknutím na tlačítko Přerušit aplikaci ukončíte. Kliknutím na Opakovat se odešlete do kódu v ladicím programu, pokud je vaše aplikace spuštěná v ladicím programu, nebo se nabídne otevření ladicího programu, pokud není. Kliknutím na Ignorovat pokračujte další instrukcí v kódu.

Poznámka

Zobrazení okna se zprávou závisí na přítomnosti DefaultTraceListenersouboru . Pokud objekt DefaultTraceListener není v kolekci Listeners , nezobrazí se okno se zprávou. Objekt DefaultTraceListener lze odebrat voláním Clear metody ve Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()). U aplikací .NET Framework můžete také použít <element clear> a <element remove> v konfiguračním souboru vaší aplikace.

U aplikací rozhraní .NET Framework můžete změnit chování objektu DefaultTraceListener v konfiguračním souboru, které odpovídá názvu vaší aplikace. V tomto souboru můžete povolit a zakázat okno assert zprávy nebo nastavit DefaultTraceListener.LogFileName vlastnost. Konfigurační soubor by měl být naformátovaný takto:

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

Viz také

Platí pro

Assert(Boolean, String)

Zdroj:: Trace.cs

Zdroj:: Trace.cs

Zdroj:: Trace.cs

Kontroluje podmínku; Pokud je falsepodmínka , vypíše zadanou zprávu a zobrazí okno se zprávou, ve které se zobrazí zásobník volání.

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")]
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)

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , zadaná zpráva se neodesíla a okno se zprávou se nezobrazí.

message: String

Zpráva, která se má odeslat do Listeners kolekce.

Atributy: ConditionalAttribute

Příklady

Následující příklad zkontroluje, jestli type je parametr platný. Pokud je typenullpředaný parametr , Assert vypíše se zpráva.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }

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

Poznámky

Metoda se obvykle používá k identifikaci chyb logiky Assert(Boolean, String) během vývoje programu. Assert(Boolean, String) vyhodnotí podmínku. Pokud je falsevýsledek , odešle do kolekce zadanou diagnostickou zprávu Listeners . Toto chování můžete přizpůsobit přidáním nebo odebráním TraceListener Listeners kolekce.

Poznámka

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

Viz také

Platí pro

Assert(Boolean, String, String)

Zdroj:: Trace.cs

Zdroj:: Trace.cs

Zdroj:: Trace.cs

Kontroluje podmínku; Pokud je falsepodmínka , zobrazí se dvě zadané zprávy a zobrazí se okno se zprávou, které zobrazuje zásobník volání.

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")]
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)

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , zadané zprávy se neodesílají a nezobrazí se okno se zprávou.

message: String

Zpráva, která se má odeslat do Listeners kolekce.

detailMessage: String

Podrobná zpráva, která se má odeslat do Listeners kolekce.

Atributy: ConditionalAttribute

Příklady

Následující příklad zkontroluje, jestli type je parametr platný. Pokud je typenullpředaný parametr , Assert vypíše se zpráva.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }

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

Poznámky

Metoda se obvykle používá k identifikaci chyb logiky Assert(Boolean, String, String) během vývoje programu. Assert vyhodnotí podmínku. Pokud je falsevýsledek , odešle do kolekce zadanou diagnostickou zprávu a podrobnou Listeners zprávu. Toto chování můžete přizpůsobit přidáním nebo odebráním TraceListener Listeners kolekce.

Poznámka

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

Viz také

Platí pro

Trace.Assert Metoda

Definice

Přetížení

Assert(Boolean)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Assert(Boolean, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Assert(Boolean, String, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Váš názor

Další materiály