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メソッドは Windows ストアアプリでは使用できません。

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

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

注意

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

注意

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

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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 コレクションに送信するメッセージ。

属性

注釈

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

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

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

注意

メッセージボックスの表示は、の有無によって異なり DefaultTraceListener ます。 DefaultTraceListenerがコレクションに含まれていない場合 Listeners 、メッセージボックスは表示されません。 は、 DefaultTraceListener < clear > 要素または < remove > 要素によって削除するか、 Clear プロパティ () に対してメソッドを呼び出すことによって削除でき Listeners System.Diagnostics.Trace.Listeners.Clear() ます。

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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 パラメーターが有効かどうかを確認します。 がの場合 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

注釈

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

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

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

注意

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

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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 コレクションに送信する詳細なメッセージ。

属性

注釈

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

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

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

注意

メッセージボックスの表示は、の有無によって異なり DefaultTraceListener ます。 DefaultTraceListenerがコレクションに含まれていない場合 Listeners 、メッセージボックスは表示されません。 は、 DefaultTraceListener < clear > 要素または < remove > 要素によって削除するか、 Clear プロパティ () に対してメソッドを呼び出すことによって削除でき Listeners System.Diagnostics.Trace.Listeners.Clear() ます。

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

パラメーター

condition
Boolean

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

message
String

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

detailMessage
String

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

属性

次の例では、 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

注釈

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

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

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

注意

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

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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
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 条件を評価します。 結果がの場合 falseString.Format(String, Object[]) メソッドが呼び出され、 detailMessageFormat 文字列と args 配列がパラメーターとして渡されます。 Assert(Boolean, String, String, Object[]) 次に、指定したテキストメッセージと書式設定されたテキストメッセージをコレクションに送信し Listeners ます。 この動作は、コレクションにを追加し TraceListener たり、コレクションから削除したりすることによってカスタマイズでき Listeners ます。

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

注意

メッセージボックスの表示は、の存在に依存し DefaultTraceListener ます。 DefaultTraceListenerがコレクションに含まれていない場合 Listeners 、メッセージボックスは表示されません。 は、 DefaultTraceListener < clear > < remove > 、または Clear プロパティ () でメソッドを呼び出すことによって削除でき Listeners System.Diagnostics.Trace.Listeners.Clear() ます。

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

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

適用対象