IServiceConnection.xml

<Type Name="IServiceConnection" FullName="Android.Content.IServiceConnection">
  <TypeSignature Language="C#" Value="public interface IServiceConnection : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable" />
  <TypeSignature Language="ILAsm" Value=".class public interface auto ansi abstract beforefieldinit IServiceConnection implements class Android.Runtime.IJavaObject, class Java.Interop.IJavaPeerable, class System.IDisposable" />
  <TypeSignature Language="DocId" Value="T:Android.Content.IServiceConnection" />
  <TypeSignature Language="F#" Value="type IServiceConnection = interface&#xA;    interface IJavaObject&#xA;    interface IDisposable&#xA;    interface IJavaPeerable" />
  <AssemblyInfo>
    <AssemblyName>Mono.Android</AssemblyName>
    <AssemblyVersion>0.0.0.0</AssemblyVersion>
  </AssemblyInfo>
  <Interfaces>
    <Interface>
      <InterfaceName>Android.Runtime.IJavaObject</InterfaceName>
    </Interface>
    <Interface>
      <InterfaceName>Java.Interop.IJavaPeerable</InterfaceName>
    </Interface>
    <Interface>
      <InterfaceName>System.IDisposable</InterfaceName>
    </Interface>
  </Interfaces>
  <Attributes>
    <Attribute>
      <AttributeName Language="C#">[Android.Runtime.Register("android/content/ServiceConnection", "", "Android.Content.IServiceConnectionInvoker")]</AttributeName>
      <AttributeName Language="F#">[&lt;Android.Runtime.Register("android/content/ServiceConnection", "", "Android.Content.IServiceConnectionInvoker")&gt;]</AttributeName>
    </Attribute>
  </Attributes>
  <Docs since="1">
    <summary>Interface for monitoring the state of an application service.</summary>
    <remarks>
      <para>Interface for monitoring the state of an application service.  See
            <c>android.app.Service</c> and
            <c>Context#bindService Context.bindService()</c> for more information.</para>
      <para>Like many callbacks from the system, the methods on this class are called
            from the main thread of your process.</para>
      <para>
        <format type="text/html">
          <a href="https://developer.android.com/reference/android/content/ServiceConnection" title="Reference documentation">Java documentation for <code>android.content.ServiceConnection</code>.</a>
        </format>
      </para>
      <para>
                    Portions of this page are modifications based on work created and shared by the 
                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
                     and used according to terms described in the 
                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
    </remarks>
    <since version="Added in API level 1" />
  </Docs>
  <Members>
    <Member MemberName="OnBindingDied">
      <MemberSignature Language="C#" Value="public virtual void OnBindingDied (Android.Content.ComponentName? name);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void OnBindingDied(class Android.Content.ComponentName name) cil managed" />
      <MemberSignature Language="DocId" Value="M:Android.Content.IServiceConnection.OnBindingDied(Android.Content.ComponentName)" />
      <MemberSignature Language="F#" Value="abstract member OnBindingDied : Android.Content.ComponentName -&gt; unit&#xA;override this.OnBindingDied : Android.Content.ComponentName -&gt; unit" Usage="iServiceConnection.OnBindingDied name" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyName>Mono.Android</AssemblyName>
        <AssemblyVersion>0.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <Attributes>
        <Attribute>
          <AttributeName Language="C#">[Android.Runtime.Register("onBindingDied", "(Landroid/content/ComponentName;)V", "GetOnBindingDied_Landroid_content_ComponentName_Handler:Android.Content.IServiceConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]</AttributeName>
          <AttributeName Language="F#">[&lt;Android.Runtime.Register("onBindingDied", "(Landroid/content/ComponentName;)V", "GetOnBindingDied_Landroid_content_ComponentName_Handler:Android.Content.IServiceConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)&gt;]</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName Language="C#">[System.Runtime.Versioning.SupportedOSPlatform("android26.0")]</AttributeName>
          <AttributeName Language="F#">[&lt;System.Runtime.Versioning.SupportedOSPlatform("android26.0")&gt;]</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="name" Type="Android.Content.ComponentName" />
      </Parameters>
      <Docs>
        <param name="name">The concrete component name of the service whose connection is dead.</param>
        <summary>Called when the binding to this connection is dead.</summary>
        <remarks>
          <para>Called when the binding to this connection is dead.  This means the
            interface will never receive another connection.  The application will
            need to unbind and rebind the connection to activate it again.  This may
            happen, for example, if the application hosting the service it is bound to
            has been updated.
            
            &lt;p class="note"&gt;&lt;b&gt;Note:&lt;/b&gt; The app that requested the binding must call
            <c>Context#unbindService(ServiceConnection)</c> to release the tracking
            resources associated with this ServiceConnection even if this callback was
            invoked following <c>Context#bindService Context.bindService() bindService()</c>.</para>
          <para>
            <format type="text/html">
              <a href="https://developer.android.com/reference/android/content/ServiceConnection#onBindingDied(android.content.ComponentName)" title="Reference documentation">Java documentation for <code>android.content.ServiceConnection.onBindingDied(android.content.ComponentName)</code>.</a>
            </format>
          </para>
          <para>
                    Portions of this page are modifications based on work created and shared by the 
                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
                     and used according to terms described in the 
                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="OnNullBinding">
      <MemberSignature Language="C#" Value="public virtual void OnNullBinding (Android.Content.ComponentName? name);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void OnNullBinding(class Android.Content.ComponentName name) cil managed" />
      <MemberSignature Language="DocId" Value="M:Android.Content.IServiceConnection.OnNullBinding(Android.Content.ComponentName)" />
      <MemberSignature Language="F#" Value="abstract member OnNullBinding : Android.Content.ComponentName -&gt; unit&#xA;override this.OnNullBinding : Android.Content.ComponentName -&gt; unit" Usage="iServiceConnection.OnNullBinding name" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyName>Mono.Android</AssemblyName>
        <AssemblyVersion>0.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <Attributes>
        <Attribute>
          <AttributeName Language="C#">[Android.Runtime.Register("onNullBinding", "(Landroid/content/ComponentName;)V", "GetOnNullBinding_Landroid_content_ComponentName_Handler:Android.Content.IServiceConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=28)]</AttributeName>
          <AttributeName Language="F#">[&lt;Android.Runtime.Register("onNullBinding", "(Landroid/content/ComponentName;)V", "GetOnNullBinding_Landroid_content_ComponentName_Handler:Android.Content.IServiceConnection, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=28)&gt;]</AttributeName>
        </Attribute>
        <Attribute>
          <AttributeName Language="C#">[System.Runtime.Versioning.SupportedOSPlatform("android28.0")]</AttributeName>
          <AttributeName Language="F#">[&lt;System.Runtime.Versioning.SupportedOSPlatform("android28.0")&gt;]</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="name" Type="Android.Content.ComponentName" />
      </Parameters>
      <Docs>
        <param name="name">The concrete component name of the service whose binding
                has been rejected by the Service implementation.</param>
        <summary>Called when the service being bound has returned <c>null</c> from its
            <c>android.app.Service#onBind(Intent) onBind()</c> method.</summary>
        <remarks>
          <para>Called when the service being bound has returned <c>null</c> from its
            <c>android.app.Service#onBind(Intent) onBind()</c> method.  This indicates
            that the attempted service binding represented by this ServiceConnection
            will never become usable.
            
            &lt;p class="note"&gt;&lt;b&gt;Note:&lt;/b&gt; The app that requested the binding must still call
            <c>Context#unbindService(ServiceConnection)</c> to release the tracking
            resources associated with this ServiceConnection even if this callback was
            invoked following <c>Context#bindService Context.bindService() bindService()</c>.</para>
          <para>
            <format type="text/html">
              <a href="https://developer.android.com/reference/android/content/ServiceConnection#onNullBinding(android.content.ComponentName)" title="Reference documentation">Java documentation for <code>android.content.ServiceConnection.onNullBinding(android.content.ComponentName)</code>.</a>
            </format>
          </para>
          <para>
                    Portions of this page are modifications based on work created and shared by the 
                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
                     and used according to terms described in the 
                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
        </remarks>
      </Docs>
    </Member>
    <Member MemberName="OnServiceConnected">
      <MemberSignature Language="C#" Value="public void OnServiceConnected (Android.Content.ComponentName? name, Android.OS.IBinder? service);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void OnServiceConnected(class Android.Content.ComponentName name, class Android.OS.IBinder service) cil managed" />
      <MemberSignature Language="DocId" Value="M:Android.Content.IServiceConnection.OnServiceConnected(Android.Content.ComponentName,Android.OS.IBinder)" />
      <MemberSignature Language="F#" Value="abstract member OnServiceConnected : Android.Content.ComponentName * Android.OS.IBinder -&gt; unit" Usage="iServiceConnection.OnServiceConnected (name, service)" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyName>Mono.Android</AssemblyName>
        <AssemblyVersion>0.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <Attributes>
        <Attribute>
          <AttributeName Language="C#">[Android.Runtime.Register("onServiceConnected", "(Landroid/content/ComponentName;Landroid/os/IBinder;)V", "GetOnServiceConnected_Landroid_content_ComponentName_Landroid_os_IBinder_Handler:Android.Content.IServiceConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]</AttributeName>
          <AttributeName Language="F#">[&lt;Android.Runtime.Register("onServiceConnected", "(Landroid/content/ComponentName;Landroid/os/IBinder;)V", "GetOnServiceConnected_Landroid_content_ComponentName_Landroid_os_IBinder_Handler:Android.Content.IServiceConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")&gt;]</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="name" Type="Android.Content.ComponentName" />
        <Parameter Name="service" Type="Android.OS.IBinder" />
      </Parameters>
      <Docs>
        <param name="name">The concrete component name of the service that has
            been connected.</param>
        <param name="service">The IBinder of the Service's communication channel,
            which you can now make calls on.</param>
        <summary>Called when a connection to the Service has been established, with
            the <c>android.os.IBinder</c> of the communication channel to the
            Service.</summary>
        <remarks>
          <para>Called when a connection to the Service has been established, with
            the <c>android.os.IBinder</c> of the communication channel to the
            Service.
            
            &lt;p class="note"&gt;&lt;b&gt;Note:&lt;/b&gt; If the system has started to bind your
            client app to a service, it's possible that your app will never receive
            this callback. Your app won't receive a callback if there's an issue with
            the service, such as the service crashing while being created.</para>
          <para>
            <format type="text/html">
              <a href="https://developer.android.com/reference/android/content/ServiceConnection#onServiceConnected(android.content.ComponentName,%20android.os.IBinder)" title="Reference documentation">Java documentation for <code>android.content.ServiceConnection.onServiceConnected(android.content.ComponentName, android.os.IBinder)</code>.</a>
            </format>
          </para>
          <para>
                    Portions of this page are modifications based on work created and shared by the 
                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
                     and used according to terms described in the 
                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
        </remarks>
        <since version="Added in API level 1" />
      </Docs>
    </Member>
    <Member MemberName="OnServiceDisconnected">
      <MemberSignature Language="C#" Value="public void OnServiceDisconnected (Android.Content.ComponentName? name);" />
      <MemberSignature Language="ILAsm" Value=".method public hidebysig newslot virtual instance void OnServiceDisconnected(class Android.Content.ComponentName name) cil managed" />
      <MemberSignature Language="DocId" Value="M:Android.Content.IServiceConnection.OnServiceDisconnected(Android.Content.ComponentName)" />
      <MemberSignature Language="F#" Value="abstract member OnServiceDisconnected : Android.Content.ComponentName -&gt; unit" Usage="iServiceConnection.OnServiceDisconnected name" />
      <MemberType>Method</MemberType>
      <AssemblyInfo>
        <AssemblyName>Mono.Android</AssemblyName>
        <AssemblyVersion>0.0.0.0</AssemblyVersion>
      </AssemblyInfo>
      <Attributes>
        <Attribute>
          <AttributeName Language="C#">[Android.Runtime.Register("onServiceDisconnected", "(Landroid/content/ComponentName;)V", "GetOnServiceDisconnected_Landroid_content_ComponentName_Handler:Android.Content.IServiceConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]</AttributeName>
          <AttributeName Language="F#">[&lt;Android.Runtime.Register("onServiceDisconnected", "(Landroid/content/ComponentName;)V", "GetOnServiceDisconnected_Landroid_content_ComponentName_Handler:Android.Content.IServiceConnectionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")&gt;]</AttributeName>
        </Attribute>
      </Attributes>
      <ReturnValue>
        <ReturnType>System.Void</ReturnType>
      </ReturnValue>
      <Parameters>
        <Parameter Name="name" Type="Android.Content.ComponentName" />
      </Parameters>
      <Docs>
        <param name="name">The concrete component name of the service whose
            connection has been lost.</param>
        <summary>Called when a connection to the Service has been lost.</summary>
        <remarks>
          <para>Called when a connection to the Service has been lost.  This typically
            happens when the process hosting the service has crashed or been killed.
            This does &lt;em&gt;not&lt;/em&gt; remove the ServiceConnection itself -- this
            binding to the service will remain active, and you will receive a call
            to <c>#onServiceConnected</c> when the Service is next running.</para>
          <para>
            <format type="text/html">
              <a href="https://developer.android.com/reference/android/content/ServiceConnection#onServiceDisconnected(android.content.ComponentName)" title="Reference documentation">Java documentation for <code>android.content.ServiceConnection.onServiceDisconnected(android.content.ComponentName)</code>.</a>
            </format>
          </para>
          <para>
                    Portions of this page are modifications based on work created and shared by the 
                    <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format>
                     and used according to terms described in the 
                    <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
        </remarks>
        <since version="Added in API level 1" />
      </Docs>
    </Member>
  </Members>
</Type>