Trace.Assert メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.TraceSource.dll

条件をチェックします。条件が false の場合、メッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

オーバーロード

Assert(Boolean)	条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。
Assert(Boolean, String)	条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。
Assert(Boolean, String, String)	条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

Assert(Boolean)

ソース:

Trace.cs

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。

public:
 static void Assert(bool condition);

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

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

Public Shared Sub Assert (condition As Boolean)

パラメーター

condition

Boolean

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

属性

ConditionalAttribute

例

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

protected:
   // Create an index for an array.
   int index;

   void Method()
   {
      // Perform some action that sets the index.
      // Test that the index value is valid.
      #if defined(TRACE)
      Trace::Assert( index > -1 );
      #endif
   }

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

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

注意

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

こちらもご覧ください

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Assert(Boolean, String)

ソース:

Trace.cs

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。

public:
 static void Assert(bool condition, System::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, message As String)

パラメーター

condition

Boolean

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

message

String

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

属性

ConditionalAttribute

例

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

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
     #if defined(TRACE)
     Trace::Assert( type != nullptr, "Type parameter is null" );
     #endif
      
      // Perform some processing.
   }

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

注釈

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

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

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

注意

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

こちらもご覧ください

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute

Assert(Boolean, String, String)

ソース:

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")>]
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 の場合、nullAssertメッセージが出力されます。

public:
   static void MyMethod( Type^ type, Type^ baseType )
   {
      #if defined(TRACE)
      Trace::Assert( type != nullptr, "Type parameter is null", "Can't get object for null type" );
      #endif
      
      // Perform some processing.
   }

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

注釈

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

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

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

注意

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

こちらもご覧ください

• Debug
• Trace
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConditionalAttribute