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.

Комментарии

Очень важно, чтобы ServiceNameServiceBase.ServiceName класс был идентичен классу, наследуемого из ServiceBase. Обычно значение ServiceBase.ServiceName свойства для службы задается в функции Main() исполняемого файла приложения службы. Диспетчер управления службами использует ServiceInstaller.ServiceName свойство для поиска службы в этом исполняемом объекте.

При установке ServiceName установщика Source службы для связанного журнала событий устанавливается то же значение. Это позволяет службе автоматически регистрировать команды службы (например, "Пуск" и "Остановка") вызовы к журналу приложений на компьютере.

Примечание

Если источник с таким же именем уже существует на компьютере, но в журнале, отличном от журнала приложений, будет создано исключение. Если источник существует и связан с журналом приложений, он используется для отправки отчетов о вызовах команд в службу, и исключение не создается.

Не ServiceName может быть null или иметь нулевую длину. Максимальный размер — 256 символов. Он также не может содержать косую черту вперед или назад, "/" или "\" или символы из набора символов ASCII со значением меньше десятичного значения 32.

См. также раздел

• ServiceName
• DisplayName