BackgroundTaskBuilder.Register メソッド

定義

名前空間:

Windows.ApplicationModel.Background

オーバーロード

Register()	バックグラウンド タスクをシステムに登録します。
Register(String)

Register()

バックグラウンド タスクをシステムに登録します。

public:
 virtual BackgroundTaskRegistration ^ Register() = Register;

BackgroundTaskRegistration Register();

public BackgroundTaskRegistration Register();

function register()

Public Function Register () As BackgroundTaskRegistration

戻り値

BackgroundTaskRegistration

BackgroundTaskRegistration オブジェクトのインスタンス。

例

BackgroundTask サンプル

注釈

Register メソッドを成功させるには、タスクにイベント トリガーが必要です。 トリガー イベントが発生し、そのすべての条件が満たされたときに、バックグラウンド タスクがスケジュールされます。

アウトプロセスバックグラウンドタスクでは、タスクエントリポイントも指定する必要があります。 各種類 のタスクの登録の詳細については、「インプロセス バックグラウンド タスク の 作成と登録」および「アウトプロセスバックグラウンド タスクの作成と 登録」を参照してください。

バックグラウンド タスク パラメーターの検証

Windows 8 Windows 8は、システムがバックグラウンド タスクの実行を試みるまで、BackgroundTaskBuilder オブジェクトに設定されたパラメーターを検証しません。 パラメーターが有効でない場合は、バックグラウンド タスクを開始できないため、イベント ログ エントリが作成されます。

Windows 8.1 Windows 8.1 以降、バックグラウンド タスクの登録に使用されるパラメーターは、登録時に検証されます。 バックグラウンド タスクの登録が失敗するとエラーが返され、アプリはバックグラウンド タスクが有効かどうかを判断できます。 C# と Visual Basic の場合、タスク登録エラーは通常、特定の .NET 例外がスローされます。 これらの例外は初回例外としてスローされ、コードの開発中に修正する必要があります。Windows 8.1で実行されている既存のWindows 8 アプリは、この新しいシステム動作の影響を受けます。これにより、バックグラウンド タスクの登録に失敗した場合にアプリがクラッシュする可能性があります。 (失敗したバックグラウンド タスクの登録に対してイベント ログ エントリが生成されます)。その結果、無効なバックグラウンド タスクを登録するWindows 8アプリは、バックグラウンド タスクを正しく登録し、失敗したバックグラウンド タスクの登録をキャッチされた例外として処理するように書き直す必要があります。

Register(String)

public:
 virtual BackgroundTaskRegistration ^ Register(Platform::String ^ taskName) = Register;

BackgroundTaskRegistration Register(winrt::hstring const& taskName);

public BackgroundTaskRegistration Register(string taskName);

function register(taskName)

Public Function Register (taskName As String) As BackgroundTaskRegistration

パラメーター

taskName

String

Platform::String

winrt::hstring

戻り値

BackgroundTaskRegistration