Trace.Assert Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Diagnostics.TraceSource.dll

Bir koşulu denetler; koşulu ise false, iletilerin çıkışını alır ve çağrı yığınını gösteren bir ileti kutusu görüntüler.

Aşırı Yüklemeler

Name	Description
Assert(Boolean)	Bir koşulu denetler; koşulu ise false, çağrı yığınını gösteren bir ileti kutusu görüntüler.
Assert(Boolean, String)	Bir koşulu denetler; koşulu ise false, belirtilen bir iletinin çıktısını alır ve çağrı yığınını gösteren bir ileti kutusu görüntüler.
Assert(Boolean, String, String)	Bir koşulu denetler; koşulu ise false, belirtilen iki iletinin çıkışını alır ve çağrı yığınını gösteren bir ileti kutusu görüntüler.

Assert(Boolean)

Kaynak:

Trace.cs

Bir koşulu denetler; koşulu ise false, çağrı yığınını gösteren bir ileti kutusu görüntüler.

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")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

Parametreler

condition

Boolean

Değerlendirilecek koşullu ifade. Koşul ise true, hata iletisi gönderilmez ve ileti kutusu görüntülenmez.

Öznitelikler

ConditionalAttribute OverloadResolutionPriorityAttribute

Örnekler

Aşağıdaki örnek bir dizi için dizin oluşturur. Ardından dizinin değerini ayarlayan bir eylem gerçekleştirilir. Ardından, dizin değerinin geçerli olduğunu doğrulamak için kod çağrıları Assert . Geçerli değilse çağrı Assert yığınını verir.

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

Açıklamalar

Trace.Assert Yayın derlemelerinde onaylamalar yapmak istiyorsanız yöntemini kullanın. Debug.Assert yöntemi yalnızca hata ayıklama derlemelerinde çalışır. Daha fazla bilgi için bkz. Yönetilen Kodda Onaylar.

Genellikle, Assert(Boolean) yöntem program geliştirme sırasında mantık hatalarını tanımlamak için kullanılır. Assert(Boolean) koşulu değerlendirir. Sonuç ise false, koleksiyona Listeners bir hata iletisi gönderir. Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Uygulama kullanıcı arabirimi modunda çalıştığında, çağrı yığınını dosya ve satır numaralarıyla gösteren bir ileti kutusu görüntüler. İleti kutusu üç düğme içerir: Abort, Retry ve Ignore. Durdur düğmesine tıklanması uygulamayı sonlandırır. Yeniden Dene'ye tıklandığında, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda veya değilse hata ayıklayıcıyı açmayı teklif eder. Yoksay'a tıklanması, koddaki sonraki yönergeyle devam eder.

Uyarı

İleti kutusunun görüntülenmesi, varlığının DefaultTraceListenerdurumuna bağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener özelliğinde Listeners yöntemi çağrılarak Clear kaldırılabilir .System.Diagnostics.Trace.Listeners.Clear() .NET Framework uygulamaları için, uygulamanızın <yapılandırma dosyasındaki clear> öğesini ve <remove> öğesini de kullanabilirsiniz.

.NET Framework uygulamaları için, uygulamanızın DefaultTraceListener adına karşılık gelen yapılandırma dosyasındaki öğesinin davranışını değiştirebilirsiniz. Bu dosyada, onay ileti kutusunu etkinleştirebilir ve devre dışı bırakabilir veya özelliğini ayarlayabilirsiniz DefaultTraceListener.LogFileName . Yapılandırma dosyası aşağıdaki gibi biçimlendirilmelidir:

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

Ayrıca bkz.

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

Assert(Boolean, String)

Kaynak:

Trace.cs

Bir koşulu denetler; koşulu ise false, belirtilen bir iletinin çıktısını alır ve çağrı yığınını gösteren bir ileti kutusu görüntüler.

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")>]
static member Assert : bool * string -> unit

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

Parametreler

condition

Boolean

Değerlendirilecek koşullu ifade. Koşul ise true, belirtilen ileti gönderilmez ve ileti kutusu görüntülenmez.

message

String

Koleksiyona gönderilecek Listeners ileti.

Öznitelikler

ConditionalAttribute

Örnekler

Aşağıdaki örnek, parametrenin type geçerli olup olmadığını denetler. type geçirilen isenull, iletinin çıktısını Assert alır.

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

Açıklamalar

Trace.Assert Yayın derlemelerinde onaylamalar yapmak istiyorsanız yöntemini kullanın. Debug.Assert yöntemi yalnızca hata ayıklama derlemelerinde çalışır. Daha fazla bilgi için bkz. Yönetilen Kodda Onaylar.

