Context.BindService Méthode

Définition

Espace de noms:: Android.Content

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
BindService(Intent, IServiceConnection, Bind)	Se connecte à un service d’application, en le créant si nécessaire.
BindService(Intent, IServiceConnection, Context+BindServiceFlags)	Consultez bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.
BindService(Intent, Bind, IExecutor, IServiceConnection)	Identique à celui de `#bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int)` l’exécuteur pour contrôler les rappels ServiceConnection.
BindService(Intent, Context+BindServiceFlags, IExecutor, IServiceConnection)	Consultez bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

BindService(Intent, IServiceConnection, Bind)

Se connecte à un service d’application, en le créant si nécessaire.

[Android.Runtime.Register("bindService", "(Landroid/content/Intent;Landroid/content/ServiceConnection;I)Z", "GetBindService_Landroid_content_Intent_Landroid_content_ServiceConnection_IHandler")]
public abstract bool BindService(Android.Content.Intent service, Android.Content.IServiceConnection conn, Android.Content.Bind flags);

[<Android.Runtime.Register("bindService", "(Landroid/content/Intent;Landroid/content/ServiceConnection;I)Z", "GetBindService_Landroid_content_Intent_Landroid_content_ServiceConnection_IHandler")>]
abstract member BindService : Android.Content.Intent * Android.Content.IServiceConnection * Android.Content.Bind -> bool

Paramètres

service: Intent

Identifie le service auquel se connecter. L’intention doit spécifier un nom de composant explicite.

conn: IServiceConnection

Reçoit des informations au démarrage et à l’arrêt du service. Il doit s’agir d’un objet ServiceConnection valide ; elle ne doit pas être null.

flags: Bind

Options d’opération pour la liaison. Peut être : <ul><li li>0 <>#BIND_AUTO_CREATE<>#BIND_DEBUG_UNBIND<>#BIND_NOT_FOREGROUND<>#BIND_ABOVE_CLIENT<>#BIND_ALLOW_OOM_MANAGEMENT<>#BIND_WAIVE_PRIORITY<>#BIND_IMPORTANT<>#BIND_ADJUST_WITH_ACTIVITY<>#BIND_NOT_PERCEPTIBLE<>#BIND_INCLUDE_CAPABILITIES<li/ul>

Retours

Boolean

true si le système est en cours de création d’un service auquel votre client est autorisé à se lier ; false si le système n’a pas trouvé le service ou si votre client n’a pas l’autorisation de le lier. Quelle que soit la valeur de retour, vous devez appeler #unbindService ultérieurement pour libérer la connexion.

Attributs: RegisterAttribute

Exceptions

SecurityException

Remarques

Se connecte à un service d’application, en le créant si nécessaire. Cela définit une dépendance entre votre application et le service. Le conn</var> donné <>reçoit l’objet de service lorsqu’il est créé et est informé s’il meurt et redémarre. Le service est considéré comme requis par le système uniquement tant que le contexte d’appel existe. Par exemple, si ce contexte est une activité qui est arrêtée, le service ne doit pas continuer à s’exécuter tant que l’activité n’est pas reprise.

Si le service ne prend pas en charge la liaison, il peut revenir null de sa android.app.Service#onBind(Intent) onBind() méthode. Si c’est le cas, la méthode de ServiceConnection#onNullBinding(ComponentName) onNullBinding() ServiceConnection sera appelée au lieu de ServiceConnection#onServiceConnected(ComponentName, IBinder) onServiceConnected().

<b>Remarque :</b> Cette méthode <em>ne peut pas</em> être appelée à partir d’un BroadcastReceiver composant. Un modèle que vous pouvez utiliser pour communiquer à partir d’un BroadcastReceiver à un service consiste à appeler #startService avec les arguments contenant la commande à envoyer, avec le service appelant sa android.app.Service#stopSelf(int) méthode lors de l’exécution de cette commande. Consultez le contrôleur d’arguments de démarrage app/service/service de démonstration de l’API pour obtenir une illustration de ce problème. Toutefois, il est acceptable d’utiliser cette méthode à partir d’un BroadcastReceiver qui a été inscrit avec #registerReceiver, depuis la durée de vie de ce BroadcastReceiver est lié à un autre objet (celui qui l’a inscrit).

Cette méthode accepte uniquement un indicateur de type int, pour passer un indicateur de type long, appeler #bindService(Intent, ServiceConnection, BindServiceFlags) à la place.

