AbstractThreadedSyncAdapter クラス

定義

名前空間:: Android.Content

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。

[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

継承: Object

Object
AbstractThreadedSyncAdapter

属性: RegisterAttribute

注釈

同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。同期要求の受信時に同期操作が既に進行中の場合は、新しい要求にエラーが返され、既存の要求の続行が許可されます。ただし、進行中の同期がない場合は、スレッドが生成され、そのスレッドで #onPerformSync が呼び出されます。

同期は、フレームワークによっていつでも取り消すことができます。たとえば、ユーザーが開始せず、10 分を超える期間の同期は、タイムアウトと見なされ、取り消されます。同様に、フレームワークは、1 分間にわたってそのネットワークアクティビティを監視することで、アダプターが進行しているかどうかを判断しようとします。このウィンドウ上のネットワークトラフィックがゼロに近い場合、同期は取り消されます。 ContentResolver#cancelSync(Account, String)またはContentResolver#cancelSync(SyncRequest)を使用して同期の取り消しを要求することもできます。

同期スレッドで Thread#interrupt() を発行すると、同期が取り消されます。 <strong>#onPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult) 内のコードで Thread#interrupted()を確認する必要はありません。または、(アダプターが複数のアカウントの並列同期をサポートしているかどうかに応じて) #onSyncCanceled(Thread)/#onSyncCanceled()</strong> のいずれかをオーバーライドする必要があります。アダプターがフレームワークによって発行されたキャンセルを考慮しない場合は、アプリのプロセス全体が強制終了されるリスクを実行します。

同期アダプターにするには、このクラスを拡張し、抽象メソッドの実装を提供し、アクション android.content.SyncAdapterを使用して意図を使用して呼び出されたときにサービスのandroid.app.Service#onBind(android.content.Intent)で#getSyncAdapterBinder()の結果を返すサービスを記述する必要があります。このサービスでは、AndroidManifest.xml ファイルに次の意図フィルターとメタデータタグを指定する必要があります

&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;

android:resource属性は、次のようなリソースを指している必要があります。

&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>android:contentAuthority属性とandroid:accountType属性は、どのコンテンツ機関と、この同期アダプターが機能するアカウントの種類を示します。 <li>android:userVisible は既定で true に設定され、[同期設定] 画面にこの同期アダプターが表示されるかどうかを制御します。 <li>android:supportsUploading の既定値は true で、true の場合、その機関のコンテンツプロバイダーが syncToNetwork が true に設定された ContentResolver#notifyChange(android.net.Uri, android.database.ContentObserver, boolean) を実行するたびに、機関に関連付けられているすべての syncadapter に対してアップロード専用同期が要求されます。 <li>android:allowParallelSyncs の既定値は false で、true の場合は同期アダプターが複数のアカウントの同期を同時に処理できることを示します。それ以外の場合、SyncManager は、アカウントのデータを同期することを要求する前に、同期アダプターが使用されないまで待機します。 <li>android:isAlwaysSyncable の既定値は false で、true の場合は、追加されるアカウントごとにその同期アダプターの isSyncable 状態を 1 に初期化するように SyncManager に指示します。 <li>android:syncAdapterSettingsAction は既定で null に設定され、指定された場合は、同期アダプターの同期設定の調整に使用できるアクティビティのインテントアクションを指定します。アクティビティは、同期アダプターと同じパッケージに含まれている必要があります。 </ul>

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前	説明
AbstractThreadedSyncAdapter(Context, Boolean, Boolean)	`AbstractThreadedSyncAdapter` を作成します。
AbstractThreadedSyncAdapter(Context, Boolean)	`AbstractThreadedSyncAdapter` を作成します。
AbstractThreadedSyncAdapter(IntPtr, JniHandleOwnership)	JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

フィールド

名前	説明
LogSyncDetails	古い. カーネルイベントログタグ。

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Context
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
JniPeerMembers	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。
PeerReference	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
SyncAdapterBinder
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

メソッド

名前	説明
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
Dispose()	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
Dispose(Boolean)	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
OnPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult)	このアカウントの同期を実行します。
OnSecurityException(Account, Bundle, String, SyncResult)	`#onPerformSync`を呼び出す前にコンテンツプロバイダーを開くときにセキュリティ例外が発生したことを報告します。
OnSyncCanceled()	同期操作が取り消されたことを示します。
OnSyncCanceled(Thread)	同期操作が取り消されたことを示します。
OnUnsyncableAccount()	すべてのアカウントが適切に設定されるまで同期を延期できます。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
ToArray<T>()	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

名前	説明
IJavaPeerable.Disposed()	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
IJavaPeerable.Finalized()	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。 (継承元 Object)

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	同期操作を呼び出すスレッドを生成する SyncAdapter の抽象実装。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象