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)

ソース:: Debug.cs

ソース:: Debug.cs

ソース:: Debug.cs

条件をチェックします。条件が 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 削除します。

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

注意

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

注意

メッセージボックスの表示は、の有無 DefaultTraceListenerによって異なります。 DefaultTraceListenerがコレクションにないListeners場合、メッセージボックスは表示されません。はDefaultTraceListener、プロパティ (System.Diagnostics.Trace.Listeners.Clear()) でメソッドListenersをClear呼び出すことで削除できます。 .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.cs

ソース:: Debug.cs

ソース:: Debug.cs

条件をチェックします。条件が 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)

ソース:: Debug.cs

ソース:: Debug.cs

ソース:: Debug.cs

条件をチェックします。条件が 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 有効かどうかを確認します。がのAssert場合type、nullメッセージが出力されます。

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)

ソース:: Debug.cs

ソース:: Debug.cs

ソース:: Debug.cs

条件をチェックします。条件が 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

注釈

注意

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

こちらもご覧ください

適用対象

Assert(Boolean, String, String)

ソース:: Debug.cs

ソース:: Debug.cs

ソース:: Debug.cs

条件をチェックします。条件が 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 有効かどうかを確認します。がのAssert場合type、null2 つのメッセージが出力されます。

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 削除します。

注意

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

こちらもご覧ください

適用対象

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

ソース:: Debug.cs

ソース:: Debug.cs

ソース:: Debug.cs

条件をチェックし、その条件が 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 は条件を評価します。結果がの false場合、 String.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>

適用対象

次の方法で共有

Debug.Assert メソッド

定義

オーバーロード

Assert(Boolean)

パラメーター

例

注釈

こちらもご覧ください

適用対象

Assert(Boolean, Debug+AssertInterpolatedStringHandler)

パラメーター

注釈

こちらもご覧ください

適用対象

Assert(Boolean, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

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

パラメーター

注釈

こちらもご覧ください

適用対象

Assert(Boolean, String, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

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

パラメーター

注釈

適用対象

その他のリソース