Trace.Assert メソッド

定義

条件をチェックします。条件が false の場合、メッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs messages and displays a message box that shows the call stack.

オーバーロード

Assert(Boolean)

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String)

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String)

条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Assert(Boolean)

条件をチェックします。条件が false の場合、呼び出し履歴を見せるメッセージ ボックスを表示します。Checks for a condition; if the condition is false, displays a message box that shows the call stack.

public:
 static void Assert(bool condition);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition);
static member Assert : bool -> unit
Public Shared Sub Assert (condition As Boolean)

パラメーター

condition
Boolean

評価する条件式。The conditional expression to evaluate. 条件が true の場合、エラー メッセージは送信されず、メッセージ ボックスは表示されません。If the condition is true, a failure message is not sent and the message box is not displayed.

属性

次の例では、配列のインデックスを作成します。The following example creates an index for an array. その後、インデックスの値を設定する何らかのアクションが実行されます。Then some action is performed that sets the value of the index. 次に、コードAssertを呼び出して、インデックス値が有効であることを確認します。Next the code calls Assert to verify the index value is valid. 有効でない場合、はAssert呼び出し履歴を出力します。If it is not valid, the Assert outputs the call stack.

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.
 protected int index;
 
 protected 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でアサーションを実行する場合は、メソッドを使用します。Use the Trace.Assert method if you want to do assertions in release builds. メソッドDebug.Assertは、デバッグビルドでのみ機能します。The Debug.Assert method works only in debug builds. 詳細については、「マネージド コードのアサーション」を参照してください。For more information, see Assertions in Managed Code.

通常、メソッドAssert(Boolean)は、プログラムの開発中に論理エラーを識別するために使用されます。Typically, the Assert(Boolean) method is used to identify logic errors during program development. Assert(Boolean)条件を評価します。Assert(Boolean) evaluates the condition. 結果がの場合falseは、エラーメッセージをListenersコレクションに送信します。If the result is false, it sends a failure message to the Listeners collection. この動作は、 TraceListener Listenersコレクションにを追加したり、コレクションから削除したりすることによってカスタマイズできます。You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

アプリケーションがユーザーインターフェイスモードで実行されると、ファイルと行番号を含むコールスタックを表示するメッセージボックスが表示されます。When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. メッセージボックスには、次の3つのボタンがあります。AbortRetry、およびIgnoreThe message box contains three buttons: Abort, Retry, and Ignore. [中止] ボタンをクリックすると、アプリケーションが終了します。Clicking the Abort button terminates the application. [再試行] をクリックすると、デバッガーでアプリケーションが実行されている場合はデバッガー内のコードに送信されます。デバッガーが起動していない場合は、デバッガーが開きます。Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. [無視] をクリックすると、コード内の次の命令が続きます。Clicking Ignore continues with the next instruction in the code.

注意

メッセージボックスの表示は、 DefaultTraceListenerの有無によって異なります。The display of the message box depends on the presence of the DefaultTraceListener. DefaultTraceListenerがコレクションListenersに含まれていない場合、メッセージボックスは表示されません。If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerClear clear>、remove、またはプロパティ () でメソッドを呼び出すことによって削除できます。 < Listeners <>System.Diagnostics.Trace.Listeners.Clear()The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

アプリケーションの名前に対応する構成DefaultTraceListenerファイル内のの動作を変更できます。You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. このファイルでは、assert メッセージボックスを有効または無効にしたりDefaultTraceListener.LogFileName 、プロパティを設定したりできます。In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. 構成ファイルは次のように書式設定する必要があります。The configuration file should be formatted as follows:

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

条件をチェックします。条件が false の場合、指定したメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

public:
 static void Assert(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert (bool condition, string message);
static member Assert : bool * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String)

パラメーター

condition
Boolean

評価する条件式。The conditional expression to evaluate. 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。If the condition is true, the specified message is not sent and the message box is not displayed.

message
String

Listeners コレクションに送信するメッセージ。The message to send to the Listeners collection.

属性

次の例では、 typeパラメーターが有効であることを確認します。The following example checks to see that the type parameter is valid. 渡されたがnullの場合、 Assertはメッセージを出力します。 typeIf the type passed in is null, the Assert outputs a message.

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でアサーションを実行する場合は、メソッドを使用します。Use the Trace.Assert method if you want to do assertions in release builds. メソッドDebug.Assertは、デバッグビルドでのみ機能します。The Debug.Assert method works only in debug builds. 詳細については、「マネージド コードのアサーション」を参照してください。For more information, see Assertions in Managed Code.

通常、メソッドAssert(Boolean, String)は、プログラムの開発中に論理エラーを識別するために使用されます。Typically, the Assert(Boolean, String) method is used to identify logic errors during program development. Assert(Boolean, String)条件を評価します。Assert(Boolean, String) evaluates the condition. 結果がの場合falseは、指定された診断メッセージをListenersコレクションに送信します。If the result is false, it sends the specified diagnostic message to the Listeners collection. この動作は、 TraceListener Listenersコレクションにを追加したり、コレクションから削除したりすることによってカスタマイズできます。You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

