Debug.Assert Metoda

Zdroj:

Debug.cs

Zdroj:

Debug.cs

Zdroj:

Debug.cs

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)

Parametry

Atributy

ConditionalAttribute

Příklady

Následující příklad vytvoří index pro pole, provede nějakou akci k nastavení hodnoty indexu a pak zavolá Assert k potvrzení, že hodnota indexu je platná. Pokud není platný, Assert vypíše zásobník volání.

// Create a local value.
int index;

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

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif

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

Poznámky

Ve výchozím nastavení Debug.Assert metoda funguje pouze v sestaveních ladění. Pokud chcete provádět kontrolní výrazy v buildech vydaných verzí, použijte metodu Trace.Assert . 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 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, které zobrazuje zásobník 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.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Viz také

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Zdroj:

Debug.cs

Zdroj:

Debug.cs

Zdroj:

Debug.cs

public:
 static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message);

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

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler)

Parametry

Atributy

ConditionalAttribute

Poznámky

Toto přetížení bylo zavedeno v .NET 6 za účelem zvýšení výkonu. Ve srovnání s přetíženími, které přebírají String parametr, toto přetížení vyhodnocuje všechny interpolované položky formátování řetězců pouze v případě, že je zpráva vyžadována.

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

Metoda se obvykle používá k identifikaci chyb logiky Assert během vývoje programu. Assert 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, které zobrazuje zásobník 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.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Viz také

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Zdroj:

Debug.cs

Zdroj:

Debug.cs

Zdroj:

Debug.cs

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

Parametry

Atributy

ConditionalAttribute

Příklady

Následující příklad zkontroluje, jestli type je parametr platný. Pokud type je null, Assert vypíše zprávu.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}

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

Poznámky

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

Metoda se obvykle používá k identifikaci chyb logiky Assert během vývoje programu. Assert 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, které zobrazuje zásobník 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.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Viz také

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Zdroj:

Debug.cs

Zdroj:

Debug.cs

Zdroj:

Debug.cs

public:
 static void Assert(bool condition, System::Diagnostics::Debug::AssertInterpolatedStringHandler % message, System::Diagnostics::Debug::AssertInterpolatedStringHandler % detailMessage);

[System.Diagnostics.Conditional("DEBUG")]
public static void Assert (bool condition, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler message, ref System.Diagnostics.Debug.AssertInterpolatedStringHandler detailMessage);

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

Public Shared Sub Assert (condition As Boolean, ByRef message As Debug.AssertInterpolatedStringHandler, ByRef detailMessage As Debug.AssertInterpolatedStringHandler)

Parametry

Atributy

ConditionalAttribute

Poznámky

Toto přetížení bylo zavedeno v .NET 6 za účelem zvýšení výkonu. Ve srovnání s přetíženími, které přebírají String parametr, toto přetížení vyhodnocuje všechny interpolované položky formátování řetězců pouze v případě, že je zpráva požadována.

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

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

Když aplikace běží v režimu uživatelského rozhraní, zobrazí se okno se zprávou, které zobrazuje zásobník 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 Tlačítko Opakovat se odešlete do kódu v ladicím programu, pokud vaše aplikace běží v ladicím programu, nebo se vám nabídne otevření ladicího programu, pokud není. Kliknutím na Ignorovat budete pokračovat dalším pokynem v kódu.

U aplikací .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 kontrolní zprávy nebo nastavit DefaultTraceListener.LogFileName vlastnost . Konfigurační soubor by měl být naformátovaný takto:

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

Viz také

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Zdroj:

Debug.cs

Zdroj:

Debug.cs

Zdroj:

Debug.cs

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

Parametry

Atributy

ConditionalAttribute

Příklady

Následující příklad zkontroluje type , jestli je parametr platný. Pokud type je null, Assert výstupem jsou dvě zprávy.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}

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

Poznámky

Ve výchozím nastavení Debug.Assert funguje metoda pouze v sestaveních ladění. Pokud chcete v buildech Trace.Assert vydaných verzí provádět kontrolní výrazy, použijte metodu . 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 přidáním nebo odebráním TraceListenerListeners do kolekce.

Když aplikace běží v režimu uživatelského rozhraní, zobrazí se okno se zprávou, které zobrazuje zásobník 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 Tlačítko Opakovat se odešlete do kódu v ladicím programu, pokud vaše aplikace běží v ladicím programu, nebo se vám nabídne otevření ladicího programu, pokud není. Kliknutím na Ignorovat budete pokračovat dalším pokynem v kódu.

U aplikací .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 kontrolní zprávy nebo nastavit DefaultTraceListener.LogFileName vlastnost . Konfigurační soubor by měl být naformátovaný takto:

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

Viz také

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• ConditionalAttribute

Zdroj:

Debug.cs

Zdroj:

Debug.cs

Zdroj:

Debug.cs

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

Parametry

Atributy

ConditionalAttribute

Poznámky

Tato metoda používá funkci složeného formátování .NET k převodu hodnoty objektu na jeho textovou reprezentaci a vložení této reprezentace do řetězce. Výsledný řetězec se odešle do Listeners kolekce.

Ve výchozím nastavení Debug.Assert funguje metoda pouze v sestaveních ladění. Pokud chcete v buildech Trace.Assert vydaných verzí provádět kontrolní výrazy, použijte metodu . 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, Object[]) během vývoje programu. Assert vyhodnotí podmínku. Pokud je falsevýsledek , je String.Format(String, Object[]) volána metoda a detailMessageFormat řetězec a args pole jsou předány jako parametry. Assert(Boolean, String, String, Object[]) pak odešle zadanou textovou zprávu a formátovanou textovou zprávu do Listeners kolekce. Toto chování můžete přizpůsobit přidáním nebo odebráním TraceListenerListeners do kolekce.

Když aplikace běží v režimu uživatelského rozhraní, zobrazí se okno se zprávou, které zobrazuje zásobník 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 Tlačítko Opakovat se odešlete do kódu v ladicím programu, pokud vaše aplikace běží v ladicím programu, nebo se vám nabídne otevření ladicího programu, pokud není. Kliknutím na Ignorovat budete pokračovat dalším pokynem v kódu.

U aplikací .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 kontrolní zprávy nebo nastavit DefaultTraceListener.LogFileName vlastnost . Konfigurační soubor by měl být naformátovaný takto:

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