Debug.Assert メソッド

定義

条件をチェックします。条件が false の場合、メッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

オーバーロード

Assert(Boolean)

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

Assert(Boolean, String)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

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

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

Assert(Boolean, String, String)

条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

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

条件をチェックし、その条件が false の場合は、2 つのメッセージ (単純なメッセージと書式設定されたメッセージ) を出力し、呼び出し履歴を表示するメッセージ ボックスを表示します。

Assert(Boolean)

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。

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)

パラメーター

condition
Boolean

評価する条件式です。 条件が true の場合、エラー メッセージは送信されず、メッセージ ボックスは表示されません。

属性

次の例では、配列のインデックスを作成し、インデックスの値を設定するためのアクションを実行し、 を呼び出 Assert してインデックス値が有効であることを確認します。 無効な場合は、 Assert 呼び出し履歴を出力します。

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

注釈

既定では、 メソッドは Debug.Assert デバッグ ビルドでのみ機能します。 リリース ビルドで Trace.Assert アサーションを実行する場合は、 メソッドを使用します。 詳細については、「マネージド コードのアサーション」を参照してください。

通常、 メソッドは、 Assert(Boolean) プログラムの開発中にロジック エラーを識別するために使用されます。 Assert は条件を評価します。 結果が の場合、 falseエラー メッセージがコレクションに Listeners 送信されます。 この動作は、コレクションに を追加 TraceListener するか、コレクションから Listeners 削除することでカスタマイズできます。

アプリケーションがユーザー インターフェイス モードで実行されているときは、ファイル番号と行番号を含む呼び出し履歴を示すメッセージ ボックスが表示されます。 メッセージ ボックスには、[ 中止]、[ 再試行]、[ 無視] の 3 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行 ] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

注意

Windows 8.x アプリはモーダル ダイアログ ボックスをサポートしていないため、ユーザー インターフェイス モードと非ユーザー インターフェイス モードで同じように動作します。 メッセージがデバッグ モードでアクティブなトレース リスナーに書き込まれるか、リリース モードでメッセージが書き込まれない。

注意

メッセージ ボックスの表示は、 の存在 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクション内にないListeners場合、メッセージ ボックスは表示されません。 をDefaultTraceListener削除するには、 プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドをListeners呼び出します。 .NET Frameworkアプリの場合は、アプリの<構成ファイルで clear> 要素<remove> 要素を使用することもできます。

.NET Framework アプリの場合は、アプリケーションのDefaultTraceListener名前に対応する構成ファイル内の の動作を変更できます。 このファイルでは、アサート メッセージ ボックスを有効または無効にしたり、 プロパティを DefaultTraceListener.LogFileName 設定したりできます。 構成ファイルは、次のように書式設定する必要があります。

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

こちらもご覧ください

適用対象

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

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)

パラメーター

condition
Boolean

評価する条件式です。 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。

message
Debug.AssertInterpolatedStringHandler

Listeners コレクションに送信するメッセージ。

属性

注釈

このオーバーロードは、パフォーマンスを向上させるために .NET 6 で導入されました。 パラメーターを受け取る String オーバーロードと比較して、このオーバーロードは、メッセージが必要な場合にのみ、挿入文字列の書式設定項目を評価します。

既定では、 メソッドは Debug.Assert デバッグ ビルドでのみ機能します。 リリース ビルドで Trace.Assert アサーションを実行する場合は、 メソッドを使用します。 詳細については、「マネージド コードのアサーション」を参照してください。

通常、 メソッドは、 Assert プログラムの開発中にロジック エラーを識別するために使用されます。 Assert は条件を評価します。 結果が の場合、 false指定した診断メッセージがコレクションに Listeners 送信されます。 この動作は、コレクションに を追加 TraceListener するか、コレクションから Listeners 削除することでカスタマイズできます。

アプリケーションがユーザー インターフェイス モードで実行されているときは、ファイル番号と行番号を含む呼び出し履歴を示すメッセージ ボックスが表示されます。 メッセージ ボックスには、[ 中止]、[ 再試行]、[ 無視] の 3 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行 ] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

注意

メッセージ ボックスの表示は、 の存在 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクション内にないListeners場合、メッセージ ボックスは表示されません。 をDefaultTraceListener削除するには、 プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドをListeners呼び出します。 .NET Frameworkアプリの場合は、アプリの<構成ファイルで clear> 要素<remove> 要素を使用することもできます。

