Debug.Assert Metode

Referensi

Definisi

Ruang nama:: System.Diagnostics

Rakitan:: System.Diagnostics.Debug.dll

Rakitan:: System.Runtime.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Memeriksa kondisi; jika kondisinya adalah false, menghasilkan pesan dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

Overload

Assert(Boolean)	Memeriksa kondisi; jika kondisinya adalah `false`, menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.
Assert(Boolean, Debug+AssertInterpolatedStringHandler)	Memeriksa kondisi; jika kondisinya adalah `false`, menghasilkan pesan tertentu dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.
Assert(Boolean, String)	Memeriksa kondisi; jika kondisinya adalah `false`, menghasilkan pesan tertentu dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.
Assert(Boolean, Debug+AssertInterpolatedStringHandler, Debug+AssertInterpolatedStringHandler)	Memeriksa kondisi; jika kondisinya adalah `false`, menghasilkan pesan tertentu dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.
Assert(Boolean, String, String)	Memeriksa kondisi; jika kondisinya adalah `false`, menghasilkan dua pesan yang ditentukan dan menampilkan kotak pesan yang menunjukkan tumpukan panggilan.
Assert(Boolean, String, String, Object[])	Memeriksa kondisi; jika kondisinya adalah `false`, menghasilkan dua pesan (sederhana dan diformat) dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

Assert(Boolean)

Sumber:: Debug.cs

Sumber:: Debug.cs

Sumber:: Debug.cs

Memeriksa kondisi; jika kondisinya adalah false, menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

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)

Parameter

condition: Boolean

Ekspresi kondisional untuk dievaluasi. Jika kondisinya adalah true, pesan kegagalan tidak dikirim dan kotak pesan tidak ditampilkan.

Atribut: ConditionalAttribute

Contoh

Contoh berikut membuat indeks untuk array, melakukan beberapa tindakan untuk mengatur nilai indeks, lalu memanggil Assert untuk mengonfirmasi bahwa nilai indeks valid. Jika tidak valid, Assert output tumpukan panggilan.

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

Keterangan

Secara default, Debug.Assert metode hanya berfungsi dalam build debug. Trace.Assert Gunakan metode jika Anda ingin melakukan pernyataan dalam build rilis. Untuk informasi selengkapnya, lihat Pernyataan dalam kode terkelola.

Biasanya, Assert(Boolean) metode ini digunakan untuk mengidentifikasi kesalahan logika selama pengembangan program. Assert mengevaluasi kondisi. Jika hasilnya adalah false, maka akan mengirim pesan kegagalan ke Listeners koleksi. Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau menghapusnya dari, Listeners koleksi.

Saat aplikasi berjalan dalam mode antarmuka pengguna, aplikasi menampilkan kotak pesan yang menunjukkan tumpukan panggilan dengan nomor file dan baris. Kotak pesan berisi tiga tombol: Batalkan, Coba Lagi, dan Abaikan. Mengklik tombol Batalkan mengakhiri aplikasi. Mengklik Coba Lagi akan mengirim Anda ke kode di debugger jika aplikasi Anda berjalan dalam debugger, atau menawarkan untuk membuka debugger jika tidak. Mengklik Abaikan berlanjut dengan instruksi berikutnya dalam kode.

Catatan

aplikasi Windows 8.x tidak mendukung kotak dialog modal, sehingga bersifat sama dalam mode antarmuka pengguna dan mode antarmuka non-pengguna. Pesan ditulis ke pendengar pelacakan aktif dalam mode penelusuran kesalahan, atau tidak ada pesan yang ditulis dalam mode rilis.

Catatan

Tampilan kotak pesan tergantung pada keberadaan DefaultTraceListener. DefaultTraceListener Jika tidak ada dalam Listeners koleksi, kotak pesan tidak ditampilkan. DefaultTraceListener dapat dihapus dengan memanggil Clear metode pada Listeners properti (System.Diagnostics.Trace.Listeners.Clear()). Untuk aplikasi .NET Framework, Anda juga dapat menggunakan <elemen yang jelas> dan <elemen hapus> di file konfigurasi aplikasi Anda.

Untuk aplikasi .NET Framework, Anda dapat mengubah perilaku DefaultTraceListener dalam file konfigurasi yang sesuai dengan nama aplikasi Anda. Dalam file ini, Anda dapat mengaktifkan dan menonaktifkan kotak pesan pernyataan atau mengatur DefaultTraceListener.LogFileName properti . File konfigurasi harus diformat sebagai berikut:

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

Lihat juga

Berlaku untuk

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Sumber:: Debug.cs

Sumber:: Debug.cs

Sumber:: Debug.cs

Memeriksa kondisi; jika kondisinya adalah false, menghasilkan pesan tertentu dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

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)

Parameter

condition: Boolean

Ekspresi kondisional untuk dievaluasi. Jika kondisinya adalah true, pesan yang ditentukan tidak dikirim dan kotak pesan tidak ditampilkan.

message: Debug.AssertInterpolatedStringHandler

Pesan yang akan dikirim ke Listeners koleksi.

Atribut: ConditionalAttribute

Keterangan

Kelebihan beban ini diperkenalkan di .NET 6 untuk meningkatkan performa. Dibandingkan dengan kelebihan beban yang mengambil String parameter, kelebihan beban ini hanya mengevaluasi item pemformatan string terinterpolasi jika pesan diperlukan.

Biasanya, Assert metode ini digunakan untuk mengidentifikasi kesalahan logika selama pengembangan program. Assert mengevaluasi kondisi. Jika hasilnya adalah false, maka akan mengirim pesan diagnostik yang ditentukan ke Listeners koleksi. Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau menghapusnya dari, Listeners koleksi.

