EventLogInstaller.Source Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Configuration.Install.dll

Pobiera lub ustawia nazwę źródłową do zarejestrowania 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 do zarejestrowania w dzienniku zdarzeń jako źródło wpisów. Wartość domyślna to pusty ciąg ("").

Atrybuty

TypeConverterAttribute

Uwagi

Źródło zdarzeń wskazuje, co rejestruje zdarzenie. Często jest to 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 w jednym dzienniku 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 być zapisywane 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 zarejestruje 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 EventLogInstaller go do zmiany istniejącego źródła. Klasa EventLogInstaller nie modyfikuje właściwości konfiguracji istniejącego źródła tak, aby odpowiadała określonym właściwościom 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 właściwości Log i Source .

Zobacz też

• Source
• EventLog