.NET Framework アプリの場合は、アプリケーションのDefaultTraceListener名前に対応する構成ファイル内の の動作を変更できます。 このファイルでは、アサート メッセージ ボックスを有効または無効にしたり、 プロパティを DefaultTraceListener.LogFileName 設定したりできます。 構成ファイルは、次のように書式設定する必要があります。

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

こちらもご覧ください

適用対象

Assert(Boolean, String)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

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)

パラメーター

condition
Boolean

評価する条件式です。 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。

message
String

Listeners コレクションに送信するメッセージ。

属性

次の例では、 パラメーターが type 有効かどうかを確認します。 が のAssert場合typenullメッセージが出力されます。

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

注釈

既定では、 メソッドは Debug.Assert デバッグ ビルドでのみ機能します。 リリース ビルドで Trace.Assert アサーションを実行する場合は、 メソッドを使用します。 詳細については、「マネージド コードのアサーション」を参照してください。

通常、 メソッドは、 Assert プログラムの開発中にロジック エラーを識別するために使用されます。 Assert は条件を評価します。 結果が の場合、 false指定した診断メッセージがコレクションに Listeners 送信されます。 この動作は、コレクションに を追加 TraceListener するか、コレクションから Listeners 削除することでカスタマイズできます。

アプリケーションがユーザー インターフェイス モードで実行されているときは、ファイル番号と行番号を含む呼び出し履歴を示すメッセージ ボックスが表示されます。 メッセージ ボックスには、[ 中止]、[ 再試行]、[ 無視] の 3 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行 ] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

注意

メッセージ ボックスの表示は、 の存在 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクション内にないListeners場合、メッセージ ボックスは表示されません。 をDefaultTraceListener削除するには、 プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドをListeners呼び出します。 .NET Frameworkアプリの場合は、アプリの<構成ファイルで clear> 要素<remove> 要素を使用することもできます。

.NET Framework アプリの場合は、アプリケーションのDefaultTraceListener名前に対応する構成ファイル内の の動作を変更できます。 このファイルでは、アサート メッセージ ボックスを有効または無効にしたり、 プロパティを DefaultTraceListener.LogFileName 設定したりできます。 構成ファイルは、次のように書式設定する必要があります。

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

こちらもご覧ください

適用対象

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

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

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)

パラメーター

condition
Boolean

評価する条件式です。 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。

message
Debug.AssertInterpolatedStringHandler

Listeners コレクションに送信するメッセージ。

detailMessage
Debug.AssertInterpolatedStringHandler

Listeners コレクションに送信する詳細なメッセージ。

属性

注釈

このオーバーロードは、パフォーマンスを向上させるために .NET 6 で導入されました。 パラメーターを受け取る String オーバーロードと比較して、このオーバーロードは、メッセージが必要な場合にのみ、挿入文字列の書式設定項目を評価します。

既定では、 メソッドは Debug.Assert デバッグ ビルドでのみ機能します。 リリース ビルドで Trace.Assert アサーションを実行する場合は、 メソッドを使用します。 詳細については、「マネージド コードのアサーション」を参照してください。

通常、 メソッドは、 Assert プログラムの開発中にロジック エラーを識別するために使用されます。 Assert は条件を評価します。 結果が の場合、 false指定した診断メッセージがコレクションに Listeners 送信されます。 この動作は、コレクションに を追加 TraceListener するか、コレクションから Listeners 削除することでカスタマイズできます。

アプリケーションがユーザー インターフェイス モードで実行されているときは、ファイル番号と行番号を含む呼び出し履歴を示すメッセージ ボックスが表示されます。 メッセージ ボックスには、[ 中止]、[ 再試行]、[ 無視] の 3 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行 ] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

注意

メッセージ ボックスの表示は、 の存在 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクション内にないListeners場合、メッセージ ボックスは表示されません。 をDefaultTraceListener削除するには、 プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドをListeners呼び出します。 .NET Frameworkアプリの場合は、アプリの<構成ファイルで clear> 要素<remove> 要素を使用することもできます。

.NET Framework アプリの場合は、アプリケーションのDefaultTraceListener名前に対応する構成ファイル内の の動作を変更できます。 このファイルでは、アサート メッセージ ボックスを有効または無効にしたり、 プロパティを DefaultTraceListener.LogFileName 設定したりできます。 構成ファイルは、次のように書式設定する必要があります。

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

こちらもご覧ください

適用対象

Assert(Boolean, String, String)

条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

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
static member Assert : bool * string * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

パラメーター

condition
Boolean

評価する条件式です。 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。

message
String

