ServiceInstaller.ServiceName Właściwość

Definicja

Wskazuje nazwę używaną przez system do identyfikowania tej usługi. Ta właściwość musi być identyczna ServiceName z usługą, którą chcesz zainstalować.

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

Wartość właściwości

Nazwa usługi, która ma zostać zainstalowana. Tę wartość należy ustawić przed podjęciem próby zainstalowania usługi przez narzędzie instalacyjne.

Atrybuty

Wyjątki

Właściwość jest nieprawidłowa ServiceName .

Uwagi

Niezwykle ważne jest, aby element ServiceName był identyczny z ServiceBase.ServiceName klasą pochodzącą z ServiceBaseklasy . Zwykle wartość ServiceBase.ServiceName właściwości usługi jest ustawiana w ramach funkcji Main() pliku wykonywalnego aplikacji usługi. Menedżer sterowania usługami używa ServiceInstaller.ServiceName właściwości , aby zlokalizować usługę w ramach tego pliku wykonywalnego.

Po ustawieniu ServiceName instalatora Source usługi skojarzony dziennik zdarzeń jest ustawiony na tę samą wartość. Dzięki temu usługa może automatycznie rejestrować polecenia usługi (takie jak Uruchamianie i zatrzymywanie) do dziennika aplikacji na komputerze.

Uwaga

Jeśli źródło o tej samej nazwie już istnieje na komputerze, ale w dzienniku innym niż dziennik aplikacji, zostanie zgłoszony wyjątek. Jeśli źródło istnieje i jest skojarzone z dziennikiem aplikacji, to źródło jest używane do raportowania wywołań poleceń do usługi i nie jest zgłaszany wyjątek.

Nie ServiceName może mieć null ani mieć zerowej długości. Maksymalny rozmiar to 256 znaków. Nie może również zawierać ukośników do przodu lub do tyłu, "/" lub "\" ani znaków z zestawu znaków ASCII o wartości mniejszej niż wartość dziesiętna 32.

Dotyczy

Zobacz też