PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
CreatePushNotificationChannelForApplicationAsync() |
呼び出し元アプリにバインドされた オブジェクトを作成します。このオブジェクトを使用して、Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得します。 |
CreatePushNotificationChannelForApplicationAsync(String) |
Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得する、指定したアプリにバインドされた オブジェクトを作成します。 指定したアプリは、呼び出し元アプリと同じパッケージに含まれている必要があります。 このオーバーロードはマルチアプリ パッケージからのみ呼び出す必要があります。ほとんどのアプリでは、 メソッドをパラメーターなしで使用する必要があります。 |
CreatePushNotificationChannelForApplicationAsync()
呼び出し元アプリにバインドされた オブジェクトを作成します。このオブジェクトを使用して、Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得します。
public:
static IAsyncOperation<PushNotificationChannel ^> ^ CreatePushNotificationChannelForApplicationAsync();
/// [Windows.Foundation.Metadata.Overload("CreatePushNotificationChannelForApplicationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<PushNotificationChannel> CreatePushNotificationChannelForApplicationAsync();
[Windows.Foundation.Metadata.Overload("CreatePushNotificationChannelForApplicationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<PushNotificationChannel> CreatePushNotificationChannelForApplicationAsync();
function createPushNotificationChannelForApplicationAsync()
Public Shared Function CreatePushNotificationChannelForApplicationAsync () As IAsyncOperation(Of PushNotificationChannel)
戻り値
呼び出し元アプリにバインドされた オブジェクト。これは、Windows プッシュ通知サービス (WNS) から PushNotificationChannel を要求するために使用されます。
- 属性
例
次の例は、このメソッドを使用して、呼び出し元アプリのチャネルを取得する方法を示しています。
var pushNotifications = Windows.Networking.PushNotifications;
var channel;
function openNotificationsChannel() {
var channelOperation = pushNotifications.PushNotificationChannelManager.createPushNotificationChannelForApplicationAsync();
return channelOperation.then(function (newChannel) {
channel = newChannel;
}
);
注釈
このチャネルに到着したタイルの更新、トースト、バッジの通知は、アプリのメインまたは既定のタイルに配信されます。
データ接続がないときに WNS プッシュ通知チャネルを登録しようとすると、例外がスローされます。
こちらもご覧ください
- CreatePushNotificationChannelForApplicationAsync(String)
- Windows プッシュ通知サービス (WNS) の概要
- プッシュ通知と定期的な通知のサンプル (アーカイブ済み)
- クイック スタート: プッシュ通知の送信
- 通知チャネルを要求、作成、保存する方法
- プッシュ通知サービスの要求ヘッダーと応答ヘッダー
適用対象
CreatePushNotificationChannelForApplicationAsync(String)
Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得する、指定したアプリにバインドされた オブジェクトを作成します。 指定したアプリは、呼び出し元アプリと同じパッケージに含まれている必要があります。 このオーバーロードはマルチアプリ パッケージからのみ呼び出す必要があります。ほとんどのアプリでは、 メソッドをパラメーターなしで使用する必要があります。
public:
static IAsyncOperation<PushNotificationChannel ^> ^ CreatePushNotificationChannelForApplicationAsync(Platform::String ^ applicationId);
/// [Windows.Foundation.Metadata.Overload("CreatePushNotificationChannelForApplicationAsyncWithId")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<PushNotificationChannel> CreatePushNotificationChannelForApplicationAsync(winrt::hstring const& applicationId);
[Windows.Foundation.Metadata.Overload("CreatePushNotificationChannelForApplicationAsyncWithId")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<PushNotificationChannel> CreatePushNotificationChannelForApplicationAsync(string applicationId);
function createPushNotificationChannelForApplicationAsync(applicationId)
Public Shared Function CreatePushNotificationChannelForApplicationAsync (applicationId As String) As IAsyncOperation(Of PushNotificationChannel)
パラメーター
- applicationId
-
String
Platform::String
winrt::hstring
プッシュ通知チャネルにバインドするアプリのパッケージ相対アプリケーション識別子 (PRAID)。 指定したアプリは、呼び出し元アプリと同じパッケージに含まれている必要があります。 PRAID の詳細については、Application 要素の Id 属性を参照してください。
アウトプロセス COM サーバーでバックグラウンド タスクをホストしている場合は、メイン アプリケーションとは別に、独自のパッケージ マニフェストで拡張機能を定義windows.backgroundTask
するアプリケーションの PRAID の引数applicationId
として を渡します。
戻り値
applicationId で指定されたアプリにバインドされた オブジェクト。これは、Windows プッシュ通知サービス (WNS) から PushNotificationChannel を要求するために使用されます。
- 属性
注釈
このチャネルに到着したタイルの更新、トースト、バッジの通知は、アプリのメインまたは既定のタイルに配信されます。
データ接続がないときに WNS プッシュ通知チャネルを登録しようとすると、例外がスローされます。
こちらもご覧ください
- CreatePushNotificationChannelForApplicationAsync()
- Windows プッシュ通知サービス (WNS) の概要
- プッシュ通知と定期的な通知のサンプル (アーカイブ済み)
- クイック スタート: タイル プッシュ通知の送信
- クイック スタート: トースト プッシュ通知の送信
- プッシュ通知を使用してバッジを更新する方法
- Windows プッシュ通知サービス (WNS) に対して認証する方法
- 通知チャネルを要求、作成、保存する方法
- プッシュ通知のガイドラインとチェック リスト
- プッシュ通知サービスの要求ヘッダーと応答ヘッダー