EventLogInstaller.Source Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Configuration.Install.dll

Pobiera lub ustawia nazwę źródła, aby zarejestrować się w dzienniku.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set

Public Property Source As String

Wartość właściwości

String

Nazwa rejestrowania w dzienniku zdarzeń jako źródło wpisów. Wartością domyślną jest ciąg pusty ("").

Atrybuty

TypeConverterAttribute

Uwagi

Źródło zdarzeń wskazuje, co rejestruje zdarzenie. Jest to często nazwa aplikacji lub nazwa składnika w dużej aplikacji.

Instalator używa wartości Source właściwości do zarejestrowania aplikacji w dzienniku zdarzeń jako prawidłowego źródła wpisów. Nowa nazwa źródła nie może być zgodna z istniejącą nazwą źródła lub istniejącą nazwą dziennika zdarzeń. Każde źródło może zapisywać tylko jeden dziennik zdarzeń jednocześnie; Jednak aplikacja może używać wielu źródeł do zapisywania w wielu dziennikach zdarzeń. Na przykład aplikacja może wymagać wielu źródeł skonfigurowanych dla różnych dzienników zdarzeń lub różnych plików zasobów.

Aplikacje i usługi powinny zapisywać w dzienniku aplikacji lub dzienniku niestandardowym. Sterowniki urządzeń powinny zapisywać w dzienniku systemu. Jeśli nie określisz nazwy dziennika przed uruchomieniem instalatora, instalator zarejestruje źródło w dzienniku aplikacji. Jeśli określisz nazwę dziennika, który nie istnieje, system rejestruje Source go w tym dzienniku, ale dziennik nie zostanie utworzony, dopóki pierwszy wpis nie zostanie do niego zapisany.

Użyj EventLogInstaller polecenia , aby zarejestrować nowe źródło dla nowego lub istniejącego dziennika zdarzeń; nie używaj polecenia EventLogInstaller , aby zmienić istniejące źródło. Klasa EventLogInstaller nie modyfikuje właściwości konfiguracji istniejącego źródła w celu dopasowania do określonych właściwości instalacji. Metoda Install zgłasza wyjątek, jeśli Source właściwość jest zgodna z nazwą źródłową zarejestrowaną dla innego dziennika zdarzeń na komputerze. Metoda Install nie rejestruje źródła, jeśli Source właściwość jest zgodna z nazwą źródłową, która jest już zarejestrowana dla tego samego dziennika zdarzeń określonego Log we właściwości.

Aby uzyskać bardziej szczegółowe informacje na temat zachowań dzienników zdarzeń i źródeł, zobacz dokumentację EventLog klasy dla Log właściwości i Source .

Zobacz też

• Source
• EventLog