Trace.Assert メソッド

定義

条件をチェックします。条件が 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 の場合、エラー メッセージは送信されず、メッセージ ボックスは表示されません。

属性

次の例では、配列のインデックスを作成します。 その後、インデックスの値を設定する何らかのアクションが実行されます。 次に、コードを呼び出して、 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.
 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リリースビルドでアサーションを実行する場合は、メソッドを使用します。 メソッドは、 Debug.Assert デバッグビルドでのみ機能します。 詳細については、「マネージド コードのアサーション」を参照してください。

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

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

注意

メッセージボックスの表示は、の有無によって異なり DefaultTraceListener ます。 DefaultTraceListenerがコレクションに含まれていない場合 Listeners 、メッセージボックスは表示されません。 は、 DefaultTraceListener < clear > < remove > 、または Clear プロパティ () でメソッドを呼び出すことによって削除でき Listeners System.Diagnostics.Trace.Listeners.Clear() ます。

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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)

条件をチェックします。条件が 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 コレクションに送信するメッセージ。

属性

次の例では、パラメーターが有効であることを確認し 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 ます。 DefaultTraceListenerがコレクションに含まれていない場合 Listeners 、メッセージボックスは表示されません。 は、 DefaultTraceListener < clear > < remove > 、または Clear プロパティ () でメソッドを呼び出すことによって削除でき Listeners System.Diagnostics.Trace.Listeners.Clear() ます。

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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, 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 コレクションに送信する詳細なメッセージ。

属性

次の例では、パラメーターが有効であることを確認し 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 ます。 DefaultTraceListenerがコレクションに含まれていない場合 Listeners 、メッセージボックスは表示されません。 は、 DefaultTraceListener < clear > < remove > 、または Clear プロパティ () でメソッドを呼び出すことによって削除でき Listeners System.Diagnostics.Trace.Listeners.Clear() ます。

DefaultTraceListenerアプリケーションの名前に対応する構成ファイル内のの動作を変更できます。 このファイルでは、assert メッセージボックスを有効または無効にしたり、プロパティを設定したりでき 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>  

こちらもご覧ください

適用対象