Trace.Assert メソッド

定義

名前空間:: System.Diagnostics

アセンブリ:: netstandard.dll, System.Diagnostics.TraceSource.dll

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

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

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

条件を確認します。条件が false場合は、メッセージを出力し、呼び出し履歴を示すメッセージボックスを表示します。

オーバーロード

名前	説明
Assert(Boolean)	条件を確認します。条件が `false`の場合は、呼び出し履歴を示すメッセージボックスが表示されます。
Assert(Boolean, String)	条件を確認します。条件が `false`の場合は、指定したメッセージを出力し、呼び出し履歴を示すメッセージボックスを表示します。
Assert(Boolean, String, String)	条件を確認します。条件が `false`場合は、指定された 2 つのメッセージを出力し、呼び出し履歴を示すメッセージボックスを表示します。

Assert(Boolean)

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

条件を確認します。条件が falseの場合は、呼び出し履歴を示すメッセージボックスが表示されます。

public:
 static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
[System.Runtime.CompilerServices.OverloadResolutionPriority(-1)]
public static void Assert(bool condition);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition);

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

[<System.Diagnostics.Conditional("TRACE")>]
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;

void Method()
{
    // Perform some action that sets the index.

    // Test that the index value is valid.
    Trace.Assert(index > -1);
}

' Create an index for an array.
Protected index As Integer    

Protected Sub Method()
    ' Perform some action that sets the index.
    ' Test that the index value is valid. 
    Trace.Assert(index > -1)
End Sub

注釈

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

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

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

注

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

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

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

こちらもご覧ください

適用対象

Assert(Boolean, String)

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

条件を確認します。条件が falseの場合は、指定したメッセージを出力し、呼び出し履歴を示すメッセージボックスを表示します。

public:
 static void Assert(bool condition, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message = default);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string message);

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

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

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

パラメーター

condition: Boolean

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

message: String

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

属性: ConditionalAttribute

例

次の例では、 type パラメーターが有効であることを確認します。渡された type が null場合、 Assert はメッセージを出力します。

public static void MyMethod(Type type, Type baseType)
{
    Trace.Assert(type != null, "Type parameter is null");

    // Perform some processing.
}

Public Shared Sub MyMethod(type As Type, baseType As Type)
    Trace.Assert( Not (type Is Nothing), "Type parameter is null")

    ' Perform some processing.
End Sub

注釈

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

注

<configuration>
  <system.diagnostics>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

こちらもご覧ください

適用対象

Assert(Boolean, String, String)

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

ソース:: Trace.cs

条件を確認します。条件が false場合は、指定された 2 つのメッセージを出力し、呼び出し履歴を示すメッセージボックスを表示します。

public:
 static void Assert(bool condition, System::String ^ message, System::String ^ detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message, string? detailMessage);

[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string message, string detailMessage);

[<System.Diagnostics.Conditional("TRACE")>]
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 はメッセージを出力します。

public static void MyMethod(Type type, Type baseType)
{
    Trace.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)
    Trace.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>
    <switches>
      <add name="mySwitch" value="4"/>
    </switches>
    <trace autoflush="false" indentsize="4"/>
    <assert assertuienabled="true" logfilename=".\TraceLog.txt"/>
  </system.diagnostics>
</configuration>

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?

次の方法で共有

Trace.Assert メソッド

定義

オーバーロード

Assert(Boolean)

パラメーター

例

注釈

こちらもご覧ください

適用対象

Assert(Boolean, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

Assert(Boolean, String, String)

パラメーター

例

注釈

こちらもご覧ください

適用対象

フィードバック