Trace.Assert 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

檢查條件；如果條件為 false，則輸出訊息，並顯示訊息方塊，該方塊會顯示呼叫堆疊。

多載

Assert(Boolean)	檢查條件；如果條件為 false，則顯示訊息方塊，該方塊會顯示呼叫堆疊。
Assert(Boolean, String)	檢查條件；如果條件為 false，則輸出指定的訊息，並顯示訊息方塊，該方塊會顯示呼叫堆疊。
Assert(Boolean, String, String)	檢查條件；如果條件為 false，則輸出兩個指定的訊息，並顯示訊息方塊，該方塊會顯示呼叫堆疊。

Assert(Boolean)

來源:

Trace.cs

檢查條件；如果條件為 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 集合中移除一個 ，來自定義此行為。

當應用程式以使用者介面模式執行時，會顯示消息框，其中顯示具有檔案和行號的呼叫堆疊。 消息框包含三個按鈕： 中止、 重試和 忽略。 按兩下 [中止 ] 按鈕會終止應用程式。 如果應用程式是在調試程式中執行，請按兩下 [重試 ] 會將您傳送至調試程式中的程序代碼，或者如果不是，則提供開啟調試程式。 按兩下 [忽略 ] 會繼續進行程式碼中的下一個指示。

注意

消息框的顯示取決於 是否存在 DefaultTraceListener。 DefaultTraceListener如果 不在集合中Listeners，則不會顯示消息框。 DefaultTraceListener您可以呼叫 Clear 屬性上的 方法Listeners，System.Diagnostics.Trace.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)

來源:

Trace.cs

檢查條件；如果條件為 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")>]
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 集合中移除一個 ，來自定義此行為。

當應用程式以使用者介面模式執行時，會顯示消息框，其中顯示具有檔案和行號的呼叫堆疊。 消息框包含三個按鈕： 中止、 重試和 忽略。 按兩下 [中止 ] 按鈕會終止應用程式。 如果應用程式是在調試程式中執行，請按兩下 [重試 ] 會將您傳送至調試程式中的程序代碼，或者如果不是，則提供開啟調試程式。 按兩下 [忽略 ] 會繼續進行程式碼中的下一個指示。

注意

消息框的顯示取決於 是否存在 DefaultTraceListener。 DefaultTraceListener如果 不在集合中Listeners，則不會顯示消息框。 DefaultTraceListener您可以呼叫 Clear 屬性上的 方法Listeners，System.Diagnostics.Trace.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)

來源:

Trace.cs

檢查條件；如果條件為 false，則輸出兩個指定的訊息，並顯示訊息方塊，該方塊會顯示呼叫堆疊。

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")>]
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 集合中移除一個 ，來自定義此行為。

當應用程式以使用者介面模式執行時，會顯示消息框，其中顯示具有檔案和行號的呼叫堆疊。 消息框包含三個按鈕： 中止、 重試和 忽略。 按兩下 [中止 ] 按鈕會終止應用程式。 如果應用程式是在調試程式中執行，請按兩下 [重試 ] 會將您傳送至調試程式中的程序代碼，或者如果不是，則提供開啟調試程式。 按兩下 [忽略 ] 會繼續進行程式碼中的下一個指示。

注意

消息框的顯示取決於 是否存在 DefaultTraceListener。 DefaultTraceListener如果 不在集合中Listeners，則不會顯示消息框。 DefaultTraceListener您可以呼叫 Clear 屬性上的 方法Listeners，System.Diagnostics.Trace.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