Sdílet prostřednictvím


Trace.Assert Metoda

Definice

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 falsepodmínka , zobrazí okno se zprávou, které zobrazuje zásobník volání.

Assert(Boolean, String)

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í.

Assert(Boolean, String, String)

Kontroluje podmínku; Pokud je falsepodmínka , zobrazí se dvě zadané zprávy a zobrazí se okno se zprávou se zásobníkem 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

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 tak, že do kolekce přidáte TraceListener nebo ho z kolekce odeberete Listeners .

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 nabídnete otevření ladicího programu, pokud tomu tak 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

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

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, 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 tak, že do kolekce přidáte TraceListener nebo ho z kolekce odeberete Listeners .

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 nabídnete otevření ladicího programu, pokud tomu tak 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, 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 se zásobníkem 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

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

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, 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 tak, že do kolekce přidáte TraceListener nebo ho z kolekce odeberete Listeners .

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 nabídnete otevření ladicího programu, pokud tomu tak 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