Trace.Assert メソッド

ソース:

Trace.cs

ソース:

Trace.cs

ソース:

Trace.cs

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)

パラメーター

属性

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 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

.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

ソース:

Trace.cs

ソース:

Trace.cs

ソース:

Trace.cs

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)

パラメーター

属性

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 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

.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

ソース:

Trace.cs

ソース:

Trace.cs

ソース:

Trace.cs

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)

パラメーター

属性

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 つのボタンが含まれています。 [ 中止 ] ボタンをクリックすると、アプリケーションが終了します。 [ 再試行] をクリックすると、アプリケーションがデバッガーで実行されている場合はデバッガーのコードに移動し、実行されていない場合はデバッガーを開くことを提供します。 [無視] をクリックすると、コード内の次の命令が続行されます。

.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