Catatan

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

Lihat juga

Berlaku untuk

Assert(Boolean, String)

Sumber:: Debug.cs

Sumber:: Debug.cs

Sumber:: Debug.cs

Memeriksa kondisi; jika kondisinya adalah false, menghasilkan pesan tertentu dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

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)

Parameter

condition: Boolean

Ekspresi kondisional untuk dievaluasi. Jika kondisinya adalah true, pesan yang ditentukan tidak dikirim dan kotak pesan tidak ditampilkan.

message: String

Pesan yang akan dikirim ke Listeners koleksi.

Atribut: ConditionalAttribute

Contoh

Contoh berikut memeriksa apakah type parameter valid. Jika type adalah null, Assert menghasilkan pesan.

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

Keterangan

Catatan

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

Lihat juga

Berlaku untuk

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

Sumber:: Debug.cs

Sumber:: Debug.cs

Sumber:: Debug.cs

Memeriksa kondisi; jika kondisinya , falsemenghasilkan pesan tertentu dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

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)

Parameter

condition: Boolean

Ekspresi kondisional untuk dievaluasi. Jika kondisinya adalah true, pesan yang ditentukan tidak dikirim dan kotak pesan tidak ditampilkan.

message: Debug.AssertInterpolatedStringHandler

Pesan yang akan dikirim ke Listeners koleksi.

detailMessage: Debug.AssertInterpolatedStringHandler

Pesan terperinci untuk dikirim ke Listeners koleksi.

Atribut: ConditionalAttribute

Keterangan

Secara default, Debug.Assert metode ini hanya berfungsi dalam build debug. Trace.Assert Gunakan metode jika Anda ingin melakukan pernyataan dalam build rilis. Untuk informasi selengkapnya, lihat Pernyataan dalam kode terkelola.

Biasanya, Assert metode ini digunakan untuk mengidentifikasi kesalahan logika selama pengembangan program. Assert mengevaluasi kondisi. Jika hasilnya adalah false, maka akan mengirimkan pesan diagnostik yang ditentukan ke Listeners koleksi. Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau menghapusnya dari, Listeners koleksi.

Catatan

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

Lihat juga

Berlaku untuk

Assert(Boolean, String, String)

Sumber:: Debug.cs

Sumber:: Debug.cs

Sumber:: Debug.cs

Memeriksa kondisi; jika kondisinya adalah false, menghasilkan dua pesan yang ditentukan dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

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)

Parameter

condition: Boolean

Ekspresi kondisional untuk dievaluasi. Jika kondisinya , truepesan yang ditentukan tidak dikirim dan kotak pesan tidak ditampilkan.

message: String

Pesan untuk dikirim ke Listeners koleksi.

detailMessage: String

Pesan terperinci untuk dikirim ke Listeners koleksi.

Atribut: ConditionalAttribute

Contoh

Contoh berikut memeriksa apakah type parameter valid. Jika type adalah null, Assert menghasilkan dua pesan.

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

Keterangan

Biasanya, Assert(Boolean, String, String) metode ini digunakan untuk mengidentifikasi kesalahan logika selama pengembangan program. Assert mengevaluasi kondisi. Jika hasilnya adalah false, ia mengirim pesan diagnostik yang ditentukan dan pesan terperinci ke Listeners koleksi. Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau menghapusnya dari, Listeners koleksi.

Catatan

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

Lihat juga

Berlaku untuk

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

Sumber:: Debug.cs

Sumber:: Debug.cs

Sumber:: Debug.cs

Memeriksa kondisi; jika kondisinya , falsemenghasilkan dua pesan (sederhana dan diformat) dan menampilkan kotak pesan yang memperlihatkan tumpukan panggilan.

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

Parameter

condition: Boolean

Ekspresi kondisional untuk dievaluasi. Jika kondisinya , truepesan yang ditentukan tidak dikirim dan kotak pesan tidak ditampilkan.

message: String

Pesan untuk dikirim ke Listeners koleksi.

detailMessageFormat: String

String format komposit untuk dikirim ke Listeners koleksi. Pesan ini berisi teks yang diintermiks dengan nol atau lebih item format, yang sesuai dengan objek dalam args array.

args: Object[]

Array objek yang berisi nol atau lebih objek untuk diformat.

Atribut: ConditionalAttribute

Keterangan

Metode ini menggunakan fitur pemformatan komposit .NET untuk mengonversi nilai objek ke representasi teksnya dan menyematkan representasi tersebut dalam string. String yang dihasilkan dikirim ke Listeners koleksi.

Biasanya, Assert(Boolean, String, String, Object[]) metode ini digunakan untuk mengidentifikasi kesalahan logika selama pengembangan program. Assert mengevaluasi kondisi. Jika hasilnya adalah false, String.Format(String, Object[]) Metode ini dipanggil dan detailMessageFormat string dan args array diteruskan sebagai parameter. Assert(Boolean, String, String, Object[]) kemudian mengirim pesan teks yang ditentukan dan pesan teks yang diformat ke Listeners koleksi. Anda dapat menyesuaikan perilaku ini dengan menambahkan TraceListener ke, atau menghapusnya dari, Listeners koleksi.

Catatan

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

Berlaku untuk

Debug.Assert Metode

Definisi

Overload

Assert(Boolean)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

Parameter

Keterangan

Lihat juga

Berlaku untuk

Assert(Boolean, String)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Keterangan

Lihat juga

Berlaku untuk

Assert(Boolean, String, String)

Parameter

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: