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 推播通知服務要求 PushNotificationChannel (WNS) 。

屬性
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) 。 指定的應用程式必須與呼叫的應用程式位於相同的套件中。 此多載應該只從多應用程式套件呼叫，大部分的應用程式都應該使用 方法，而不使用 參數。

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

要系結至推播通知通道之 app 的套件相對應用程式識別碼 (PRAID) 。 指定的應用程式必須與呼叫的應用程式位於相同的套件中。 如需 PRAID 的詳細資訊，請參閱Application元素的Id屬性。

如果您要在跨進程 COM 伺服器中裝載背景工作 () ，請與主要應用程式分開，然後傳遞作為應用程式之 PRAID 的引數 applicationId ，該應用程式會在自己的套件資訊清單中定義 windows.backgroundTask 擴充功能。

傳回

IAsyncOperation<PushNotificationChannel>

系結至 applicationId中指定的應用程式的物件，用來向 Windows 推播通知服務要求 PushNotificationChannel (WNS) 。

屬性
OverloadAttribute RemoteAsyncAttribute

備註

抵達此通道的磚更新、快顯通知和徽章通知會傳遞至應用程式的主要或預設磚。

如果您嘗試在沒有任何資料連線時註冊 WNS 推播通知通道，就會擲回例外狀況。

另請參閱

適用於