アプリケーションがユーザーインターフェイスモードで実行されると、ファイルと行番号を含むコールスタックを表示するメッセージボックスが表示されます。When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. メッセージボックスには、次の3つのボタンがあります。AbortRetry、およびIgnoreThe message box contains three buttons: Abort, Retry, and Ignore. [中止] ボタンをクリックすると、アプリケーションが終了します。Clicking the Abort button terminates the application. [再試行] をクリックすると、デバッガーでアプリケーションが実行されている場合はデバッガー内のコードに送信されます。デバッガーが起動していない場合は、デバッガーが開きます。Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. [無視] をクリックすると、コード内の次の命令が続きます。Clicking Ignore continues with the next instruction in the code.

注意

メッセージボックスの表示は、 DefaultTraceListenerの有無によって異なります。The display of the message box depends on the presence of the DefaultTraceListener. DefaultTraceListenerがコレクションListenersに含まれていない場合、メッセージボックスは表示されません。If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerClear clear>、remove、またはプロパティ () でメソッドを呼び出すことによって削除できます。 < Listeners <>System.Diagnostics.Trace.Listeners.Clear()The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

アプリケーションの名前に対応する構成DefaultTraceListenerファイル内のの動作を変更できます。You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. このファイルでは、assert メッセージボックスを有効または無効にしたりDefaultTraceListener.LogFileName 、プロパティを設定したりできます。In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. 構成ファイルは次のように書式設定する必要があります。The configuration file should be formatted as follows:

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

条件をチェックします。条件が false の場合、指定した 2 つのメッセージを出力し、コール スタックを示すメッセージ ボックスを表示します。Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

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);
static member Assert : bool * string * string -> unit
Public Shared Sub Assert (condition As Boolean, message As String, detailMessage As String)

パラメーター

condition
Boolean

評価する条件式。The conditional expression to evaluate. 条件が true の場合、指定したメッセージは送信されず、メッセージ ボックスは表示されません。If the condition is true, the specified messages are not sent and the message box is not displayed.

message
String

Listeners コレクションに送信するメッセージ。The message to send to the Listeners collection.

detailMessage
String

Listeners コレクションに送信する詳細なメッセージ。The detailed message to send to the Listeners collection.

属性

次の例では、 typeパラメーターが有効であることを確認します。The following example checks to see that the type parameter is valid. 渡されたがnullの場合、 Assertはメッセージを出力します。 typeIf the type passed in is null, the Assert outputs a message.

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でアサーションを実行する場合は、メソッドを使用します。Use the Trace.Assert method if you want to do assertions in release builds. メソッドDebug.Assertは、デバッグビルドでのみ機能します。The Debug.Assert method works only in debug builds. 詳細については、「マネージド コードのアサーション」を参照してください。For more information, see Assertions in Managed Code.

通常、メソッドAssert(Boolean, String, String)は、プログラムの開発中に論理エラーを識別するために使用されます。Typically, the Assert(Boolean, String, String) method is used to identify logic errors during program development. Assert条件を評価します。Assert evaluates the condition. 結果がの場合falseは、指定された診断メッセージと詳細メッセージをListenersコレクションに送信します。If the result is false, it sends the specified diagnostic message and detailed message to the Listeners collection. この動作は、 TraceListener Listenersコレクションにを追加したり、コレクションから削除したりすることによってカスタマイズできます。You can customize this behavior by adding a TraceListener to, or removing one from, the Listeners collection.

アプリケーションがユーザーインターフェイスモードで実行されると、ファイルと行番号を含むコールスタックを表示するメッセージボックスが表示されます。When the application runs in user-interface mode, it displays a message box that shows the call stack with file and line numbers. メッセージボックスには、次の3つのボタンがあります。AbortRetry、およびIgnoreThe message box contains three buttons: Abort, Retry, and Ignore. [中止] ボタンをクリックすると、アプリケーションが終了します。Clicking the Abort button terminates the application. [再試行] をクリックすると、デバッガーでアプリケーションが実行されている場合はデバッガー内のコードに送信されます。デバッガーが起動していない場合は、デバッガーが開きます。Clicking Retry sends you to the code in the debugger if your application is running in a debugger, or offers to open a debugger if it is not. [無視] をクリックすると、コード内の次の命令が続きます。Clicking Ignore continues with the next instruction in the code.

注意

メッセージボックスの表示は、 DefaultTraceListenerの有無によって異なります。The display of the message box depends on the presence of the DefaultTraceListener. DefaultTraceListenerがコレクションListenersに含まれていない場合、メッセージボックスは表示されません。If the DefaultTraceListener is not in the Listeners collection, the message box is not displayed. DefaultTraceListenerClear clear>、remove、またはプロパティ () でメソッドを呼び出すことによって削除できます。 < Listeners <>System.Diagnostics.Trace.Listeners.Clear()The DefaultTraceListener can be removed by the <clear>, the <remove>, or by calling the Clear method on the Listeners property (System.Diagnostics.Trace.Listeners.Clear()).

アプリケーションの名前に対応する構成DefaultTraceListenerファイル内のの動作を変更できます。You can change the behavior of the DefaultTraceListener in the configuration file that corresponds to the name of your application. このファイルでは、assert メッセージボックスを有効または無効にしたりDefaultTraceListener.LogFileName 、プロパティを設定したりできます。In this file, you can enable and disable the assert message box or set the DefaultTraceListener.LogFileName property. 構成ファイルは次のように書式設定する必要があります。The configuration file should be formatted as follows:

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

こちらもご覧ください

適用対象