Trace.Assert メソッド

定義

名前空間:

System.Diagnostics

アセンブリ:

System.Diagnostics.TraceSource.dll

アセンブリ:

System.dll

アセンブリ:

netstandard.dll

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

オーバーロード

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

Assert(Boolean)

条件をチェックします。条件が 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 削除することでカスタマイズできます。

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

注意

メッセージ ボックス DefaultTraceListenerの表示は、. コレクションにDefaultTraceListenerListeners存在しない場合、メッセージ ボックスは表示されません。 プロパティ 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)

条件をチェックします。条件が 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")]
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 指定されている場合は null、 Assert メッセージが出力されます。

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 削除することでカスタマイズできます。

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

注意

メッセージ ボックス DefaultTraceListenerの表示は、. コレクションにDefaultTraceListenerListeners存在しない場合、メッセージ ボックスは表示されません。 プロパティ 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)

条件をチェックします。条件が 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 )
   {
      #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 削除することでカスタマイズできます。

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

注意

メッセージ ボックス DefaultTraceListenerの表示は、. コレクションにDefaultTraceListenerListeners存在しない場合、メッセージ ボックスは表示されません。 プロパティ 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