다음을 통해 공유


TraceSource.TraceEvent 메서드

정의

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

오버로드

TraceEvent(TraceEventType, Int32)

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

TraceEvent(TraceEventType, Int32, String)

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

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

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

TraceEvent(TraceEventType, Int32)

Source:
TraceSource.cs
Source:
TraceSource.cs
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

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

특성

예외

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

예제

다음 코드 예제에서는 메서드를 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
Source:
TraceSource.cs
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")]
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

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

특성

예외

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

예제

다음 코드 예제에서는 메서드를 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
Source:
TraceSource.cs
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")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params 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 배열입니다.

특성

예외

format이(가) null인 경우

format이 잘못되었습니다.

또는

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

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

예제

다음 코드 예제에서는 메서드를 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를 사용합니다.

추가 정보

적용 대상