Context.StopService(Intent) 方法

定义

请求停止给定的应用程序服务。

[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

参数

service
Intent

要停止的服务的说明。 意向必须是完全显式的(提供组件名称),或指定其目标的特定包名称。

返回

如果存在与给定意向匹配的服务,则它已停止并 true 返回;否则 false 返回。

属性

例外

注解

请求停止给定的应用程序服务。 如果服务未运行,则不会发生任何操作。 否则,它已停止。 请注意,对 startService() 的调用不会计入 - 无论服务启动了多少次,都会停止该服务。

如果服务在停止时作为前台服务运行,则会删除其关联的通知。 为避免这种情况,应用可用于 android.app.Service#stopForeground(int) stopForeground(STOP_FOREGROUND_DETACH) 在停止通知之前将通知与服务的生命周期分离。

请注意,如果已停止的服务仍具有 ServiceConnection#BIND_AUTO_CREATE 集绑定的对象,则在删除所有这些绑定之前,它不会被销毁。 android.app.Service有关服务的生命周期的更多详细信息,请参阅文档。

如果没有停止给定服务的权限,此函数将引发 SecurityException

适用于 . 的 android.content.Context.stopService(android.content.Intent)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

另请参阅