TraceSource.TraceEvent 메서드

정의

네임스페이스:

System.Diagnostics

어셈블리:

System.Diagnostics.TraceSource.dll

Listeners 컬렉션의 추적 수신기에 추적 이벤트 메시지를 씁니다.

오버로드

TraceEvent(TraceEventType, Int32)	지정된 이벤트 형식 및 이벤트 식별자를 사용하여 Listeners 컬렉션의 추적 수신기에 추적 이벤트 메시지를 씁니다.
TraceEvent(TraceEventType, Int32, String)	지정된 이벤트 형식, 이벤트 식별자 및 메시지를 사용하여 Listeners 컬렉션의 추적 수신기에 추적 이벤트 메시지를 씁니다.
TraceEvent(TraceEventType, Int32, String, Object[])	지정된 이벤트 형식, 이벤트 식별자, 인수 배열 및 형식을 사용하여 Listeners 컬렉션의 추적 수신기에 추적 이벤트를 씁니다.

TraceEvent(TraceEventType, Int32)

Source:

TraceSource.cs

지정된 이벤트 형식 및 이벤트 식별자를 사용하여 Listeners 컬렉션의 추적 수신기에 추적 이벤트 메시지를 씁니다.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

매개 변수

eventType

TraceEventType

추적 데이터의 이벤트를 지정하는 열거형 값 중 하나입니다.

id

Int32

이벤트의 숫자 식별자입니다.

특성

ConditionalAttribute

예외

ObjectDisposedException

종료하는 동안 이벤트를 추적하려고 했습니다.

예제

다음 코드 예제에서는 메서드를 TraceEvent(TraceEventType, Int32) 사용하여 추적 이벤트를 수신기에 전달하는 방법을 보여줍니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 TraceSource 클래스입니다.

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

설명

메서드는 TraceEvent 도구에서 자동으로 처리할 수 있는 이벤트를 추적하기 위한 것입니다. 예를 들어 모니터링 도구는 특정 이벤트가 특정 원본에 의해 추적되는 경우 관리자에게 알릴 수 있습니다.

메서드는 TraceEvent 속성에서 ShouldTrace 반환된 개체의 SourceSwitch 메서드를 호출합니다 Switch . 가 를 반환 TraceEventtrue하는 경우 ShouldTrace 각 수신기의 해당 TraceEvent 메서드를 호출합니다. 그렇지 않으면 는 TraceEvent 수신기의 메서드를 호출하지 않고 를 반환합니다.

추적 콘텐츠는 수신기별로 다릅니다. 메서드가 수신기 구현에 의해 재정의되지 않은 경우 기본 출력은 추적 원본의 이름, 숫자 ID 및 이벤트 유형입니다. 추가 추적 콘텐츠는 수신기의 TraceOutputOptions 속성 값에 따라 달라집니다.

참고

개체의 EventLogTraceListener 최대 id 값은 65,535로 제한됩니다. 지정된 값이 id 65,535보다 큰 경우 는 EventLogTraceListener 65,535를 사용합니다.

TraceEvent(TraceEventType, Int32, String)

Source:

TraceSource.cs

지정된 이벤트 형식, 이벤트 식별자 및 메시지를 사용하여 Listeners 컬렉션의 추적 수신기에 추적 이벤트 메시지를 씁니다.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

매개 변수

eventType

TraceEventType

추적 데이터의 이벤트를 지정하는 열거형 값 중 하나입니다.

id

Int32

이벤트의 숫자 식별자입니다.

message

String

기록할 추적 메시지입니다.

특성

ConditionalAttribute

예외

ObjectDisposedException

종료하는 동안 이벤트를 추적하려고 했습니다.

예제

다음 코드 예제에서는 메서드를 TraceEvent(TraceEventType, Int32) 사용하여 추적 이벤트를 수신기에 전달하는 방법을 보여줍니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 TraceSource 클래스입니다.

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");

' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

설명

메서드는 TraceEvent 도구에서 자동으로 처리할 수 있는 이벤트를 추적하기 위한 것입니다. 예를 들어 모니터링 도구는 특정 이벤트가 특정 원본에 의해 추적되는 경우 관리자에게 알릴 수 있습니다.

