AbstractThreadedSyncAdapter Klasse

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird.

[Android.Runtime.Register("android/content/AbstractThreadedSyncAdapter", DoNotGenerateAcw=true)]
public abstract class AbstractThreadedSyncAdapter : Java.Lang.Object

[<Android.Runtime.Register("android/content/AbstractThreadedSyncAdapter", DoNotGenerateAcw=true)>]
type AbstractThreadedSyncAdapter = class
    inherit Object

Vererbung: Object

Object
AbstractThreadedSyncAdapter

Attribute: RegisterAttribute

Hinweise

Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. Wenn ein Synchronisierungsvorgang bereits ausgeführt wird, wenn eine Synchronisierungsanforderung empfangen wird, wird ein Fehler an die neue Anforderung zurückgegeben, und die vorhandene Anforderung kann fortgesetzt werden. Wenn jedoch keine Synchronisierung ausgeführt wird, wird ein Thread spawniert und #onPerformSync in diesem Thread aufgerufen.

Synchronisierungen können jederzeit vom Framework abgebrochen werden. Beispielsweise gilt eine Synchronisierung, die nicht vom Benutzer initiiert wurde und länger als 10 Minuten dauert, als Timeout und abgebrochen. Ebenso versucht das Framework zu ermitteln, ob ein Adapter fortschritte macht, indem die Netzwerkaktivität im Laufe einer Minute überwacht wird. Wenn der Netzwerkdatenverkehr über dieses Fenster geschlossen ist, wird die Synchronisierung abgebrochen. Sie können auch anfordern, dass die Synchronisierung über ContentResolver#cancelSync(Account, String) oder ContentResolver#cancelSync(SyncRequest).

Eine Synchronisierung wird abgebrochen, indem sie einen Thread#interrupt() im Synchronisierungsthread ausgibt. <stark>Entweder muss Ihr Code #onPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult) überprüft Thread#interrupted()werden, oder Sie müssen eine von#onSyncCanceled()<#onSyncCanceled(Thread)/ /strong> überschreiben (je nachdem, ob ihr Adapter die Synchronisierung mehrerer Konten parallel unterstützt). Wenn ihr Adapter den vom Framework ausgestellten Abbruch nicht berücksichtigt, riskieren Sie, dass der gesamte Prozess Ihrer App getötet wird.

Um ein Synchronisierungsadapter zu sein, der diese Klasse erweitern muss, stellen Sie Implementierungen für die abstrakten Methoden bereit und schreiben einen Dienst, der das Ergebnis des #getSyncAdapterBinder() Diensts android.app.Service#onBind(android.content.Intent) zurückgibt, wenn er mit einer Aktion android.content.SyncAdapteraufgerufen wird. Dieser Dienst muss die folgenden Absichtsfilter- und Metadatentags in der AndroidManifest.xml Datei angeben.

&lt;intent-filter&gt;
                &lt;action android:name="android.content.SyncAdapter" /&gt;
              &lt;/intent-filter&gt;
              &lt;meta-data android:name="android.content.SyncAdapter"
                        android:resource="@xml/syncadapter" /&gt;

Das android:resource Attribut muss auf eine Ressource verweisen, die wie folgt aussieht:

&lt;sync-adapter xmlns:android="http://schemas.android.com/apk/res/android"
               android:contentAuthority="authority"
               android:accountType="accountType"
               android:userVisible="true|false"
               android:supportsUploading="true|false"
               android:allowParallelSyncs="true|false"
               android:isAlwaysSyncable="true|false"
               android:syncAdapterSettingsAction="ACTION_OF_SETTINGS_ACTIVITY"
            /&gt;

<ul><li>Die android:contentAuthority Und android:accountType Attribute geben an, welche Inhaltsautorität und für welche Kontotypen dieser Synchronisierungsadapter dient. <Li>android:userVisible ist standardmäßig auf "true" festgelegt und steuert, ob dieser Synchronisierungsadapter im Bildschirm "Synchronisierungseinstellungen" angezeigt wird. <li>android:supportsUploading ist standardmäßig auf "true" festgelegt, und wenn "true" für alle Synchronisierungsadapter angefordert wird, die einer Autorität zugeordnet sind, wenn der Inhaltsanbieter dieser Autorität eine ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver, boolean) Synchronisierung mit "syncToNetwork" auf "true" festgelegt hat. <li>android:allowParallelSyncs ist standardmäßig auf "false" festgelegt, und wenn "true" angibt, dass der Synchronisierungsadapter Synchronisierungen für mehrere Konten gleichzeitig verarbeiten kann. Andernfalls wartet der SyncManager, bis der Synchronisierungsadapter nicht verwendet wird, bevor angefordert wird, dass die Daten eines Kontos synchronisiert werden. <li>android:isAlwaysSyncable ist standardmäßig auf "false" festgelegt, und wenn "true" dem SyncManager angibt, den isSyncable-Zustand für jeden hinzugefügten Synchronisierungsadapter auf 1 zu initialisieren. <li>android:syncAdapterSettingsAction ist standardmäßig null und wenn angegeben, wird eine Intent-Aktion einer Aktivität angegeben, die verwendet werden kann, um die Synchronisierungseinstellungen des Synchronisierungsadapters anzupassen. Die Aktivität muss sich im selben Paket wie der Synchronisierungsadapter befinden. </ul>

Java Dokumentation für android.content.AbstractThreadedSyncAdapter.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
AbstractThreadedSyncAdapter(Context, Boolean, Boolean)	Erstellt ein `AbstractThreadedSyncAdapter`.
AbstractThreadedSyncAdapter(Context, Boolean)	Erstellt ein `AbstractThreadedSyncAdapter`.
AbstractThreadedSyncAdapter(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Felder

Name	Beschreibung
LogSyncDetails	Veraltet. Kernel-Ereignisprotokolltag.

Eigenschaften

Name	Beschreibung
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Context
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
JniIdentityHashCode	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
JniPeerMembers	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird.
PeerReference	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
SyncAdapterBinder
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Dispose()	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
Dispose(Boolean)	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
JavaFinalize()	Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
OnPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult)	Führen Sie eine Synchronisierung für dieses Konto aus.
OnSecurityException(Account, Bundle, String, SyncResult)	Melden Sie, dass beim Öffnen des Inhaltsanbieters vor dem Aufrufen `#onPerformSync`eine Sicherheits ausnahme aufgetreten ist.
OnSyncCanceled()	Gibt an, dass ein Synchronisierungsvorgang abgebrochen wurde.
OnSyncCanceled(Thread)	Gibt an, dass ein Synchronisierungsvorgang abgebrochen wurde.
OnUnsyncableAccount()	Ermöglicht das Zurückstellen der Synchronisierung, bis alle Konten ordnungsgemäß eingerichtet sind.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
ToArray<T>()	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em> oder <em>unterbrochen</em>.<>< (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
IJavaPeerable.DisposeUnlessReferenced()	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
IJavaPeerable.Finalized()	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
IJavaPeerable.JniManagedPeerState	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird. (Geerbt von Object)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `TResult`zu `self` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Eine abstrakte Implementierung eines SyncAdapters, mit dem ein Thread zum Aufrufen eines Synchronisierungsvorgangs spawns wird.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `TResult`zu `self` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: