Context.BindService Método

Definição

Namespace:: Android.Content

Assembly:: Mono.Android.dll

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.

Sobrecargas

Nome	Description
BindService(Intent, IServiceConnection, Bind)	Conecta-se a um serviço de aplicativo, criando-o, se necessário.
BindService(Intent, IServiceConnection, Context+BindServiceFlags)	Consulte bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.
BindService(Intent, Bind, IExecutor, IServiceConnection)	`#bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int)` Igual ao executor para controlar os retornos de chamada do ServiceConnection.
BindService(Intent, Context+BindServiceFlags, IExecutor, IServiceConnection)	Consulte bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

BindService(Intent, IServiceConnection, Bind)

Conecta-se a um serviço de aplicativo, criando-o, se necessário.

[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

Parâmetros

service: Intent

Identifica o serviço ao qual se conectar. A Intenção deve especificar um nome de componente explícito.

conn: IServiceConnection

Recebe informações à medida que o serviço é iniciado e interrompido. Este deve ser um objeto ServiceConnection válido; não deve ser nulo.

flags: Bind

Opções de operação para a associação. Pode ser: <ul><li>0 <li>#BIND_AUTO_CREATE<li>#BIND_DEBUG_UNBIND<li>#BIND_NOT_FOREGROUND<li>#BIND_ABOVE_CLIENT<>#BIND_ALLOW_OOM_MANAGEMENT<li>#BIND_WAIVE_PRIORITY<li>#BIND_IMPORTANT<li>#BIND_ADJUST_WITH_ACTIVITY<li>#BIND_NOT_PERCEPTIBLE<>#BIND_INCLUDE_CAPABILITIES</ul>

Retornos

Boolean

true se o sistema estiver no processo de criar um serviço ao qual seu cliente tem permissão para associar; false se o sistema não conseguiu localizar o serviço ou se o cliente não tem permissão para se associar a ele. Independentemente do valor retornado, você deve chamar #unbindService posteriormente para liberar a conexão.

Atributos: RegisterAttribute

Exceções

SecurityException

Comentários

Conecta-se a um serviço de aplicativo, criando-o, se necessário. Isso define uma dependência entre seu aplicativo e o serviço. O var<conn>/var< fornecido >receberá o objeto de serviço quando ele for criado e será informado se ele morre e reinicia. O serviço será considerado exigido pelo sistema apenas enquanto o contexto de chamada existir. Por exemplo, se esse Contexto for uma Atividade interrompida, o serviço não será necessário para continuar em execução até que a Atividade seja retomada.

Se o serviço não der suporte à associação, ele poderá retornar null de seu android.app.Service#onBind(Intent) onBind() método. Se isso acontecer, o método do ServiceConnection#onNullBinding(ComponentName) onNullBinding() ServiceConnection será invocado em vez de ServiceConnection#onServiceConnected(ComponentName, IBinder) onServiceConnected().

<b>Observação:</b> Este método <em>não pode</em> ser chamado de um BroadcastReceiver componente. Um padrão que você pode usar para se comunicar de um BroadcastReceiver para um Serviço é chamar #startService com os argumentos que contêm o comando a ser enviado, com o serviço chamando seu android.app.Service#stopSelf(int) método quando terminar de executar esse comando. Consulte o controlador de argumentos de demonstração de API App/Service/Service Start para obter uma ilustração disso. No entanto, não há problema em usar esse método de um BroadcastReceiver com o qual foi registrado #registerReceiver, uma vez que o tempo de vida deste BroadcastReceiver está vinculado a outro objeto (aquele que o registrou).

Esse método aceita apenas um sinalizador de tipo int, para passar um sinalizador de tipo longo, chamar #bindService(Intent, ServiceConnection, BindServiceFlags) em vez disso.

Java documentação para android.content.Context.bindService(android.content.Intent, android.content.ServiceConnection, int).

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

Confira também

Aplica-se a

BindService(Intent, IServiceConnection, Context+BindServiceFlags)

Consulte bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

[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

Parâmetros

service: Intent

Esse valor não pode ser nulo.

conn: IServiceConnection

Esse valor não pode ser nulo.

flags: Context.BindServiceFlags

Esse valor não pode ser nulo.

Retornos

Boolean

Consulte bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

Atributos: RegisterAttribute

Comentários

Consulte bindService(Intent,ServiceConnection,int) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

Java documentação para android.content.Context.bindService(android.content.Intent, android.content.ServiceConnection, android.content.Context.BindServiceFlags).

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

Aplica-se a

BindService(Intent, Bind, IExecutor, IServiceConnection)

#bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int) Igual ao executor para controlar os retornos de chamada do 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

Parâmetros

service: Intent

Esse valor não pode ser nulo.

flags: Bind

O valor é 0 ou uma combinação do seguinte: 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

Os retornos de chamada no ServiceConnection serão chamados no executor. Deve usar a mesma instância para a mesma instância do ServiceConnection.

conn: IServiceConnection

Esse valor não pode ser nulo.

Retornos

Boolean

O resultado da associação, conforme descrito em #bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int).

Atributos: RegisterAttribute

Comentários

#bindService(Intent, ServiceConnection, int) bindService(Intent, ServiceConnection, int) Igual ao executor para controlar os retornos de chamada do ServiceConnection.

Esse método aceita apenas um sinalizador de 32 bits, para passar um sinalizador de 64 bits, em #bindService(Intent, BindServiceFlags, Executor, ServiceConnection) vez disso.

Java documentação para android.content.Context.bindService(android.content.Intent, int, java.util.concurrent.Executor, android.content.ServiceConnection).

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

Aplica-se a

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

Consulte bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

[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

Parâmetros

service: Intent

Esse valor não pode ser nulo.

flags: Context.BindServiceFlags

Esse valor não pode ser nulo.

executor: IExecutor

Esse valor não pode ser nulo. Os eventos de retorno de chamada e ouvinte são expedidos por meio desse Executor, fornecendo uma maneira fácil de controlar qual thread é usado. Para expedir eventos por meio do thread principal do aplicativo, você pode usar Context.getMainExecutor() . Caso contrário, forneça um Executor que seja enviado para um thread apropriado.

conn: IServiceConnection

Esse valor não pode ser nulo.

Retornos

Boolean

Consulte bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

Atributos: RegisterAttribute

Comentários

Consulte bindService(Intent,int,Executor,ServiceConnection) Call BindServiceFlags.of(long) to obtain a BindServiceFlags object.

Java documentação para android.content.Context.bindService(android.content.Intent, android.content.Context.BindServiceFlags, java.util.concurrent.Executor, android.content.ServiceConnection).

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

Aplica-se a