Debug.Assert Metoda

Definice

Obor názvů:: System.Diagnostics

Sestavení:: System.dll, System.Diagnostics.Debug.dll

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Diagnostics.Debug.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 zobrazující zásobník volání.

Přetížení

Name	Description
Assert(Boolean)	Kontroluje podmínku; pokud je `false`podmínka , zobrazí okno se zprávou, ve které se zobrazuje zásobník volání.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Kontroluje podmínku; pokud je `false`podmínka , zobrazí zadanou zprávu a zobrazí okno se zprávou, která zobrazuje zásobník volání.
Assert(Boolean, String)	Kontroluje podmínku; pokud je `false`podmínka , zobrazí zadanou zprávu a zobrazí okno se zprávou, která zobrazuje zásobník volání.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Kontroluje podmínku; pokud je `false`podmínka , zobrazí zadanou zprávu a zobrazí okno se zprávou, která zobrazuje zásobník volání.
Assert(Boolean, String, String)	Kontroluje podmínku; pokud je `false`podmínka , zobrazí dva zadané zprávy a zobrazí okno se zprávou, která zobrazuje zásobník 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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; pokud je falsepodmínka , zobrazí okno se zprávou, ve které se 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")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

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

[<System.Diagnostics.Conditional("DEBUG")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
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ílají a okno se zprávou se nezobrazí.

Atributy: ConditionalAttribute OverloadResolutionPriorityAttribute

Příklady

Následující příklad vytvoří index pro pole, provede nějakou akci, která nastaví hodnotu indexu a potom zavolá Assert , aby se ověřilo, že hodnota indexu je platná. Pokud není platný, Assert vypíše zásobník volání.

// 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í funguje Debug.Assert metoda pouze v buildech ladění. Tuto metodu Trace.Assert použijte, pokud chcete provádět kontrolní výrazy v buildech vydaných verzí. Další informace naleznete v tématu Kontrolní výrazy ve spravovaném kódu.

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

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

Poznámka:

Aplikace pro Windows 8.x nepodporují modální dialogová okna, takže se chovají stejně v režimu uživatelského rozhraní a bez uživatelského rozhraní. Zpráva se zapíše do aktivních naslouchacích procesů trasování v režimu ladění nebo se v režimu vydání nezapisuje žádná zpráva.

Poznámka:

Zobrazení pole zprávy závisí na přítomnosti DefaultTraceListener. Pokud v kolekci DefaultTraceListener není Listeners , pole se zprávou se nezobrazí. Lze DefaultTraceListener odebrat voláním Clear metody ve Listeners vlastnosti (System.Diagnostics.Trace.Listeners.Clear()). Pro aplikace .NET Framework můžete také použít <jasný> prvek a <element remove> v konfiguračním souboru vaší aplikace.

U aplikací rozhraní .NET Framework můžete změnit chování konfiguračního DefaultTraceListener souboru, který odpovídá názvu aplikace. V tomto souboru můžete povolit a zakázat pole zprávy assert nebo nastavit DefaultTraceListener.LogFileName vlastnost. Konfigurační soubor by měl být formá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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; pokud je falsepodmínka , zobrazí zadanou zprávu a zobrazí okno se zprávou, která zobrazuje 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ílají a pole 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 pouze všechny interpolované položky formátování řetězců, pokud je zpráva povinná.

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

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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; pokud je falsepodmínka , zobrazí zadanou zprávu a zobrazí okno se zprávou, která zobrazuje 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 = default);

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

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

Parametry

condition: Boolean

Podmíněný výraz, který se má vyhodnotit. Pokud je truepodmínka , zadaná zpráva se neodesílají a pole 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, zda type je parametr platný. Pokud type je, Assertnullvypíše zprávu.

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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; pokud je falsepodmínka , zobrazí zadanou zprávu a zobrazí okno se zprávou, která zobrazuje zásobník 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ílají a pole 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

Poznámka:

<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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; pokud je falsepodmínka , zobrazí dva 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 pole zprávy 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, zda type je parametr platný. Pokud type je , Assertnullvýstupem jsou dvě zprávy.

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

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

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

Zdroj:: Debug.cs

Zdroj:: Debug.cs

Kontroluje podmínku; pokud je falsepodmínka , vypíše 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 pole zprávy se nezobrazí.

message: String

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

detailMessageFormat: String

Složený formátovací řetězec, který se má odeslat do Listeners kolekce. Tato zpráva obsahuje text intermixovaný s nulovou nebo více formátovacími položkami, které odpovídají objektům args v poli.

args: Object[]

Pole objektů, které obsahuje nula nebo více objektů pro formátování.

Atributy: ConditionalAttribute

Poznámky

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

Assert(Boolean, String, String, Object[]) Metoda se obvykle používá k identifikaci chyb logiky během vývoje programu. Assert vyhodnotí podmínku. Pokud je falsevýsledkem , String.Format(String, Object[]) Metoda je volána 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 TraceListener kolekce nebo odebráním této Listeners kolekce.

Poznámka:

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

Platí pro

Váš názor

Byla tato stránka užitečná?

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

Váš názor