HttpNotificationChannel Class

Article
11/23/2015

[ 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.

Share via