ErrObject.Clear 方法

清除 Err 物件的所有屬性設定。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Sub Clear
'用途
Dim instance As ErrObject

instance.Clear

public void Clear ()

public:
void Clear ()

public void Clear ()

public function Clear ()

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Clear 方法 (Err 物件)。

在處理錯誤之後使用 Clear 來明確清除 Err 物件，例如當您使用 On Error Resume Next 的已擱置錯誤處理時就可這麼做。每當執行下列任何一個陳述式時，即會自動呼叫 Clear 方法：

• 任何型別的 Resume 陳述式

• Exit Sub、Exit Function 或 Exit Property

• 任何 On Error 陳述式

• 任何 Try...Catch...Finally 陳述式

  注意事項
  當處理存取其他物件的期間產生的錯誤時，On Error Resume Next 建構可能比 On Error GoTo 更適當。在每一次與物件互動之後檢查 Err，可讓程式碼存取哪一個物件的模稜兩可 (Ambiguity) 情況不再發生：您可以確定哪一個物件將錯誤碼放置在 Err.Number 中，以及原本是哪一個物件產生錯誤 (Err.Source 中指定的物件)。

範例

此範例使用 Err 物件的 Clear 方法，將 Err 物件的數值屬性重設為零，並將它的字串屬性重設為長度零的字串。在沒有呼叫 Clear 的情況下第二次呼叫 MsgBox 時，會顯示相同的錯誤訊息。

Sub ClearErr()
  ' Produce overflow error
  On Error Resume Next
  Dim zero As Integer = 0
  Dim result As Integer = 8 / zero
  MsgBox(Err.Description)
  Err.Clear()
  MsgBox(Err.Description)
End Sub

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

ErrObject 類別
ErrObject 成員
Microsoft.VisualBasic 命名空間

其他資源

Clear 方法 (Err 物件)
Err 物件 (Visual Basic)
Description 屬性 (Err 物件)
HelpContext 屬性 (Err 物件)
HelpFile 屬性 (Err 物件)
LastDllError 屬性 (Err 物件)
Number 屬性 (Err 物件)
On Error 陳述式 (Visual Basic)
Raise 方法 (Err Object)
Source 屬性 (Err 物件)
HOW TO：從 Error 物件擷取資訊