ConnectivityManager.NetworkCallback.OnAvailable(Network) Methode

Definition

Wird aufgerufen, wenn das Framework eine Verbindung herstellt und ein neues Netzwerk für die Verwendung deklariert hat.

[Android.Runtime.Register("onAvailable", "(Landroid/net/Network;)V", "GetOnAvailable_Landroid_net_Network_Handler")]
public virtual void OnAvailable(Android.Net.Network network);
[<Android.Runtime.Register("onAvailable", "(Landroid/net/Network;)V", "GetOnAvailable_Landroid_net_Network_Handler")>]
abstract member OnAvailable : Android.Net.Network -> unit
override this.OnAvailable : Android.Net.Network -> unit

Parameter

network
Network

Das Network zufriedenstellende Netzwerk.

Attribute

Hinweise

Wird aufgerufen, wenn das Framework eine Verbindung herstellt und ein neues Netzwerk für die Verwendung deklariert hat.

Bei Rückrufen, die bei #registerNetworkCallbackregistriert sind, können mehrere Netzwerke gleichzeitig verfügbar sein, und onAvailable wird für jede dieser Aufrufe aufgerufen, sobald sie angezeigt werden.

Bei Rückrufen, die bei #requestNetwork und #registerDefaultNetworkCallback, bedeutet dies, dass das als Argument übergebene Netzwerk das neue beste Netzwerk für diese Anforderung ist und jetzt von diesem Rückruf nachverfolgt wird. Dieser Rückruf empfängt keine Methodenaufrufe mehr über andere Netzwerke, die möglicherweise zuvor an diese Methode übergeben wurden. Das bisher beste Netzwerk wurde möglicherweise getrennt, oder es ist immer noch vorhanden, und das neu beste Netzwerk ist möglicherweise einfach besser.

Beginnend mit android.os.Build.VERSION_CODES#O, wird dies immer sofort durch einen Anruf gefolgt #onCapabilitiesChanged(Network, NetworkCapabilities) von einem Anruf an #onLinkPropertiesChanged(Network, LinkProperties), und ein Anruf an #onBlockedStatusChanged(Network, boolean).

Rufen Sie #getNetworkCapabilities(Network) nicht oder #getLinkProperties(Network) andere synchrone ConnectivityManager-Methoden in diesem Rückruf auf, da dies anfällig für Rennbedingungen ist (es gibt keine Garantie, dass die von diesen Methoden zurückgegebenen Objekte aktuell sind). Warten Sie stattdessen auf einen Aufruf #onCapabilitiesChanged(Network, NetworkCapabilities) und #onLinkPropertiesChanged(Network, LinkProperties) deren Argumente in Bezug auf andere Rückrufe garantiert gut sortiert sind.

Java-Dokumentation für android.net.ConnectivityManager.NetworkCallback.onAvailable(android.net.Network).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: