PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync メソッド

定義

名前空間:

Windows.Networking.PushNotifications

オーバーロード

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)

戻り値

IAsyncOperation<PushNotificationChannel>

呼び出し元アプリにバインドされた オブジェクト。これは、Windows プッシュ通知サービス (WNS) から PushNotificationChannel を要求するために使用されます。

属性

OverloadAttribute RemoteAsyncAttribute

例

次の例は、このメソッドを使用して、呼び出し元アプリのチャネルを取得する方法を示しています。

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として を渡します。

戻り値

IAsyncOperation<PushNotificationChannel>

applicationId で指定されたアプリにバインドされた オブジェクト。これは、Windows プッシュ通知サービス (WNS) から PushNotificationChannel を要求するために使用されます。

属性

OverloadAttribute RemoteAsyncAttribute

注釈

このチャネルに到着したタイルの更新、トースト、バッジの通知は、アプリのメインまたは既定のタイルに配信されます。

データ接続がないときに WNS プッシュ通知チャネルを登録しようとすると、例外がスローされます。

こちらもご覧ください

• CreatePushNotificationChannelForApplicationAsync()
• Windows プッシュ通知サービス (WNS) の概要
• プッシュ通知と定期的な通知のサンプル (アーカイブ済み)
• クイック スタート: タイル プッシュ通知の送信
• クイック スタート: トースト プッシュ通知の送信
• プッシュ通知を使用してバッジを更新する方法
• Windows プッシュ通知サービス (WNS) に対して認証する方法
• 通知チャネルを要求、作成、保存する方法
• プッシュ通知のガイドラインとチェック リスト
• プッシュ通知サービスの要求ヘッダーと応答ヘッダー