Debug.Assert Metódus

Definíció

Névtér:: System.Diagnostics

Szerelvények:: System.dll, System.Diagnostics.Debug.dll

Szerelvények:: netstandard.dll, System.Runtime.dll

Szerelvény:: System.Diagnostics.Debug.dll

Szerelvény:: System.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Feltétel ellenőrzése; ha a feltétel az false, üzeneteket ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.

Túlterhelések

Name	Description
Assert(Boolean)	Feltétel ellenőrzése; ha a feltétel az `false`, megjelenik egy üzenetmező, amely a hívás vermet jeleníti meg.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Feltétel ellenőrzése; ha a feltétel az `false`, egy megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.
Assert(Boolean, String)	Feltétel ellenőrzése; ha a feltétel az `false`, egy megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Feltétel ellenőrzése; ha a feltétel az `false`, egy megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.
Assert(Boolean, String, String)	Feltétel ellenőrzése; ha a feltétel az `false`, két megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívásvermet.
Assert(Boolean, String, String, Object[])	Feltétel ellenőrzése; ha a feltétel az `false`, két üzenetet ad ki (egyszerű és formázott), és megjelenít egy üzenetmezőt, amely megjeleníti a hívásvermet.

Assert(Boolean)

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Feltétel ellenőrzése; ha a feltétel az false, megjelenik egy üzenetmező, amely a hívás vermet jeleníti meg.

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)

Paraméterek

condition: Boolean

A kiértékelendő feltételes kifejezés. Ha a feltétel teljesül true, a rendszer nem küld hibaüzenetet, és az üzenetmező nem jelenik meg.

Attribútumok: ConditionalAttribute OverloadResolutionPriorityAttribute

Példák

Az alábbi példa létrehoz egy indexet egy tömbhöz, végrehajt néhány műveletet az index értékének beállításához, majd meghívja Assert , hogy ellenőrizze, hogy az index értéke érvényes-e. Ha érvénytelen, Assert a hívásverem kimenete.

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

Megjegyzések

Alapértelmezés szerint a Debug.Assert metódus csak hibakeresési buildekben működik. A metódust Trace.Assert akkor használja, ha állításokat szeretne tenni a kiadási buildekben. További információért lásd: Állítások a felügyelt kódban.

A módszer általában a Assert(Boolean) programfejlesztés során előforduló logikai hibák azonosítására szolgál. Assert kiértékeli a feltételt. Ha az eredmény az false, hibaüzenetet küld a Listeners gyűjteménynek. Ezt a viselkedést testre szabhatja úgy, hogy hozzáad egy TraceListener fájlt a gyűjteményhez, vagy eltávolít egyet a Listeners gyűjteményből.

Amikor az alkalmazás felhasználói felület módban fut, megjelenik egy üzenetmező, amely fájl- és vonalszámokkal jeleníti meg a hívásvermet. Az üzenetmező három gombot tartalmaz: Megszakítás, Újrapróbálkozás és Mellőzés. A megszakítás gombra kattintva leállítja az alkalmazást. Ha az alkalmazás hibakeresőben fut, az Újra gombra kattintva elküldi a hibakeresőben lévő kódnak, vagy felajánlja a hibakereső megnyitását, ha nem. A Mellőzés gombra kattintva a kód következő utasítása folytatódik.

Note

Windows 8.x alkalmazások nem támogatják a modális párbeszédpaneleket, ezért a felhasználói felület módban és a nem felhasználói felület módban is ugyanúgy viselkednek. Az üzenet hibakeresési módban van megírva az aktív nyomkövetési figyelőknek, vagy nem írnak üzenetet kiadási módban.

Note

Az üzenetmező megjelenítése az üzenet jelenlététől DefaultTraceListenerfügg. Ha az DefaultTraceListener üzenet nem szerepel a Listeners gyűjteményben, az üzenetmező nem jelenik meg. A DefaultTraceListener metódus Clear a tulajdonságon (Listeners) való meghívásával System.Diagnostics.Trace.Listeners.Clear() távolítható el. .NET Framework-alkalmazások esetében a <clear> elem és a <remove> elem is használható az alkalmazás konfigurációs fájljában.

.NET Framework-alkalmazások esetében módosíthatja a DefaultTraceListener viselkedését az alkalmazás nevének megfelelő konfigurációs fájlban. Ebben a fájlban engedélyezheti és letilthatja az érvényesség-érvényesítés üzenetmezőt, vagy beállíthatja a tulajdonságot DefaultTraceListener.LogFileName . A konfigurációs fájlt a következőképpen kell formázni:

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

Lásd még

A következőre érvényes:

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Feltétel ellenőrzése; ha a feltétel az false, egy megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.

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)

Paraméterek

condition: Boolean

A kiértékelendő feltételes kifejezés. Ha a feltétel teljesül true, a megadott üzenet nem lesz elküldve, és az üzenetmező nem jelenik meg.

message: Debug.AssertInterpolatedStringHandler

A gyűjteménynek küldendő Listeners üzenet.

Attribútumok: ConditionalAttribute

Megjegyzések

