WriteException 메서드(My.Application.Log 및 My.Log)

업데이트: 2007년 11월

응용 프로그램의 로그 수신기에 예외 정보를 기록합니다.

' Usage
My.Application.Log.WriteException(ex)
My.Application.Log.WriteException(ex ,severity ,additionalInfo)
My.Application.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Web usage
My.Log.WriteException(ex)
My.Log.WriteException(ex ,severity ,additionalInfo)
My.Log.WriteException(ex ,severity ,additionalInfo ,id)
' Declaration
Public Sub WriteException( _
   ByVal ex As System.Exception _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String _
)
' -or-
Public Sub WriteException( _
   ByVal ex As System.Exception, _
   ByVal severity As System.Diagnostics.TraceEventType, _
   ByVal additionalInfo As String, _
   ByVal id As Integer _
)

매개 변수

• ex
  필수적 요소. 기록할 예외입니다.

• severity
  메시지의 형식입니다. 기본값은 Error입니다.

• additionalInfo
  메시지에 추가할 문자열입니다. 기본값은 빈 문자열입니다.

• id
  메시지 식별자입니다. 일반적으로 상관 관계에 사용됩니다. 설명 부분의 표에 설명된 것과 같이 기본적으로 entryType과 관련되어 있습니다.

예외

다음 조건에서 예외가 발생합니다.

• 예외 형식이나 메시지 형식이 Nothing인 경우(ArgumentNullException)

• 메시지 형식이 TraceEventType 열거형 값 중 하나가 아닌 경우(InvalidEnumArgumentException)

• 부분 신뢰 코드에서 메서드를 호출하지만 완전 신뢰가 필요한 이벤트 로그 수신기에 기록하는 경우(SecurityException)

설명

WriteException 메서드는 예외에 포함된 정보를 응용 프로그램의 이벤트 로그 수신기에 기록합니다.

클라이언트 응용 프로그램에서 Log 개체는 My.Application.Log 개체를 통해 사용할 수 있습니다. 웹 응용 프로그램에서 Log 개체는 My.Log 개체를 통해 사용할 수 있습니다.

WriteException 메서드의 메시지를 받는 로그 수신기를 알아보려면 연습: My.Application.Log가 정보를 기록하는 위치 확인을 참조하십시오. 기본 로그 수신기를 변경할 수 있습니다. 자세한 내용은 Visual Basic에서 응용 프로그램 로그 작업을 참조하십시오.

id 인수를 사용하지 않는 오버로드의 경우 로그에 기록된 식별자는 다음 표에 따라 정의됩니다.

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

작업

다음 표에서는 WriteException 메서드와 관련된 작업의 예를 보여 줍니다.

작업	참조
응용 프로그램의 이벤트 로그 수신기에 예외 정보 기록	방법: Visual Basic에서 예외 기록
Log가 정보를 기록하는 위치 확인	연습: My.Application.Log가 정보를 기록하는 위치 확인

예제

이 예제에서는 My.Application.Log.WriteException 메서드를 사용하여 예외를 기록하는 방법을 보여 줍니다. Dim 및 MsgBox 줄의 주석 처리를 제거하면 NullReferenceException 예외가 발생합니다. 자세한 내용은 방법: Visual Basic에서 예외 기록을 참조하십시오.

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

이 코드 예제는 클라이언트 응용 프로그램 내에서만 실행할 수 있습니다. 웹 응용 프로그램의 경우 My.Application.Log.WriteException을 My.Log.WriteException으로 변경합니다.

요구 사항

네임스페이스:Microsoft.VisualBasic.Logging

클래스:Log

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

프로젝트 형식별 사용 가능 여부

프로젝트 형식	사용 가능 여부
Windows 응용 프로그램	예
클래스 라이브러리	예
콘솔 응용 프로그램	예
Windows 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	아니요
Windows 서비스	예
웹 사이트	예

권한

다음과 같은 사용 권한이 필요합니다.

권한	설명
FileIOPermission	파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted

자세한 내용은 코드 액세스 보안 및 권한 요청을 참조하십시오.

참고 항목

작업

방법: Visual Basic에서 예외 기록

연습: My.Application.Log가 정보를 기록하는 위치 확인

개념

Visual Basic에서 응용 프로그램 로그 작업

참조

My.Application.Log 개체

My.Log 개체

System.Exception

System.Diagnostics.TraceEventType

Log.WriteException