ServiceInstaller.ServiceName 属性

定义

命名空间:

System.ServiceProcess

程序集:

System.ServiceProcess.dll

指示系统用于标识此服务的名称。 此属性必须与要安装的服务的 ServiceName 相同。

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

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

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

Public Property ServiceName As String

属性值

String

要安装的服务的名称。 该值必须在安装实用工具尝试安装服务以前进行设置。

属性

TypeConverterAttribute ServiceProcessDescriptionAttribute

例外

ArgumentException

ServiceName 属性无效。

注解

与派生自 ServiceBase的类的 相同ServiceBase.ServiceName，这一点至关重要ServiceName。 通常，服务的 属性的值 ServiceBase.ServiceName 是在服务应用程序的可执行文件的 Main () 函数中设置的。 服务控制管理器使用 ServiceInstaller.ServiceName 属性来查找此可执行文件中的服务。

设置 ServiceName 服务安装程序的 时， Source 关联事件日志的 设置为相同的值。 这允许服务自动记录 (服务命令，例如启动和停止) 计算机上应用程序日志的调用。

注意

如果计算机上已存在同名的源，但在应用程序日志以外的日志中，将引发异常。 如果源存在且与应用程序日志相关联，则使用该源报告对服务的命令调用，并且不会引发异常。

长度 ServiceName 不能为 null 或长度为零。 其最大大小为 256 个字符。 它也不能包含正斜杠或向后斜杠、“/”或“\”，也不能包含值小于十进制值 32 的 ASCII 字符集的字符。

另请参阅

• ServiceName
• DisplayName