Debug.Assert Yöntem

Başvuru

Tanım

Ad Alanı:: System.Diagnostics

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

Bütünleştirilmiş Kod:: System.Runtime.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, Debug+AssertInterpolatedStringHandler)	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)	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, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	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, String, String, Object[])	Bir koşulu denetler; koşulu ise `false`, iki ileti (basit ve biçimlendirilmiş) çıkışını alır ve çağrı yığınını gösteren bir ileti kutusu görüntüler.

Assert(Boolean)

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Kaynak:: Debug.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("DEBUG")]
public static void Assert (bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
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, dizinin değerini ayarlamak için bazı eylemler gerçekleştirir ve ardından dizin değerinin geçerli olduğunu onaylamak için çağrısı Assert yapar. Geçerli değilse çağrı Assert yığınını verir.

// Create a local value.
int index;

// Perform some action that sets the local value.
index = -40;

// Test that the local value is valid. 
#if defined(DEBUG)
Debug::Assert( index > -1 );
#endif

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

Açıklamalar

Varsayılan olarak, Debug.Assert yöntemi yalnızca hata ayıklama derlemelerinde çalışır. Trace.Assert Yayın derlemelerinde onaylamalar yapmak istiyorsanız yöntemini kullanın. 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 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

Windows 8.x uygulamaları kalıcı iletişim kutularını desteklemez, bu nedenle kullanıcı arabirimi modunda ve kullanıcı dışı arabirim modunda aynı şekilde davranır. İleti hata ayıklama modunda etkin izleme dinleyicilerine yazılır veya yayın modunda hiçbir ileti yazılmasın.

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Kaynak:: Debug.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::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)

Parametreler

condition: Boolean

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

message: Debug.AssertInterpolatedStringHandler

Koleksiyona gönderilecek Listeners ileti.

Öznitelikler: ConditionalAttribute

Açıklamalar

Bu aşırı yükleme performansı geliştirmek için .NET 6'da kullanıma sunulmuştur. Bir parametreyi alan String aşırı yüklemelerle karşılaştırıldığında, bu aşırı yükleme yalnızca ileti gerekliyse tüm ilişkilendirilmiş dize biçimlendirme öğelerini değerlendirir.

Genellikle, Assert 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 koleksiyona Listeners gönderir. Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Not

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

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String)

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Kaynak:: Debug.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("DEBUG")]
public static void Assert (bool condition, string message);

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

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. ise typenull, Assert bir ileti çıkışı oluşturur.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null" );
   #endif
}

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

Açıklamalar

Not

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

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Kaynak:: Debug.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::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)

Parametreler

condition: Boolean

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

message: Debug.AssertInterpolatedStringHandler

Koleksiyona gönderilecek Listeners ileti.

detailMessage: Debug.AssertInterpolatedStringHandler

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

Öznitelikler: ConditionalAttribute

Açıklamalar

Not

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

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String, String)

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Kaynak:: Debug.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("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)

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. ise typenull, Assert iki ileti döndürür.

void MyMethod( Object^ obj, Type^ type )
{
   #if defined(DEBUG)
   Debug::Assert( type != nullptr, "Type paramater is null", "Can't get object for null type" );
   #endif
}

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

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>
    <assert assertuienabled="true" logfilename="c:\\myFile.log" />
  </system.diagnostics>
</configuration>

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Kaynak:: Debug.cs

Bir koşulu denetler; koşulu ise false, iki ileti (basit ve biçimlendirilmiş) çı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 ^ 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())

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.

detailMessageFormat: String

Koleksiyona gönderilecek Listeners bileşik biçim dizesi. Bu ileti, dizideki args nesnelere karşılık gelen sıfır veya daha fazla biçim öğesiyle karışık metin içerir.

args: Object[]

Biçimlendirilecek için sıfır veya daha fazla nesne içeren bir nesne dizisi.

Öznitelikler: ConditionalAttribute

Açıklamalar

Bu yöntem, bir nesnenin değerini metin gösterimine dönüştürmek ve bu gösterimi bir dizeye eklemek için .NET bileşik biçimlendirme özelliğini kullanır. Sonuçta elde edilen dize koleksiyona Listeners gönderilir.

Genellikle, Assert(Boolean, String, String, Object[]) 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 falseyöntemi String.Format(String, Object[]) çağrılır ve detailMessageFormat dize ve args dizi parametre olarak geçirilir. Assert(Boolean, String, String, Object[]) ardından belirtilen metin iletisini ve biçimlendirilmiş metin iletisini koleksiyona Listeners gönderir. Koleksiyona bir TraceListener ekleyerek veya koleksiyonundan Listeners kaldırarak bu davranışı özelleştirebilirsiniz.

Not

İleti kutusunun görüntülenmesi, 'nin 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.

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

Şunlara uygulanır

Aracılığıyla paylaş

Debug.Assert Yöntem

Tanım

Aşırı Yüklemeler

Assert(Boolean)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parametreler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Assert(Boolean, String, String)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar