EventLogTraceListener Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Pakiet:

System.Diagnostics.EventLog v8.0.0

Źródło:

EventLogTraceListener.cs

Udostępnia prosty odbiornik kierujący śledzenie lub debugowanie danych wyjściowych do elementu EventLog.

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener

public sealed class EventLogTraceListener : System.Diagnostics.TraceListener

type EventLogTraceListener = class
    inherit TraceListener

Public NotInheritable Class EventLogTraceListener
Inherits TraceListener

Dziedziczenie

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

Przykłady

Poniższy przykład tworzy odbiornik śledzenia, który wysyła dane wyjściowe do dziennika zdarzeń. Najpierw kod tworzy nowy EventLogTraceListener , który używa źródła myEventLogSource. myTraceListener Następnie zostanie dodany do kolekcjiTrace.Listeners. Na koniec przykład wysyła wiersz danych wyjściowych do Listeners obiektu.

int main()
{
   #if defined(TRACE)
   
   // Create a trace listener for the event log.
   EventLogTraceListener^ myTraceListener = 
      gcnew EventLogTraceListener( "myEventLogSource" );
   
   // Add the event log trace listener to the collection.
   Trace::Listeners->Add( myTraceListener );
   
   // Write output to the event log.
   Trace::WriteLine( "Test output" );
   
   #endif
}

// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");

// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);

// Write output to the event log.
Trace.WriteLine("Test output");

Overloads Public Shared Sub Main(args() As String)
   
    ' Create a trace listener for the event log.
    Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
    
    ' Add the event log trace listener to the collection.
    Trace.Listeners.Add(myTraceListener)
    
    ' Write output to the event log.
    Trace.WriteLine("Test output")
End Sub

Uwagi

Wystąpienie tej EventLogTraceListener funkcji można dodać do Debug.Listenerskolekcji , Trace.Listenerslub TraceSource.Listeners do wysyłania danych wyjściowych z śledzenia lub debugowania do obiektu EventLog. Możesz dodać wystąpienie w kodzie lub w przypadku aplikacji .NET Framework określić je w pliku konfiguracji aplikacji.

Aby dodać EventLogTraceListener plik konfiguracji aplikacji przy użyciu .NET Framework, zmodyfikuj plik odpowiadający nazwie aplikacji. W tym pliku wstaw element dla System.Diagnostics.EventLogTraceListener typu. Poniższy przykład dodaje EventLogTraceListener obiekt o nazwie myListener do kolekcji Trace.Listeners . Parametr initializeData określa nazwę źródła dziennika zdarzeń, które ma zostać przekazane do konstruktora EventLogTraceListener(String) .

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"  
          type="System.Diagnostics.EventLogTraceListener"  
          initializeData="TraceListenerLog" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Uwaga

Source Jeśli dla dziennika zdarzeń skojarzonego EventLogTraceListener z wystąpieniem nie istnieje, zostanie utworzone nowe źródło zdarzeń. Aby utworzyć źródło zdarzeń w systemie Windows Vista, Windows XP Professional lub Windows Server 2003, musisz mieć uprawnienia administracyjne.

Przyczyną tego wymagania jest to, że wszystkie dzienniki zdarzeń, w tym zabezpieczenia, muszą być przeszukane, aby określić, czy źródło zdarzeń jest unikatowe. W systemie Windows Vista użytkownicy nie mają uprawnień dostępu do dziennika zabezpieczeń; w związku z SecurityException tym zgłaszana jest wartość .

W systemie Windows Vista kontrola konta użytkownika (UAC) określa uprawnienia użytkownika. Jeśli jesteś członkiem wbudowanej grupy Administratorzy, masz przypisane dwa tokeny dostępu w czasie wykonywania: token dostępu użytkownika standardowego i token dostępu administratora. Domyślnie jesteś w roli użytkownika standardowego. Aby wykonać kod, który uzyskuje dostęp do dziennika zabezpieczeń, musisz najpierw podnieść poziom uprawnień od użytkownika standardowego do administratora. Możesz to zrobić po uruchomieniu aplikacji, klikając prawym przyciskiem myszy ikonę aplikacji i wskazując, że chcesz uruchomić jako administrator.

