Debug.Assert メソッド

リファレンス

定義

名前空間:: System.Diagnostics

アセンブリ:: System.Diagnostics.Debug.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

条件をチェックします。条件が 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 の場合、エラーメッセージは送信されず、メッセージボックスは表示されません。

属性: ConditionalAttribute

例

次の例では、配列のインデックスを作成し、インデックスの値を設定するためのアクションを実行してから、インデックス値が有効であることを確認する呼び出しを実行 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 コレクションに送信するメッセージ。

属性: ConditionalAttribute

注釈

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

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

注意

<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 コレクションに送信するメッセージ。

属性: ConditionalAttribute

例

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

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

注釈

注意

<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 コレクションに送信する詳細なメッセージ。

属性: ConditionalAttribute

注釈

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

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

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

注意

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

<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

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

パラメーター

condition: Boolean

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

message: String

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

detailMessage: String

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

属性: ConditionalAttribute

例

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

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

注釈

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

注意

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

<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

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 個以上の書式設定対象オブジェクトを含んだオブジェクト配列。

属性: ConditionalAttribute

注釈

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

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

注意

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

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

適用対象