Trace.Assert Yöntem

Başvuru

Tanım

Ad Alanı:: System.Diagnostics

Bütünleştirilmiş Kod:: System.Diagnostics.TraceSource.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bir koşulu denetler; koşul 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

Assert(Boolean)	Bir koşulu denetler; koşul ise `false`, çağrı yığınını gösteren bir ileti kutusu görüntüler.
Assert(Boolean, String)	Bir koşulu denetler; koşul ise `false`, belirtilen bir iletiyi görüntüler ve çağrı yığınını gösteren bir ileti kutusu görüntüler.
Assert(Boolean, String, String)	Bir koşulu denetler; koşul 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

Kaynak:: Trace.cs

Kaynak:: Trace.cs

Bir koşulu denetler; koşul 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")]
public static void Assert (bool condition);

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

Ö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 yapılır. Geçerli değilse çağrı Assert yığınını verir.

protected:
   // Create an index for an array.
   int index;

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }

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

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 kutusunda üç düğme bulunur: Abort, Retry ve Ignore. Durdur düğmesine tıklanması uygulamayı sonlandırır. Yeniden Dene'ye tıkladığınızda, uygulamanız bir hata ayıklayıcıda çalışıyorsa hata ayıklayıcıdaki koda gidersiniz veya değilse hata ayıklayıcıyı açmayı teklif eder. Yoksay'a tıklanması koddaki sonraki yönergeyle devam eder.

Not

İleti kutusunun görüntülenmesi, öğesinin varlığına DefaultTraceListenerbağlıdır. DefaultTraceListener koleksiyonunda Listeners değilse, ileti kutusu görüntülenmez. DefaultTraceListener özelliğinde Listeners (System.Diagnostics.Trace.Listeners.Clear()) yöntemi çağrılarak Clear kaldırılabilir. .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, yapılandırma dosyasında uygulamanızın adına karşılık gelen öğesinin davranışını DefaultTraceListener değiştirebilirsiniz. Bu dosyada onay iletisi 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.

Şunlara uygulanır

Assert(Boolean, String)

Kaynak:: Trace.cs

Kaynak:: Trace.cs

Kaynak:: Trace.cs

Bir koşulu denetler; koşul ise false, belirtilen bir iletiyi görüntüler 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);

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

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, Assert bir ileti çıkartır.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }

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

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.

Not

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

Şunlara uygulanır

Assert(Boolean, String, String)

Kaynak:: Trace.cs

Kaynak:: Trace.cs

Kaynak:: Trace.cs

Bir koşulu denetler; koşul 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")]
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, Assert bir ileti çıkartır.

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }

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

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.

Not

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

Şunlara uygulanır

Trace.Assert Yöntem

Tanım

Aşırı Yüklemeler

Assert(Boolean)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar