EventLogTraceListener.TraceData 메서드

정의

네임스페이스:

System.Diagnostics

어셈블리:

System.Diagnostics.EventLog.dll

패키지:

System.Diagnostics.EventLog v8.0.0

이벤트 로그에 추적 데이터를 씁니다.

오버로드

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	추적 정보, 데이터 개체 및 이벤트 정보를 이벤트 로그에 씁니다.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	추적 정보, 데이터 개체 배열 및 이벤트 정보를 이벤트 로그에 씁니다.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Source:

EventLogTraceListener.cs

추적 정보, 데이터 개체 및 이벤트 정보를 이벤트 로그에 씁니다.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

매개 변수

eventCache

TraceEventCache

현재 프로세스 ID, 스레드 ID 및 스택 추적 정보가 포함된 개체입니다.

source

String

출력을 식별하는 데 사용되는 이름이며 일반적으로 추적 이벤트를 생성한 애플리케이션의 이름입니다.

severity

TraceEventType

추적이 발생한 이벤트의 형식을 지정하는 열거형 값 중 하나입니다.

id

Int32

이벤트의 숫자 식별자입니다. source와 id의 조합은 이벤트를 고유하게 식별합니다.

data

Object

출력 파일이나 스트림에 쓸 데이터 개체입니다.

특성

ComVisibleAttribute

예외

ArgumentException

source을(를) 지정하지 않았습니다.

또는

로그 엔트리 문자열이 32,766자를 초과합니다.

설명

중요

TraceData 메서드는 애플리케이션 코드에서 호출할 수 없습니다. 추적 데이터를 출력하기 위해 , Trace및 TraceSource 클래스의 Debug메서드에 의해 호출됩니다.

TraceData 메서드와 같은 TraceEvent 메서드는 자동화된 도구를 위한 것이지만 추가 개체(예: 예외 instance)를 추적에 연결할 수도 있습니다.

eventCache 및 source 매개 변수는 이벤트를 추적해야 하는지 여부를 결정하는 데 사용됩니다. id는 개체를 EventInstance 만드는 데 사용되며 TraceEventType 은 속성에 EntryType 대한 와 EventLogEntryType 동일시됩니다. EventInstance 은 메서드를 사용하여 문자열 형식의 data 개체를 사용하여 이벤트 로그에 WriteEvent 기록됩니다.

참고

매개 변수의 id 최대값은 65,535입니다. 지정된 값이 id 65,535보다 크면 최대값이 사용됩니다.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Source:

EventLogTraceListener.cs

추적 정보, 데이터 개체 배열 및 이벤트 정보를 이벤트 로그에 씁니다.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, ... cli::array <System::Object ^> ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, params object[] data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

매개 변수

eventCache

TraceEventCache

현재 프로세스 ID, 스레드 ID 및 스택 추적 정보가 포함된 개체입니다.

source

String

출력을 식별하는 데 사용되는 이름이며 일반적으로 추적 이벤트를 생성한 애플리케이션의 이름입니다.

severity

TraceEventType

추적이 발생한 이벤트의 형식을 지정하는 열거형 값 중 하나입니다.

id

Int32

이벤트의 숫자 식별자입니다. source와 id의 조합은 이벤트를 고유하게 식별합니다.

data

Object[]

데이터 개체로 이루어진 배열입니다.

특성

ComVisibleAttribute

예외

ArgumentException

source을(를) 지정하지 않았습니다.

또는

로그 엔트리 문자열이 32,766자를 초과합니다.

설명

중요

TraceData 메서드는 애플리케이션 코드에서 호출할 수 없습니다. 추적 데이터를 출력하기 위해 , Trace및 TraceSource 클래스의 Debug메서드에 의해 호출됩니다.

TraceData 메서드와 같은 TraceEvent 메서드는 자동화된 도구를 위한 것이지만 추가 개체(예: 예외 instance)를 추적에 연결할 수도 있습니다.

severity 및 id 매개 변수 데이터는 데이터 개체 배열의 데이터와 함께 이벤트 로그에 기록되는 개체를 만드는 EventInstance 데 사용됩니다.

eventCache 및 source 매개 변수는 이벤트를 추적해야 하는지 여부를 결정하는 데 사용됩니다. id는 개체를 EventInstance 만드는 데 사용되며 TraceEventType 은 속성에 EntryType 대한 와 EventLogEntryType 동일시됩니다. 는 EventInstance 메서드를 사용하여 문자열 배열로 형식이 지정된 개체 배열을 사용하여 이벤트 로그 data 에 WriteEvent 기록됩니다.

참고

매개 변수의 id 최대값은 65,535입니다. 지정된 값이 id 65,535보다 크면 최대값이 사용됩니다.