EventLogInstaller.Log 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置要向其设置源的日志的名称。
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
属性值
日志的名称。 这可以是 Application、System 或一个自定义的日志名称。 默认值为空字符串("")。
- 属性
注解
可以使用 Log 属性将 属性中指定的 Source 源与本地计算机上的现有日志或新日志相关联。 Installutil.exe (安装程序工具) 使用此信息将源映射到计算机注册表中的日志。 应用程序和服务应写入应用程序日志或自定义日志。 设备驱动程序应写入系统日志。
若要将条目写入事件日志,必须创建源并将其注册到事件日志中。 事件源一次只能写入一个日志。 安装程序使用 属性的值 Source 将应用程序注册到事件日志中,作为有效的条目源。 如果在安装程序运行之前未指定日志名称,安装程序会将源注册到应用程序日志。 如果指定新源和现有日志,安装程序将创建新的事件源,并将其与指定的日志相关联。 如果同时指定新源和新日志,安装程序会将新源与注册表中的新日志相关联,但在将第一个条目写入该日志之前不会创建日志。
操作系统将事件日志存储为文件。 使用 EventLogInstaller 或 CreateEventSource 方法创建新的事件日志时,关联的文件将存储在指定计算机上的 %SystemRoot%\System32\Config 目录中。 通过将 属性的前 8 个字符 Log 追加到“.evt”文件扩展名来设置文件名。
使用 EventLogInstaller 为新的或现有的事件日志注册新源;请勿使用 EventLogInstaller 更改现有源。 类 EventLogInstaller 不会修改现有源的配置属性以匹配指定的安装属性。 如果 Source 属性与计算机上为其他事件日志注册的源名称匹配,则 Install 方法将引发异常。 Install如果 Source 属性与已为 属性中指定的相同事件日志注册的源名称匹配,则 方法不会注册源Log。
有关事件日志和源行为的详细信息,请参阅 和 属性的EventLog类文档Log。Source