HttpNotificationChannel Class

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Creates a notification channel between the Microsoft Push Notification Service and the Push Client and creates a new subscription for raw notifications.

Inheritance Hierarchy

System..::.Object
Microsoft.Phone.Notification..::.HttpNotificationChannel

Namespace: Microsoft.Phone.Notification
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)

Syntax

Public Class HttpNotificationChannel _
    Implements IDisposable
public class HttpNotificationChannel : IDisposable

The HttpNotificationChannel type exposes the following members.

Constructors

Name Description
HttpNotificationChannel(String) Creates a notification channel. The application will identify the notification channel using the channelName value.
HttpNotificationChannel(String, String) Creates a notification channel. Use this constructor with an authenticated web service. The application will identify the notification channel using the channelName value. The serviceName value identifies the Subject Name of the authenticated web service's certificate.

Top

Properties

Name Description
ChannelName The name of the notification channel.
ChannelUri The current active notification channel URI.
ConnectionStatus Get the current channel connection status.
IsShellTileBound Indicates whether the notification channel is currently bound to a Tile notification subscription.
IsShellToastBound Indicates whether the notification channel is currently bound to a toast notification subscription.

Top

Methods

Name Description
BindToShellTile()()() Binds the application’s default Tile with a notification subscription. The Tile can contain only local references for resources.
BindToShellTile(Collection<(Of <(Uri>)>)) Binds the Tile passed as the input parameter with a notification subscription. The Tile can contain either a local or remote resource reference.
BindToShellToast Binds a toast notification subscription to the HttpNotificationChannel class instance.
Close Closes a notification channel and disassociates all of the subscriptions associated with this instance of the HttpNotificationChannel class.
Dispose Disposes the class.
Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Finalize Frees resources and performs cleanup operations before the class instance is reclaimed by garbage collection. (Overrides Object..::.Finalize()()().)
Find Finds a previously created notification channel.
GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
GetType Gets the Type of the current instance. (Inherited from Object.)
MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Open Opens a notification channel with the Microsoft Push Notification Service.
ToString Returns a string that represents the current object. (Inherited from Object.)
UnbindToShellTile Unbinds the active Tile notification subscription from the notification channel.
UnbindToShellToast Unbinds the active toast notification subscription from the notification channel.

Top

Events

Name Description
ChannelUriUpdated Returns the URI associated with the notification channel.
ConnectionStatusChanged Occurs when the connection status has changed.
ErrorOccurred Raised when something unexpected happens when using the HttpNotificationChannel class.
HttpNotificationReceived Raised when the application receives a raw notification.
ShellToastNotificationReceived Raised when the application receives a toast notification.

Top

Remarks

For more information about push notifications, see Push notifications for Windows Phone 8.

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.Phone.Notification Namespace