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 | |
|---|---|---|
.gif "Public method") |
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 | |
|---|---|---|
.gif "Public property") |
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.) |
.gif "Protected method") |
Finalize | Frees resources and performs cleanup operations before the class instance is reclaimed by garbage collection. (Overrides Object..::.Finalize()()().) |
.gif "Static member") |
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 | |
|---|---|---|
.gif "Public event") |
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.