Ezt a túlterhelést a 6. .NET vezették be a teljesítmény javítása érdekében. A paramétert használó String túlterhelésekhez képest ez a túlterhelés csak akkor értékeli ki az interpolált sztringformázási elemeket, ha az üzenetre szükség van.

A módszer általában a Assert programfejlesztés során előforduló logikai hibák azonosítására szolgál. Assert kiértékeli a feltételt. Ha az eredmény az false, a megadott diagnosztikai üzenetet küldi el a Listeners gyűjteménynek. Ezt a viselkedést testre szabhatja úgy, hogy hozzáad egy TraceListener fájlt a gyűjteményhez, vagy eltávolít egyet a Listeners gyűjteményből.

Note

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

Lásd még

A következőre érvényes:

Assert(Boolean, String)

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Feltétel ellenőrzése; ha a feltétel az false, egy megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.

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)

Paraméterek

condition: Boolean

A kiértékelendő feltételes kifejezés. Ha a feltétel teljesül true, a megadott üzenet nem lesz elküldve, és az üzenetmező nem jelenik meg.

message: String

A gyűjteménynek küldendő Listeners üzenet.

Attribútumok: ConditionalAttribute

Példák

Az alábbi példa ellenőrzi, hogy a type paraméter érvényes-e. Ha type igen null, Assert üzenetet ad ki.

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

Megjegyzések

Note

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

Lásd még

A következőre érvényes:

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

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Feltétel ellenőrzése; ha a feltétel az false, egy megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívás vermet.

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)

Paraméterek

condition: Boolean

A kiértékelendő feltételes kifejezés. Ha a feltétel teljesül true, a megadott üzenet nem lesz elküldve, és az üzenetmező nem jelenik meg.

message: Debug.AssertInterpolatedStringHandler

A gyűjteménynek küldendő Listeners üzenet.

detailMessage: Debug.AssertInterpolatedStringHandler

A gyűjteménynek küldendő Listeners részletes üzenet.

Attribútumok: ConditionalAttribute

Megjegyzések

Note

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

Lásd még

A következőre érvényes:

Assert(Boolean, String, String)

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Feltétel ellenőrzése; ha a feltétel az false, két megadott üzenetet ad ki, és megjelenít egy üzenetmezőt, amely megjeleníti a hívásvermet.

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)

Paraméterek

condition: Boolean

A kiértékelendő feltételes kifejezés. Ha a feltétel teljesül true, a megadott üzenetek nem lesznek elküldve, és az üzenetmező nem jelenik meg.

message: String

A gyűjteménynek küldendő Listeners üzenet.

detailMessage: String

A gyűjteménynek küldendő Listeners részletes üzenet.

Attribútumok: ConditionalAttribute

Példák

Az alábbi példa ellenőrzi, hogy a type paraméter érvényes-e. Ha type igen null, Assert két üzenetet ad ki.

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

Megjegyzések

A módszer általában a Assert(Boolean, String, String) programfejlesztés során előforduló logikai hibák azonosítására szolgál. Assert kiértékeli a feltételt. Ha az eredmény az false, elküldi a megadott diagnosztikai üzenetet és részletes üzenetet a Listeners gyűjteménynek. Ezt a viselkedést testre szabhatja úgy, hogy hozzáad egy TraceListener fájlt a gyűjteményhez, vagy eltávolít egyet a Listeners gyűjteményből.

Note

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

Lásd még

A következőre érvényes:

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

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Forrás:: Debug.cs

Feltétel ellenőrzése; ha a feltétel az false, két üzenetet ad ki (egyszerű és formázott), és megjelenít egy üzenetmezőt, amely megjeleníti a hívásvermet.

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

Paraméterek

condition: Boolean

A kiértékelendő feltételes kifejezés. Ha a feltétel teljesül true, a megadott üzenetek nem lesznek elküldve, és az üzenetmező nem jelenik meg.

message: String

A gyűjteménynek küldendő Listeners üzenet.

detailMessageFormat: String

A gyűjteménybe küldendő összetett formátumú sztring Listeners . Ez az üzenet olyan szöveget tartalmaz, amely nulla vagy több formátumelemből áll, amelyek a args tömb objektumainak felelnek meg.

args: Object[]

Olyan objektumtömb, amely nulla vagy több formázandó objektumot tartalmaz.

Attribútumok: ConditionalAttribute

Megjegyzések

Ez a metódus az .NET összetett formázási funkciót használja az objektum értékének szövegreformálásra való konvertálásához, majd a sztringbe való beágyazáshoz. Az eredményül kapott sztringet a rendszer elküldi a gyűjteménynek Listeners .

A módszer általában a Assert(Boolean, String, String, Object[]) programfejlesztés során előforduló logikai hibák azonosítására szolgál. Assert kiértékeli a feltételt. Ha az eredmény azfalse, a String.Format(String, Object[]) metódus meghívása, a sztring és detailMessageFormat a args tömb pedig paraméterként lesz átadva. Assert(Boolean, String, String, Object[]) ezután elküldi a megadott szöveges üzenetet és a formázott szöveges üzenetet a Listeners gyűjteménynek. Ezt a viselkedést testre szabhatja úgy, hogy hozzáad egy TraceListener fájlt a gyűjteményhez, vagy eltávolít egyet a Listeners gyűjteményből.

Note

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

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?