EventLogInstaller.Source Właściwość

Definicja

Pobiera lub ustawia nazwę źródła do zarejestrowania w dzienniku.Gets or sets the source name to register with the log.

public:
 property System::String ^ Source { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Source { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.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")]
public string Source { get; set; }
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Source : string with 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, która ma zostać zarejestrowana w dzienniku zdarzeń jako źródło wpisów.The name to register with the event log as a source of entries. Wartością domyślną jest ciąg pusty ("").The default is an empty string ("").

Atrybuty

Uwagi

Źródło zdarzenia wskazuje, co rejestruje zdarzenie.The event source indicates what logs the event. Często jest to nazwa aplikacji lub nazwa składnika w ramach dużej aplikacji.It is often the name of the application, or the name of a component within a large application.

Instalator używa wartości Source właściwości w celu zarejestrowania aplikacji w dzienniku zdarzeń jako prawidłowego źródła wpisów.The installer uses the value of the Source property to register your application with the event log as a valid source of entries. Nowa nazwa źródła nie może być zgodna z nazwą istniejącego źródła lub nazwą istniejącego dziennika zdarzeń.A new source name cannot match an existing source name or an existing event log name. Każde źródło może zapisywać w danym momencie tylko w jednym dzienniku zdarzeń; Jednak aplikacja może zapisywać w wielu dziennikach zdarzeń przy użyciu wielu źródeł.Each source can only write to one event log at a time; however, your application can use multiple sources to write to multiple event logs. Na przykład aplikacja może wymagać wielu źródeł skonfigurowanych dla różnych dzienników zdarzeń lub różnych plików zasobów.For example, your application might require multiple sources configured for different event logs or different resource files.

Aplikacje i usługi powinny zapisywać w dzienniku aplikacji lub dzienniku niestandardowym.Applications and services should write to the Application log or a custom log. Sterowniki urządzeń powinny zapisywać dane w dzienniku systemu.Device drivers should write to the System log. Jeśli nie określisz nazwy dziennika przed uruchomieniem Instalatora, Instalator rejestruje źródło w dzienniku aplikacji.If you do not specify a log name before the installer runs, the installer registers your source to the Application log. Jeśli określisz nazwę dziennika, który nie istnieje, system rejestruje Source do tego dziennika, ale dziennik nie zostanie utworzony, dopóki nie zostanie do niego zapisany pierwszy wpis.If you specify the name of a log that does not exist, the system registers the Source to that log, but the log is not created until the first entry is written to it.

Służy EventLogInstaller do rejestrowania nowego źródła dla nowego lub istniejącego dziennika zdarzeń; nie należy używać EventLogInstaller do zmiany istniejącego źródła.Use EventLogInstaller to register a new source for a new or existing event log; do not use EventLogInstaller to change an existing source. EventLogInstallerKlasa nie modyfikuje właściwości konfiguracji istniejącego źródła, aby pasowały do określonych właściwości instalacji.The EventLogInstaller class does not modify the configuration properties of an existing source to match the specified installation properties. InstallMetoda zgłasza wyjątek, jeśli Source Właściwość jest zgodna z nazwą źródła, która jest zarejestrowana dla innego dziennika zdarzeń na komputerze.The Install method throws an exception if the Source property matches a source name that is registered for a different event log on the computer. InstallMetoda 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 we Log właściwości.The Install method does not register the source if the Source property matches a source name that is already registered for the same event log specified in the Log property.

Aby uzyskać bardziej szczegółowe informacje na temat zachowań dzienników i źródeł zdarzeń, zobacz EventLog dokumentację klasy dla Log i Source właściwości.For more detailed information about the behaviors of event logs and sources, see the EventLog class documentation for the Log and Source properties.

Dotyczy

Zobacz też