Debug.Assert メソッド

定義

名前空間:: System.Diagnostics

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

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

アセンブリ:: System.Diagnostics.Debug.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

ソース:: 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")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

[<System.Diagnostics.Conditional("DEBUG")>]
static member Assert : bool -> unit

[<System.Diagnostics.Conditional("DEBUG")>]
[<System.Runtime.CompilerServices.OverloadResolutionPriority(-1)>]
static member Assert : bool -> unit

Public Shared Sub Assert (condition As Boolean)

パラメーター

condition: Boolean

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

属性: ConditionalAttribute OverloadResolutionPriorityAttribute

例

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

// 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は、Listeners プロパティ (System.Diagnostics.Trace.Listeners.Clear()) で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

ソース:: 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

ソース:: 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 = default);

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

Public Shared Sub Assert (condition As Boolean, Optional message As String = Nothing)

パラメーター

condition: Boolean

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

message: String

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

属性: ConditionalAttribute

例

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

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

ソース:: 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

ソース:: 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 パラメーターが有効かどうかを確認します。 typeがnullの場合、Assertは 2 つのメッセージを出力します。

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

ソース:: 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 コレクションに追加するか、コレクションから削除します。

注

<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[])

パラメーター

注釈

適用対象

フィードバック