Trace.Assert Metódus

Definíció

Névtér:: System.Diagnostics

Szerelvények:: netstandard.dll, System.Diagnostics.TraceSource.dll

Szerelvény:: System.Diagnostics.TraceSource.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, 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, 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)

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.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("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("TRACE")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

[<System.Diagnostics.Conditional("TRACE")>]
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 egy tömb indexét hozza létre. Ezután végrehajtunk néhány műveletet, amely beállítja az index értékét. Ezután az indexérték érvényességének ellenőrzésére irányuló kódhívások Assert . Ha érvénytelen, a Assert hívásverem kimenete.

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

Megjegyzések

A metódust Trace.Assert akkor használja, ha állításokat szeretne tenni a kiadási buildekben. A Debug.Assert metódus csak hibakeresési buildekben működik. 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(Boolean) 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 a hívás vermet jeleníti meg fájl- és vonalszámokkal. 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

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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Lásd még

A következőre érvényes:

Assert(Boolean, String)

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.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("TRACE")]
public static void Assert(bool condition, string? message = default);

[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, Optional message As String = Nothing)

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

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 az type átadott beadás, nulla Assert kimenet egy üzenet lesz.

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

Megjegyzések

A módszer általában a Assert(Boolean, String) programfejlesztés során előforduló logikai hibák azonosítására szolgál. Assert(Boolean, String) 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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Lásd még

A következőre érvényes:

Assert(Boolean, String, String)

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.cs

Forrás:: Trace.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("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)

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 az type átadott beadás, nulla Assert kimenet egy üzenet lesz.

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

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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?