Context.StopService(Intent) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.