Klasa udostępnia EventLog właściwość , aby pobrać lub ustawić dziennik zdarzeń, który odbiera dane wyjściowe śledzenia lub debugowania, oraz Name właściwość do przechowywania nazwy EventLogTraceListener.

Metoda Close zamyka dziennik zdarzeń, aby nie odbierał już danych wyjściowych śledzenia ani debugowania. Metody Write i WriteLine zapisują komunikat w dzienniku zdarzeń.

Uwaga

Aby uniknąć możliwości zapisywania dużych ilości danych w dzienniku zdarzeń, EventLogTraceListener funkcja nie generuje opcjonalnych danych śledzenia określonych przez TraceOutputOptions właściwość.

Konstruktory

EventLogTraceListener()	Inicjuje EventLogTraceListener nowe wystąpienie klasy bez odbiornika śledzenia.
EventLogTraceListener(EventLog)	Inicjuje EventLogTraceListener nowe wystąpienie klasy przy użyciu określonego dziennika zdarzeń.
EventLogTraceListener(String)	Inicjuje EventLogTraceListener nowe wystąpienie klasy przy użyciu określonego źródła.

Właściwości

Attributes	Pobiera niestandardowe atrybuty odbiornika śledzenia zdefiniowane w pliku konfiguracji aplikacji. (Odziedziczone po TraceListener)
EventLog	Pobiera lub ustawia dziennik zdarzeń do zapisu.
Filter	Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia. (Odziedziczone po TraceListener)
IndentLevel	Pobiera lub ustawia poziom wcięcia. (Odziedziczone po TraceListener)
IndentSize	Pobiera lub ustawia liczbę spacji w wcięcie. (Odziedziczone po TraceListener)
IsThreadSafe	Pobiera wartość wskazującą, czy odbiornik śledzenia jest bezpieczny wątkiem. (Odziedziczone po TraceListener)
Name	Pobiera lub ustawia nazwę tego EventLogTraceListenerelementu .
NeedIndent	Pobiera lub ustawia wartość wskazującą, czy należy wciąć dane wyjściowe. (Odziedziczone po TraceListener)
TraceOutputOptions	Pobiera lub ustawia opcje danych wyjściowych śledzenia. (Odziedziczone po TraceListener)

Metody

Close()	Zamyka dziennik zdarzeń, aby nie odbierał już danych wyjściowych śledzenia ani debugowania.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element TraceListener. (Odziedziczone po TraceListener)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element TraceListener i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po TraceListener)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Fail(String)	Emituje komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Fail(String, String)	Emituje komunikat o błędzie i szczegółowy komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Flush()	Po przesłonięciu w klasie pochodnej opróżni bufor wyjściowy. (Odziedziczone po TraceListener)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetSupportedAttributes()	Pobiera atrybuty niestandardowe obsługiwane przez odbiornik śledzenia. (Odziedziczone po TraceListener)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapisuje informacje dotyczące śledzenia, obiektu danych i informacji o zdarzeniach w dzienniku zdarzeń.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informacje śledzenia, tablicę obiektów danych i informacje o zdarzeniach w dzienniku zdarzeń.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapisuje informacje dotyczące śledzenia i zdarzeń do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapisuje informacje dotyczące śledzenia, komunikatu i informacji o zdarzeniach w dzienniku zdarzeń.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje informacje śledzenia, sformatowaną tablicę obiektów i informacje o zdarzeniach w dzienniku zdarzeń.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapisuje informacje dotyczące śledzenia, komunikatu, powiązanej tożsamości działania i informacji o zdarzeniach do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
Write(Object)	Zapisuje wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Write(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Write(String)	Zapisuje komunikat w dzienniku zdarzeń dla tego wystąpienia.
Write(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
WriteIndent()	Zapisuje wcięcie do odbiornika utworzonego podczas implementowania tej klasy i resetuje NeedIndent właściwość do false. (Odziedziczone po TraceListener)
WriteLine(Object)	Zapisuje wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(String)	Zapisuje komunikat w dzienniku zdarzeń dla tego wystąpienia.
WriteLine(String, String)	Zapisuje nazwę kategorii i komunikat do odbiornika utworzonego podczas implementowania TraceListener klasy, po którym następuje terminator wiersza. (Odziedziczone po TraceListener)

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkowo.

Zobacz też

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• EventLog
• Stream
• TextWriter
• Debug
• Trace