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 服务	是
网站	是

另请参阅

适用于

通过

Log.WriteException 方法

定义

重载

WriteException(Exception)

参数

例外

示例

注解

可用性（按项目类型）

另请参阅

适用于

WriteException(Exception, TraceEventType, String)

参数

例外

示例

注解

可用性（按项目类型）

另请参阅

适用于

WriteException(Exception, TraceEventType, String, Int32)

参数

例外

示例

注解

可用性（按项目类型）

另请参阅

适用于

其他资源