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 недопустимо.

Комментарии

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

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

Замечание

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

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

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

• ServiceName
• DisplayName