共用方式為

Trace.Assert 方法

定義

命名空間:
System.Diagnostics
組件:
netstandard.dll, System.Diagnostics.TraceSource.dll
組件:
System.Diagnostics.TraceSource.dll
組件:
System.dll
組件:
netstandard.dll

檢查狀況;若條件為 false，則輸出訊息並顯示一個訊息框，顯示呼叫堆疊。

多載

名稱 Description
Assert(Boolean)

檢查狀況;若條件為 false，則會顯示一個訊息框，顯示呼叫堆疊。
Assert(Boolean, String)

檢查狀況;若條件為 false，則輸出指定訊息並顯示呼叫堆疊的訊息框。
Assert(Boolean, String, String)

檢查狀況;若條件為 false，則輸出兩個指定訊息，並顯示一個訊息框以顯示呼叫堆疊。

Assert(Boolean)

來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs

檢查狀況;若條件為 false，則會顯示一個訊息框，顯示呼叫堆疊。

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

參數

condition
Boolean

要評估的條件運算式。 若條件為 true，則不會傳送失敗訊息，訊息框也不會顯示。

屬性
ConditionalAttribute OverloadResolutionPriorityAttribute

範例

以下範例為陣列建立索引。 接著執行某個動作來設定索引的值。 接著程式碼呼叫 Assert 以驗證索引值的有效性。 如果無效，則 Assert 輸出呼叫堆疊。

// 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。 如果不在Listeners集合中，DefaultTraceListener訊息框就不會顯示。 可透過在屬性（System.Diagnostics.Trace.Listeners.Clear()）上呼叫Clear方法Listeners來移除。DefaultTraceListener 對於 .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>

另請參閱

適用於

Assert(Boolean, String)

來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs

檢查狀況;若條件為 false，則輸出指定訊息並顯示呼叫堆疊的訊息框。

public:
 static void Assert(bool condition, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public static void Assert(bool condition, string? message = default);
[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, Optional message As String = Nothing)
Public Shared Sub Assert (condition As Boolean, message As String)

參數

condition
Boolean

要評估的條件運算式。 若條件為 true，則指定訊息未被傳送，訊息框也未顯示。

message
String

要傳給 Listeners 收藏的訊息。

屬性
ConditionalAttribute

範例

以下範例檢查參數 type 是否有效。 若傳入為 typenull，則 Assert 輸出訊息。

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。 如果不在Listeners集合中，DefaultTraceListener訊息框就不會顯示。 可透過在屬性（System.Diagnostics.Trace.Listeners.Clear()）上呼叫Clear方法Listeners來移除。DefaultTraceListener 對於 .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>

另請參閱

適用於

Assert(Boolean, String, String)

來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs
來源:
Trace.cs
來源:
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")]
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 是否有效。 若傳入為 typenull，則 Assert 輸出訊息。

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。 如果不在Listeners集合中，DefaultTraceListener訊息框就不會顯示。 可透過在屬性（System.Diagnostics.Trace.Listeners.Clear()）上呼叫Clear方法Listeners來移除。DefaultTraceListener 對於 .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>

另請參閱

適用於