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

업데이트: 2007년 11월

응용 프로그램의 로그 수신기에 메시지를 기록합니다.

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

매개 변수

• message
  필수적 요소입니다. 로그에 대한 메시지입니다. message가 Nothing인 경우 빈 문자열이 사용됩니다.

• severity
  메시지 형식입니다. 기본적으로 TraceEventType.Information입니다.

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

예외

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

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

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

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

설명

WriteEntry 메서드에서는 응용 프로그램의 이벤트 로그 수신기에 메시지를 기록합니다.

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

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

id 인수를 사용하지 않는 오버로드의 경우 로그에 기록된 id는 다음 표를 바탕으로 정의됩니다.

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

작업

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

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

예제

이 예제에서는 My.Application.Log.WriteEntry 메서드를 사용하여 추적 정보를 기록하는 방법을 보여 줍니다. 자세한 내용은 방법: 로그 메시지 쓰기를 참조하십시오.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( _
        "Entering TracingTest with argument " & _
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( _
        "Exiting TracingTest with argument " & _
        fileName & ".")
End Sub

이 코드 예제는 클라이언트 응용 프로그램 내에서만 실행할 수 있습니다. 웹 응용 프로그램의 경우 My.Application.Log.WriteEntry를 My.Log.WriteEntry로 변경하십시오.

요구 사항

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

클래스:Log

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

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

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

권한

다음과 같은 사용 권한이 필요할 수 있습니다.

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

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

참고 항목

작업

방법: 로그 메시지 쓰기

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

개념

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

참조

My.Application.Log 개체

My.Log 개체

System.Diagnostics.TraceEventType

Log.WriteEntry