Compartilhar via


Context.StopService(Intent) Método

Definição

Solicite que um determinado serviço de aplicativo seja interrompido.

[Android.Runtime.Register("stopService", "(Landroid/content/Intent;)Z", "GetStopService_Landroid_content_Intent_Handler")]
public abstract bool StopService (Android.Content.Intent? service);
[<Android.Runtime.Register("stopService", "(Landroid/content/Intent;)Z", "GetStopService_Landroid_content_Intent_Handler")>]
abstract member StopService : Android.Content.Intent -> bool

Parâmetros

service
Intent

Descrição do serviço a ser interrompido. A intenção deve ser totalmente explícita (fornecendo um nome de componente) ou especificar um nome de pacote específico para o qual é destinada.

Retornos

Se houver um serviço correspondente à intenção dada que já está em execução, ele é interrompido e true é retornado, caso contrário false , é retornado.

Atributos

Exceções

Comentários

Solicite que um determinado serviço de aplicativo seja interrompido. Se o serviço não estiver em execução, nada acontece. Caso contrário, é interrompido. Observe que as chamadas para startService() não são contadas -- isso interrompe o serviço, não importa quantas vezes ele tenha sido iniciado.

Se o serviço estiver sendo executado como um serviço de primeiro plano quando for interrompido, sua notificação associada será removida. Para evitar isso, os aplicativos podem usar android.app.Service#stopForeground(int) stopForeground(STOP_FOREGROUND_DETACH) para separar a notificação do ciclo de vida do serviço antes de interrompê-la.

Observe que, se um serviço interrompido ainda tiver ServiceConnection objetos vinculados a ele com o #BIND_AUTO_CREATE conjunto, ele não será destruído até que todas essas ligações sejam removidas. Consulte a documentação para obter mais detalhes sobre o android.app.Service ciclo de vida de um serviço.

Esta função será lançada SecurityException se você não tiver permissão para parar o serviço fornecido.

Documentação Java para android.content.Context.stopService(android.content.Intent).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Confira também