Trace.Assert Trace.Assert Trace.Assert Trace.Assert Method

定義

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

オーバーロード

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

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

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) 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) Assert(Boolean, String, String) Assert(Boolean, String, String) 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) Assert(Boolean) Assert(Boolean) 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 Boolean Boolean 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 、または削除から、1 つ、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 つのボタンが含まれています。中止再試行、および無視します。The 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. DefaultTraceListenerして削除できる、 <オフ><削除>、または呼び出すことによって、 Clear メソッド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) Assert(Boolean, String) Assert(Boolean, String) 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 Boolean Boolean 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 String String String

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

次の例は、ことを確認するチェック、typeパラメーターは有効です。The following example checks to see that the type parameter is valid. 場合、typeが渡されたnullAssertメッセージを出力します。If 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 、または削除から、1 つ、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 つのボタンが含まれています。中止再試行、および無視します。The 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. DefaultTraceListenerして削除できる、 <オフ><削除>、または呼び出すことによって、 Clear メソッド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) Assert(Boolean, String, String) Assert(Boolean, String, String) 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 Boolean Boolean 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 String String String

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

detailMessage
String String String String

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

次の例は、ことを確認するチェック、typeパラメーターは有効です。The following example checks to see that the type parameter is valid. 場合、typeが渡されたnullAssertメッセージを出力します。If 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 、または削除から、1 つ、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 つのボタンが含まれています。中止再試行、および無視します。The 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. DefaultTraceListenerして削除できる、 <オフ><削除>、または呼び出すことによって、 Clear メソッド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>  
こちらもご覧ください

適用対象