EventLog.Log 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
읽거나 쓸 로그의 이름을 가져오거나 설정합니다.
public:
property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
Public Property Log As String
속성 값
로그의 이름입니다. 애플리케이션, 시스템, 보안 또는 사용자 지정 로그 이름일 수 있습니다. 기본값은 빈 문자열("")입니다.
- 특성
예제
다음 예제에서는 로컬 컴퓨터의 이벤트 로그 "NewEventLog"에 있는 항목을 읽습니다.
using System;
using System.Diagnostics;
class MySample{
public static void Main(){
EventLog myNewLog = new EventLog();
myNewLog.Log = "NewEventLog";
foreach(EventLogEntry entry in myNewLog.Entries){
Console.WriteLine("\tEntry: " + entry.Message);
}
}
}
Imports System.Diagnostics
Class MySample
Public Shared Sub Main()
Dim myNewLog As New EventLog()
myNewLog.Log = "NewEventLog"
Dim entry As EventLogEntry
For Each entry In myNewLog.Entries
Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
Next entry
End Sub
End Class
설명
기본적으로 서버에는 애플리케이션, 시스템 및 보안이라는 세 개의 로그 파일이 있습니다. 애플리케이션 및 서비스는 애플리케이션 로그 파일을 사용합니다. 디바이스 드라이버는 시스템 로그 파일을 사용합니다. 시스템은 감사가 켜져 있을 때 보안 로그에서 성공 및 실패 감사 이벤트를 생성합니다. Windows 서버의 Active Directory와 같은 다른 애플리케이션이 설치된 경우 다른 기본 로그 파일이 있을 수 있습니다. 또한 로컬 또는 원격 컴퓨터에서 사용자 지정 로그 파일을 만들 수 있습니다. 사용자 지정 로그는 구성 요소가 기본 애플리케이션 로그에 이벤트를 쓸 때 허용되는 것보다 더 자세한 방법으로 항목을 구성하는 데 도움이 됩니다.
메모
로그 이름은 8자로 제한됩니다. 시스템에 따르면 MyLogSample1 및 MyLogSample2는 동일한 로그입니다.
이벤트 로그에 쓰는 경우 속성을 지정 Log 하는 것만으로는 충분하지 않습니다. 속성을 이벤트 로그 리소스와 연결 Source 하여 특정 로그에 연결해야 합니다. 로그에서 읽는 경우에만 지정할 Source 필요는 없지만 이벤트 원본은 서버 레지스트리의 이벤트 로그 리소스와 연결되어야 합니다. 이름 및 MachineName (서버 컴퓨터 이름)만 Log 지정하여 읽을 수 있습니다.
메모
로그에 연결하는 경우 지정할 MachineName 필요가 없습니다. 지정 MachineName하지 않으면 로컬 컴퓨터(".")가 가정됩니다.
Source 속성을 지정하지 않은 경우 속성을 설정하거나 생성자를 통해 명시적으로 설정되지 않은 경우 Log 빈 문자열을 Log 반환하는 Log 호출입니다. Source 지정된 Log 경우 해당 원본이 등록된 로그의 이름을 반환합니다.
원본은 한 번에 하나의 로그에만 등록할 수 있습니다. 인스턴스EventLog에 Source 대해 속성이 설정된 경우 값을 Source 변경하거나 먼저 호출 DeleteEventSource 하지 않고는 해당 EventLog 속성을 변경할 Log 수 없습니다. 속성이 Log 설정된 후 Source 속성을 변경하면 로그 항목을 작성하면 예외가 발생합니다.
운영 체제는 이벤트 로그를 파일로 저장합니다. 새 이벤트 로그를 사용 EventLogInstaller 하거나 CreateEventSource 만들 때 연결된 파일은 지정된 컴퓨터의 %SystemRoot%\System32\Config 디렉터리에 저장됩니다. 파일 이름은 속성의 Log 처음 8자를 ".evt" 파일 이름 확장명을 추가하여 설정합니다.
로그의 원본을 지정하지 않고는 속성만 사용하여 Log 새 로그를 만들 수 없습니다. 호출 CreateEventSource하여 새 로그 이름을 매개 변수로 전달한 다음 DeleteEventSource호출할 수 있습니다. 그러나 의도는 일반적으로 새 애플리케이션 관련 로그를 만들거나 기존 로그에서 읽기 위한 것입니다.
값이 Log 변경되면 이벤트 로그가 닫히고 모든 이벤트 핸들이 해제됩니다.
주의
존재하지 않는 로그의 이름으로 속성을 설정 Log 하면 시스템에서 애플리케이션 로그에 연결 EventLog 하지만 지정한 로그가 아닌 다른 로그를 사용 중임을 경고하지는 않습니다.