Debug.Assert Metoda

Reference

Definice

Obor názvů:: System.Diagnostics

Sestavení:: System.Diagnostics.Debug.dll

Sestavení:: System.Runtime.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 se zásobníkem 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, Debug+AssertInterpolatedStringHandler)	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)	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, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	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 se zásobníkem volání.
Assert(Boolean, String, String, Object[])	Kontroluje podmínku; Pokud je `false`podmínka , vypíše dvě zprávy (jednoduché a formátované) a zobrazí okno se zprávou, které zobrazuje zásobník volání.

Assert(Boolean)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.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("DEBUG")]
public static void Assert (bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
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, 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.

Poznámka

aplikace Windows 8.x nepodporují modální dialogová okna, takže se chovají stejně v režimu uživatelského rozhraní i v režimu jiného než uživatelského rozhraní. Zpráva se zapisuje do aktivních naslouchacích procesů trasování v režimu ladění nebo se v režimu vydání nezapíše žádná zpráva.

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

Viz také

Platí pro

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.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::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

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: Debug.AssertInterpolatedStringHandler

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

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.

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 .

Poznámka

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

Viz také

Platí pro

Assert(Boolean, String)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.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("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

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

Poznámka

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

Viz také

Platí pro

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; Pokud je falsepodmínka , výstupem je zadaná zpráva a zobrazí se okno se zprávou se zásobníkem volání.

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

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: Debug.AssertInterpolatedStringHandler

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

detailMessage: Debug.AssertInterpolatedStringHandler

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

Atributy: ConditionalAttribute

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 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 TraceListener Listeners 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.

Poznámka

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

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é

Platí pro

Assert(Boolean, String, String)

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; Pokud je falsepodmínka , výstup dvě zadané zprávy a zobrazí 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("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

condition: Boolean

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

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

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

Poznámka

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

Viz také

Platí pro

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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; Pokud je falsepodmínka , výstup dvě zprávy (jednoduché a formátované) a zobrazí okno se zprávou, které zobrazuje zásobník volání.

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

condition: Boolean

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

message: String

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

detailMessageFormat: String

Řetězec složeného formátu, který se má odeslat do Listeners kolekce. Tato zpráva obsahuje text ve vzájemném propojení s nulovým nebo více položkami formátu, které odpovídají objektům args v poli.

args: Object[]

Pole objektu, které obsahuje objekty k formátování. Pole nemusí obsahovat žádný objekt.

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.

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 TraceListener Listeners 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.

Poznámka

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

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

Platí pro

Sdílet prostřednictvím

Debug.Assert Metoda

Definice

Přetížení

Assert(Boolean)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parametry

Poznámky

Viz také

Platí pro

Assert(Boolean, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)

Parametry

Poznámky

Viz také

Platí pro

Assert(Boolean, String, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Poznámky

Platí pro

Další materiály