Log.WriteException 方法

定义

命名空间:

Microsoft.VisualBasic.Logging

程序集:

Microsoft.VisualBasic.Forms.dll

将异常信息写入应用程序的日志侦听器。

重载

名称	说明
WriteException(Exception)	将异常信息写入应用程序的日志侦听器。
WriteException(Exception, TraceEventType, String)	将异常信息写入应用程序的日志侦听器。
WriteException(Exception, TraceEventType, String, Int32)	将异常信息写入应用程序的日志侦听器。

WriteException(Exception)

Source:

Log.vb

将异常信息写入应用程序的日志侦听器。

public:
 void WriteException(Exception ^ ex);

public void WriteException(Exception ex);

member this.WriteException : Exception -> unit

Public Sub WriteException (ex As Exception)

参数

ex

Exception

必填。 要记录的异常。

例外

ArgumentNullException

ex 是 Nothing。

SecurityException

具有部分信任的代码调用该方法，但写入需要完全信任的事件日志侦听器。

示例

此示例演示如何使用 My.Application.Log.WriteException 该方法记录异常。 取消注释 Dim 和 MsgBox 行以引发 NullReferenceException 异常。 有关详细信息，请参阅 如何：记录异常。

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

此代码示例只能在客户端应用程序中运行。 更改为 My.Application.Log.WriteExceptionMy.Log.WriteException Web 应用程序。

注解

该方法 WriteException 将异常中包含的信息写入应用程序的事件日志侦听器。

在客户端应用程序中，该 Log 对象可通过 My.Application.Log 该对象获得。 在 Web 应用程序中，该 Log 对象可通过 My.Log 该对象获得。

若要了解哪些日志侦听器接收 WriteException 方法的消息，请参阅 演练：确定 My.Application.Log 写入信息的位置。 可以更改默认日志侦听器。 有关详细信息，请参阅 使用应用程序日志。

对于不采用参数的 id 重载，写入日志的标识符由下表定义。

severity	默认 id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

下表列出了涉及 WriteException 该方法的任务的示例。

收件人	请参阅
将异常信息写入应用程序的事件日志侦听器。	如何记录异常
确定写入信息的位置 Log 。	演练：确定 My.Application.Log 写入信息的位置

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	Yes

另请参阅

• Exception
• TraceEventType
• 对象 （Visual Basic）
• 在 Visual Basic
• 如何：在 Visual Basic
• 演练：确定 My.Application.Log 写入信息的位置

WriteException(Exception, TraceEventType, String)

Source:

Log.vb

将异常信息写入应用程序的日志侦听器。

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo);

public void WriteException(Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo);

member this.WriteException : Exception * System.Diagnostics.TraceEventType * string -> unit

Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String)

参数

ex

Exception

必填。 要记录的异常。

severity

TraceEventType

邮件类型。 默认情况下为 Error。

additionalInfo

String

要追加到消息的字符串。 默认情况下，这是一个空字符串。

例外

ArgumentNullException

ex 是 Nothing。

InvalidEnumArgumentException

消息类型不是枚举值之一 TraceEventType 。

SecurityException

具有部分信任的代码调用该方法，但写入需要完全信任的事件日志侦听器。

示例

此示例演示如何使用 My.Application.Log.WriteException 该方法记录异常。 取消注释 Dim 和 MsgBox 行以引发 NullReferenceException 异常。 有关详细信息，请参阅 如何：记录异常。

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

此代码示例只能在客户端应用程序中运行。 更改为 My.Application.Log.WriteExceptionMy.Log.WriteException Web 应用程序。

注解

该方法 WriteException 将异常中包含的信息写入应用程序的事件日志侦听器。

在客户端应用程序中，该 Log 对象可通过 My.Application.Log 该对象获得。 在 Web 应用程序中，该 Log 对象可通过 My.Log 该对象获得。

若要了解哪些日志侦听器接收 WriteException 方法的消息，请参阅 演练：确定 My.Application.Log 写入信息的位置。 可以更改默认日志侦听器。 有关详细信息，请参阅 使用应用程序日志。

对于不采用参数的 id 重载，写入日志的标识符由下表定义。

severity	默认 id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

下表列出了涉及 WriteException 该方法的任务的示例。

收件人	请参阅
将异常信息写入应用程序的事件日志侦听器。	如何记录异常
确定写入信息的位置 Log 。	演练：确定 My.Application.Log 写入信息的位置

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	Yes

另请参阅

• Exception
• TraceEventType
• 对象 （Visual Basic）
• 在 Visual Basic
• 如何：在 Visual Basic
• 演练：确定 My.Application.Log 写入信息的位置

WriteException(Exception, TraceEventType, String, Int32)

Source:

Log.vb

将异常信息写入应用程序的日志侦听器。

public:
 void WriteException(Exception ^ ex, System::Diagnostics::TraceEventType severity, System::String ^ additionalInfo, int id);

public void WriteException(Exception ex, System.Diagnostics.TraceEventType severity, string additionalInfo, int id);

member this.WriteException : Exception * System.Diagnostics.TraceEventType * string * int -> unit

Public Sub WriteException (ex As Exception, severity As TraceEventType, additionalInfo As String, id As Integer)

参数

ex

Exception

必填。 要记录的异常。

severity

TraceEventType

邮件类型。 默认情况下为 Error。

additionalInfo

String

要追加到消息的字符串。 默认情况下，这是一个空字符串。

id

Int32

消息标识符，通常用于关联。 默认情况下，与 entryType “备注”部分中的表中所述相关。

例外

ArgumentNullException

ex 是 Nothing。

InvalidEnumArgumentException

消息类型不是枚举值之一 TraceEventType 。

SecurityException

具有部分信任的代码调用该方法，但写入需要完全信任的事件日志侦听器。

示例

此示例演示如何使用 My.Application.Log.WriteException 该方法记录异常。 取消注释 Dim 和 MsgBox 行以引发 NullReferenceException 异常。 有关详细信息，请参阅 如何：记录异常。

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

此代码示例只能在客户端应用程序中运行。 更改为 My.Application.Log.WriteExceptionMy.Log.WriteException Web 应用程序。

注解

该方法 WriteException 将异常中包含的信息写入应用程序的事件日志侦听器。

在客户端应用程序中，该 Log 对象可通过 My.Application.Log 该对象获得。 在 Web 应用程序中，该 Log 对象可通过 My.Log 该对象获得。

若要了解哪些日志侦听器接收 WriteException 方法的消息，请参阅 演练：确定 My.Application.Log 写入信息的位置。 可以更改默认日志侦听器。 有关详细信息，请参阅 使用应用程序日志。

对于不采用参数的 id 重载，写入日志的标识符由下表定义。

severity	默认 id
Information	0
Warning	1
Error	2
Critical	3
Start	4
Stop	5
Suspend	6
Resume	7
Verbose	8
Transfer	9

下表列出了涉及 WriteException 该方法的任务的示例。

收件人	请参阅
将异常信息写入应用程序的事件日志侦听器。	如何记录异常
确定写入信息的位置 Log 。	演练：确定 My.Application.Log 写入信息的位置

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	Yes

另请参阅

• Exception
• TraceEventType
• 对象 （Visual Basic）
• 在 Visual Basic
• 如何：在 Visual Basic
• 演练：确定 My.Application.Log 写入信息的位置