Java documentation pour android.content.Context.bindService(android.content.Intent, android.content.ServiceConnection, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Voir aussi

S’applique à

BindService(Intent, IServiceConnection, Context+BindServiceFlags)

Consultez bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

[Android.Runtime.Register("bindService", "(Landroid/content/Intent;Landroid/content/ServiceConnection;Landroid/content/Context$BindServiceFlags;)Z", "GetBindService_Landroid_content_Intent_Landroid_content_ServiceConnection_Landroid_content_Context_BindServiceFlags_Handler", ApiSince=34)]
public virtual bool BindService(Android.Content.Intent service, Android.Content.IServiceConnection conn, Android.Content.Context.BindServiceFlags flags);

[<Android.Runtime.Register("bindService", "(Landroid/content/Intent;Landroid/content/ServiceConnection;Landroid/content/Context$BindServiceFlags;)Z", "GetBindService_Landroid_content_Intent_Landroid_content_ServiceConnection_Landroid_content_Context_BindServiceFlags_Handler", ApiSince=34)>]
abstract member BindService : Android.Content.Intent * Android.Content.IServiceConnection * Android.Content.Context.BindServiceFlags -> bool
override this.BindService : Android.Content.Intent * Android.Content.IServiceConnection * Android.Content.Context.BindServiceFlags -> bool

Paramètres

service: Intent

Cette valeur ne peut pas être null.

conn: IServiceConnection

Cette valeur ne peut pas être null.

flags: Context.BindServiceFlags

Cette valeur ne peut pas être null.

Retours

Boolean

Consultez bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

Attributs: RegisterAttribute

Remarques

Consultez bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

Java documentation pour android.content.Context.bindService(android.content.Intent, android.content.ServiceConnection, android.content.Context.BindServiceFlags).

S’applique à

BindService(Intent, Bind, IExecutor, IServiceConnection)

Identique à celui de #bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int) l’exécuteur pour contrôler les rappels ServiceConnection.

[Android.Runtime.Register("bindService", "(Landroid/content/Intent;ILjava/util/concurrent/Executor;Landroid/content/ServiceConnection;)Z", "GetBindService_Landroid_content_Intent_ILjava_util_concurrent_Executor_Landroid_content_ServiceConnection_Handler", ApiSince=29)]
public virtual bool BindService(Android.Content.Intent service, Android.Content.Bind flags, Java.Util.Concurrent.IExecutor executor, Android.Content.IServiceConnection conn);

[<Android.Runtime.Register("bindService", "(Landroid/content/Intent;ILjava/util/concurrent/Executor;Landroid/content/ServiceConnection;)Z", "GetBindService_Landroid_content_Intent_ILjava_util_concurrent_Executor_Landroid_content_ServiceConnection_Handler", ApiSince=29)>]
abstract member BindService : Android.Content.Intent * Android.Content.Bind * Java.Util.Concurrent.IExecutor * Android.Content.IServiceConnection -> bool
override this.BindService : Android.Content.Intent * Android.Content.Bind * Java.Util.Concurrent.IExecutor * Android.Content.IServiceConnection -> bool

Paramètres

service: Intent

Cette valeur ne peut pas être null.

flags: Bind

La valeur est 0 ou une combinaison des éléments suivants : BIND_AUTO_CREATE BIND_DEBUG_UNBIND BIND_NOT_FOREGROUND BIND_ABOVE_CLIENT BIND_ALLOW_OOM_MANAGEMENT BIND_WAIVE_PRIORITY BIND_IMPORTANT BIND_ADJUST_WITH_ACTIVITY BIND_NOT_PERCEPTIBLE BIND_ALLOW_ACTIVITY_STARTS BIND_INCLUDE_CAPABILITIES BIND_SHARED_ISOLATED_PROCESS BIND_PACKAGE_ISOLATED_PROCESS BIND_EXTERNAL_SERVICE

executor: IExecutor

Les rappels sur ServiceConnection sont appelés sur l’exécuteur. Doit utiliser la même instance pour la même instance de ServiceConnection.

conn: IServiceConnection

Cette valeur ne peut pas être null.

Retours

Boolean

Résultat de la liaison, comme décrit dans #bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int).

Attributs: RegisterAttribute

Remarques

Identique à celui de #bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int) l’exécuteur pour contrôler les rappels ServiceConnection.

Cette méthode accepte uniquement un indicateur de 32 bits, pour passer un indicateur de 64 bits, appeler #bindService(Intent, BindServiceFlags, Executor, ServiceConnection) à la place.

Java documentation pour android.content.Context.bindService(android.content.Intent, int, java.util.concurrent.Executor, android.content.ServiceConnection).

S’applique à

BindService(Intent, Context+BindServiceFlags, IExecutor, IServiceConnection)

Consultez bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

[Android.Runtime.Register("bindService", "(Landroid/content/Intent;Landroid/content/Context$BindServiceFlags;Ljava/util/concurrent/Executor;Landroid/content/ServiceConnection;)Z", "GetBindService_Landroid_content_Intent_Landroid_content_Context_BindServiceFlags_Ljava_util_concurrent_Executor_Landroid_content_ServiceConnection_Handler", ApiSince=34)]
public virtual bool BindService(Android.Content.Intent service, Android.Content.Context.BindServiceFlags flags, Java.Util.Concurrent.IExecutor executor, Android.Content.IServiceConnection conn);

[<Android.Runtime.Register("bindService", "(Landroid/content/Intent;Landroid/content/Context$BindServiceFlags;Ljava/util/concurrent/Executor;Landroid/content/ServiceConnection;)Z", "GetBindService_Landroid_content_Intent_Landroid_content_Context_BindServiceFlags_Ljava_util_concurrent_Executor_Landroid_content_ServiceConnection_Handler", ApiSince=34)>]
abstract member BindService : Android.Content.Intent * Android.Content.Context.BindServiceFlags * Java.Util.Concurrent.IExecutor * Android.Content.IServiceConnection -> bool
override this.BindService : Android.Content.Intent * Android.Content.Context.BindServiceFlags * Java.Util.Concurrent.IExecutor * Android.Content.IServiceConnection -> bool

Paramètres

service: Intent

Cette valeur ne peut pas être null.

flags: Context.BindServiceFlags

Cette valeur ne peut pas être null.

executor: IExecutor

Cette valeur ne peut pas être null. Les événements de rappel et d’écouteur sont distribués via cet exécuteur, ce qui permet de contrôler facilement le thread utilisé. Pour distribuer des événements via le thread principal de votre application, vous pouvez utiliser Context.getMainExecutor(). Sinon, fournissez un exécuteur qui répartit vers un thread approprié.

conn: IServiceConnection

Cette valeur ne peut pas être null.

Retours

Boolean

Consultez bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

Attributs: RegisterAttribute

Remarques

Consultez bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) pour obtenir un objet BindServiceFlags.

Java documentation pour android.content.Context.bindService(android.content.Intent, android.content.Context.BindServiceFlags, java.util.concurrent.Executor, android.content.ServiceConnection).

S’applique à