通过


EventLogInstaller.Log 属性

定义

获取或设置要将源设置为的日志的名称。

public:
 property System::String ^ Log { 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 Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set
Public Property Log As String

属性值

日志的名称。 这可以是应用程序、系统或自定义日志名称。 默认值为空字符串(“)。

属性

注解

可以使用该 Log 属性将属性 Source 中指定的源与本地计算机上的现有日志或新日志相关联。 Installutil.exe(安装程序工具)使用此信息将源映射到计算机注册表中的日志。 应用程序和服务应写入应用程序日志或自定义日志。 设备驱动程序应写入系统日志。

若要将条目写入事件日志,必须创建源并将其注册到事件日志。 事件源一次只能写入一个日志。 安装程序使用属性的值 Source 将应用程序注册到事件日志作为条目的有效源。 如果在安装程序运行之前未指定日志名称,安装程序会将源注册到应用程序日志。 如果指定新的源和现有日志,安装程序将创建新的事件源并将其与指定的日志相关联。 如果同时指定新源和新日志,安装程序会将新源与注册表中的新日志相关联,但在写入第一个条目之前不会创建日志。

操作系统将事件日志存储为文件。 使用 EventLogInstallerCreateEventSource 方法创建新事件日志时,关联的文件存储在指定计算机上的 %SystemRoot%\System32\Config 目录中。 通过将属性的前 8 个字符 Log 追加为“.evt”文件扩展名来设置文件名。

用于 EventLogInstaller 为新的或现有的事件日志注册新源;不用于 EventLogInstaller 更改现有源。 该 EventLogInstaller 类不会修改现有源的配置属性以匹配指定的安装属性。 如果Source属性与计算机上为其他事件日志注册的源名称匹配,该方法Install将引发异常。 Install如果Source属性与已在属性中指定的Log同一事件日志中注册的源名称匹配,则该方法不会注册源。

有关事件日志和源行为的详细信息,请参阅 EventLog 类文档 LogSource 属性。

适用于

另请参阅