메서드는 TraceEvent 속성에서 ShouldTrace 반환된 개체의 SourceSwitch 메서드를 호출합니다 Switch . 가 를 반환 TraceEventtrue하는 경우 ShouldTrace 각 수신기의 해당 TraceEvent 메서드를 호출합니다. 그렇지 않으면 는 TraceEvent 수신기의 메서드를 호출하지 않고 를 반환합니다.

추적 콘텐츠는 수신기별로 다릅니다. 메서드가 수신기 구현에 의해 재정의되지 않은 경우 기본 출력은 추적 원본의 이름, 숫자 ID, 이벤트 유형 및 메시지입니다. 추가 추적 콘텐츠는 수신기의 TraceOutputOptions 속성 값에 따라 달라집니다.

참고

개체의 EventLogTraceListener 최대 id 값은 65,535로 제한됩니다. 지정된 값이 id 65,535보다 큰 경우 개체는 EventLogTraceListener 65,535를 사용합니다.

TraceEvent(TraceEventType, Int32, String, Object[])

Source:

TraceSource.cs

지정된 이벤트 형식, 이벤트 식별자, 인수 배열 및 형식을 사용하여 Listeners 컬렉션의 추적 수신기에 추적 이벤트를 씁니다.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

매개 변수

eventType

TraceEventType

추적 데이터의 이벤트를 지정하는 열거형 값 중 하나입니다.

id

Int32

이벤트의 숫자 식별자입니다.

format

String

args 배열의 개체에 해당하는 0개 이상의 형식 항목과 결합된 텍스트를 포함하는 복합 형식 문자열입니다.

args

Object[]

형식을 지정할 개체가 0개 이상 포함된 object 배열입니다.

특성

ConditionalAttribute

예외

ArgumentNullException

format이(가) null인 경우

FormatException

format이 잘못되었습니다.

또는

형식을 지정할 인수를 나타내는 숫자가 0보다 작거나, 형식을 지정할 해당 개체의 수보다 크거나 같은 경우

ObjectDisposedException

종료하는 동안 이벤트를 추적하려고 했습니다.

예제

다음 코드 예제에서는 메서드를 TraceEvent(TraceEventType, Int32) 사용하여 추적 이벤트를 수신기에 전달하는 방법을 보여줍니다. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 TraceSource 클래스입니다.

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");

' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

설명

매개 변수에 format 대한 자세한 내용은 복합 서식 지정을 참조하세요.

메서드는 TraceEvent 도구에서 자동으로 처리할 수 있는 이벤트를 추적하기 위한 것입니다. 예를 들어 모니터링 도구는 특정 이벤트가 특정 원본에 의해 추적되는 경우 관리자에게 알릴 수 있습니다.

메서드는 TraceEvent 속성에서 ShouldTrace 반환된 개체의 SourceSwitch 메서드를 호출합니다 Switch . 가 를 반환 TraceEventtrue하는 경우 ShouldTrace 각 수신기의 해당 TraceEvent 메서드를 호출합니다. 그렇지 않으면 는 TraceEvent 수신기의 메서드를 호출하지 않고 를 반환합니다.

추적 콘텐츠는 수신기별로 다릅니다. 기본 TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) 메서드는 추적 헤더에 원본 이름, 이벤트 형식 및 숫자 ID를 쓴 다음 메서드를 호출 String.Format(IFormatProvider, String, Object[]) 하여 문자열 및 배열을 전달 format 하고 args 속성을 사용하여 CultureInfo.InvariantCulture 문자열을 메시지 출력으로 형식 지정합니다.

참고

개체의 EventLogTraceListener 최대 id 값은 65,535로 제한됩니다. 지정된 값이 id 65,535보다 큰 경우 개체는 EventLogTraceListener 65,535를 사용합니다.

추가 정보

• 복합 형식 지정
• 표준 숫자 형식 문자열
• 사용자 지정 숫자 형식 문자열
• 표준 DateTime 형식 문자열
• 사용자 지정 DateTime 형식 문자열
• 열거형 형식 문자열
• .NET의 서식 지정 형식