Log.WriteException 方法

参考

定义

命名空间:: Microsoft.VisualBasic.Logging

程序集:: Microsoft.VisualBasic.dll

程序集:: Microsoft.VisualBasic.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

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

WriteException(Exception)

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

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 异常。有关详细信息，请参阅如何：记录异常。

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

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

注解

方法 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 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	是

另请参阅

适用于

WriteException(Exception, TraceEventType, String)

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

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

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

示例

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

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

注解

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

在客户端应用程序中 Log ，对象通过 My.Application.Log 对象提供。在 Web 应用程序中， Log 对象通过 My.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 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	是

另请参阅

适用于

WriteException(Exception, TraceEventType, String, Int32)

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

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

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

示例

Public Sub ExceptionLogTest(ByVal fileName As String)
    Try
        ' Code that might generate an exception goes here.
        ' For example:
        '    Dim x As Object
        '    MsgBox(x.ToString)
    Catch ex As Exception
        My.Application.Log.WriteException(ex, 
            TraceEventType.Error, 
            "Exception in ExceptionLogTest " & 
            "with argument " & fileName & ".")
    End Try
End Sub

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

注解

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

在客户端应用程序中 Log ，对象通过 My.Application.Log 对象提供。在 Web 应用程序中， Log 对象通过 My.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 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	是

另请参阅

适用于

反馈

此页面是否有帮助？