ServiceInstaller.ServiceName 属性

定义

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

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

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

属性

例外

ServiceName 属性无效。

注解

与派生自ServiceBase的类相同ServiceBase.ServiceName至关重要ServiceName。 通常,服务属性的值 ServiceBase.ServiceName 在服务应用程序的可执行文件的 Main () 函数中设置。 Service Control Manager 使用该 ServiceInstaller.ServiceName 属性在此可执行文件中查找服务。

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

备注

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

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

适用于

另请参阅