Listeners コレクションに送信するメッセージ。

detailMessage
String

Listeners コレクションに送信する詳細なメッセージ。

属性

次の例では、 パラメーターが type 有効かどうかを確認します。 が のAssert場合typenull2 つのメッセージが出力されます。

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

注釈

既定では、 メソッドは Debug.Assert デバッグ ビルドでのみ機能します。 リリース ビルドで Trace.Assert アサーションを実行する場合は、 メソッドを使用します。 詳細については、「マネージド コードのアサーション」を参照してください。

通常、 メソッドは、 Assert(Boolean, String, String) プログラムの開発中にロジック エラーを識別するために使用されます。 Assert は条件を評価します。 結果が の場合、 false指定した診断メッセージと詳細メッセージがコレクションに Listeners 送信されます。 この動作は、コレクションに を追加 TraceListener するか、コレクションから Listeners 削除することでカスタマイズできます。

アプリケーションがユーザー インターフェイス モードで実行されているときは、ファイル番号と行番号を含む呼び出し履歴を示すメッセージ ボックスが表示されます。 メッセージ ボックスには、[ 中止]、[ 再試行]、[ 無視] の 3 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行 ] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

注意

メッセージ ボックスの表示は、 の存在 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクション内にないListeners場合、メッセージ ボックスは表示されません。 をDefaultTraceListener削除するには、 プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドをListeners呼び出します。 .NET Frameworkアプリの場合は、アプリの<構成ファイルで clear> 要素<remove> 要素を使用することもできます。

.NET Framework アプリの場合は、アプリケーションのDefaultTraceListener名前に対応する構成ファイル内の の動作を変更できます。 このファイルでは、アサート メッセージ ボックスを有効または無効にしたり、 プロパティを DefaultTraceListener.LogFileName 設定したりできます。 構成ファイルは、次のように書式設定する必要があります。

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

こちらもご覧ください

適用対象

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

条件をチェックし、その条件が false の場合は、2 つのメッセージ (単純なメッセージと書式設定されたメッセージ) を出力し、呼び出し履歴を表示するメッセージ ボックスを表示します。

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

パラメーター

condition
Boolean

評価する条件式です。 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。

message
String

Listeners コレクションに送信するメッセージ。

detailMessageFormat
String

Listeners コレクションに送信する複合書式指定文字列。 このメッセージのテキストには、args 配列内のオブジェクトに対応する 0 個以上の書式項目を含めることができます。

args
Object[]

0 個以上の書式設定対象オブジェクトを含んだオブジェクト配列。

属性

注釈

このメソッドでは 、.NET 複合書式設定機能を 使用して、オブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。 結果の文字列がコレクションに Listeners 送信されます。

既定では、 メソッドは Debug.Assert デバッグ ビルドでのみ機能します。 リリース ビルドで Trace.Assert アサーションを実行する場合は、 メソッドを使用します。 詳細については、「マネージド コードのアサーション」を参照してください。

通常、 メソッドは、 Assert(Boolean, String, String, Object[]) プログラムの開発中にロジック エラーを識別するために使用されます。 Assert は条件を評価します。 結果が の false場合、 String.Format(String, Object[]) メソッドが呼び出され、 detailMessageFormat 文字列と args 配列がパラメーターとして渡されます。 Assert(Boolean, String, String, Object[]) 指定したテキスト メッセージと書式設定されたテキスト メッセージをコレクションに Listeners 送信します。 この動作は、コレクションに を追加 TraceListener するか、コレクションから Listeners 削除することでカスタマイズできます。

アプリケーションがユーザー インターフェイス モードで実行されているときは、ファイル番号と行番号を含む呼び出し履歴を示すメッセージ ボックスが表示されます。 メッセージ ボックスには、[ 中止]、[ 再試行]、[ 無視] の 3 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行 ] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

注意

メッセージ ボックスの表示は、 の存在 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクション内にないListeners場合、メッセージ ボックスは表示されません。 をDefaultTraceListener削除するには、 プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で Clear メソッドをListeners呼び出します。 .NET Frameworkアプリの場合は、アプリの<構成ファイルで clear> 要素<remove> 要素を使用することもできます。

.NET Framework アプリの場合は、アプリケーションのDefaultTraceListener名前に対応する構成ファイル内の の動作を変更できます。 このファイルでは、アサート メッセージ ボックスを有効または無効にしたり、 プロパティを DefaultTraceListener.LogFileName 設定したりできます。 構成ファイルは、次のように書式設定する必要があります。

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

適用対象