Genellikle, Assert(Boolean, String) yöntem program geliştirme sırasında mantık hatalarını tanımlamak için kullanılır. Assert(Boolean, String) koşulu değerlendirir. Sonuç ise false, belirtilen tanılama iletisini koleksiyona Listeners gönderir. Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Uygulama kullanıcı arabirimi modunda çalıştığında, çağrı yığınını dosya ve satır numaralarıyla gösteren bir ileti kutusu görüntüler. İleti kutusu üç düğme içerir: Abort, Retry ve Ignore. Durdur düğmesine tıklanması uygulamayı sonlandırır. Yeniden Dene'ye tıklandığında, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda veya değilse hata ayıklayıcıyı açmayı teklif eder. Yoksay'a tıklanması, koddaki sonraki yönergeyle devam eder.

Uyarı

İleti kutusunun görüntülenmesi, varlığının DefaultTraceListenerdurumuna bağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener özelliğinde Listeners yöntemi çağrılarak Clear kaldırılabilir .System.Diagnostics.Trace.Listeners.Clear() .NET Framework uygulamaları için, uygulamanızın <yapılandırma dosyasındaki clear> öğesini ve <remove> öğesini de kullanabilirsiniz.

.NET Framework uygulamaları için, uygulamanızın DefaultTraceListener adına karşılık gelen yapılandırma dosyasındaki öğesinin davranışını değiştirebilirsiniz. Bu dosyada, onay ileti kutusunu etkinleştirebilir ve devre dışı bırakabilir veya özelliğini ayarlayabilirsiniz DefaultTraceListener.LogFileName . Yapılandırma dosyası aşağıdaki gibi biçimlendirilmelidir:

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

Ayrıca bkz.

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

Assert(Boolean, String, String)

Kaynak:

Trace.cs

Bir koşulu denetler; koşulu ise false, belirtilen iki iletinin çıkışını alır ve çağrı yığınını gösteren bir ileti kutusu görüntüler.

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")>]
static member Assert : bool * string * string -> unit

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

Parametreler

condition

Boolean

Değerlendirilecek koşullu ifade. Koşul ise true, belirtilen iletiler gönderilmez ve ileti kutusu görüntülenmez.

message

String

Koleksiyona gönderilecek Listeners ileti.

detailMessage

String

Koleksiyona gönderilecek Listeners ayrıntılı ileti.

Öznitelikler

ConditionalAttribute

Örnekler

Aşağıdaki örnek, parametrenin type geçerli olup olmadığını denetler. type geçirilen isenull, iletinin çıktısını Assert alır.

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

Açıklamalar

Trace.Assert Yayın derlemelerinde onaylamalar yapmak istiyorsanız yöntemini kullanın. Debug.Assert yöntemi yalnızca hata ayıklama derlemelerinde çalışır. Daha fazla bilgi için bkz. Yönetilen Kodda Onaylar.

Genellikle, Assert(Boolean, String, String) yöntem program geliştirme sırasında mantık hatalarını tanımlamak için kullanılır. Assert koşulu değerlendirir. Sonuç ise false, belirtilen tanılama iletisini ve ayrıntılı iletiyi koleksiyona Listeners gönderir. Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Uygulama kullanıcı arabirimi modunda çalıştığında, çağrı yığınını dosya ve satır numaralarıyla gösteren bir ileti kutusu görüntüler. İleti kutusu üç düğme içerir: Abort, Retry ve Ignore. Durdur düğmesine tıklanması uygulamayı sonlandırır. Yeniden Dene'ye tıklandığında, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda veya değilse hata ayıklayıcıyı açmayı teklif eder. Yoksay'a tıklanması, koddaki sonraki yönergeyle devam eder.

Uyarı

İleti kutusunun görüntülenmesi, varlığının DefaultTraceListenerdurumuna bağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener özelliğinde Listeners yöntemi çağrılarak Clear kaldırılabilir .System.Diagnostics.Trace.Listeners.Clear() .NET Framework uygulamaları için, uygulamanızın <yapılandırma dosyasındaki clear> öğesini ve <remove> öğesini de kullanabilirsiniz.

.NET Framework uygulamaları için, uygulamanızın DefaultTraceListener adına karşılık gelen yapılandırma dosyasındaki öğesinin davranışını değiştirebilirsiniz. Bu dosyada, onay ileti kutusunu etkinleştirebilir ve devre dışı bırakabilir veya özelliğini ayarlayabilirsiniz DefaultTraceListener.LogFileName . Yapılandırma dosyası aşağıdaki gibi biçimlendirilmelidir:

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

Ayrıca bkz.

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