ReadOnlyObservableNotificationCollection Class

Article
09/23/2016

Represents a read-only, observable collection of persistent notifications.

Namespace: Microsoft.WindowsServerSolutions.Common.ProviderFramework.Notifications
Assembly: CoreProviders (in CoreProviders.dll)

Inheritance Hierarchy

System.Object
System.Collections.ObjectModel.ReadOnlyCollection<T>
System.Collections.ObjectModel.ReadOnlyObservableCollection<T>
Microsoft.WindowsServerSolutions.Common.ProviderFramework.Notifications.ReadOnlyObservableNotificationCollection

Syntax

public class ReadOnlyObservableNotificationCollection : ReadOnlyObservableCollection<Notification>, 
    IDisposable

public ref class ReadOnlyObservableNotificationCollection : ReadOnlyObservableCollection<Notification^>, 
    IDisposable

Public Class ReadOnlyObservableNotificationCollection
    Inherits ReadOnlyObservableCollection(Of Notification)
    Implements IDisposable

Properties

	Name	Description
	Count	(Inherited from ReadOnlyCollection<T>.)
	Item[Int32]	(Inherited from ReadOnlyCollection<T>.)
	Items	(Inherited from ReadOnlyCollection<T>.)

Methods

	Name	Description
	Contains(T)	(Inherited from ReadOnlyCollection<T>.)
	CopyTo(T[], Int32)	(Inherited from ReadOnlyCollection<T>.)
	Create(Boolean, String[])	Creates a subscription to receive persistent notifications through a ReadOnlyObservableNotificationCollection object. The subscription can be specified to receive notifications from the Notifications Provider on the server or the local computer. The subscription can also be filtered with a list of categories.
	Create(String[])	Creates a subscription to receive persistent notifications through a ReadOnlyObservableNotificationCollection object. The subscription can be filtered with a list of categories.
	Dispose()	Releases all resources that are used by the ReadOnlyObservableNotificationCollection object.
	Dispose(Boolean)	Releases the unmanaged resources used by the ReadOnlyObservableNotificationCollection object and optionally releases the managed resources.
	Equals(Object)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GetEnumerator()	(Inherited from ReadOnlyCollection<T>.)
	GetHashCode()	(Inherited from Object.)
	GetType()	(Inherited from Object.)
	IndexOf(T)	(Inherited from ReadOnlyCollection<T>.)
	MemberwiseClone()	(Inherited from Object.)
	OnCollectionChanged(NotifyCollectionChangedEventArgs)	(Inherited from ReadOnlyObservableCollection<T>.)
	OnPropertyChanged(PropertyChangedEventArgs)	(Inherited from ReadOnlyObservableCollection<T>.)
	RequestNotificationChange(NotificationChangeRequest)	Sends a request to the source of a notification to change it.
	Start()	Starts the subscription that is represented by the ReadOnlyObservableNotificationCollection object.
	ToString()	(Inherited from Object.)

Events

	Name	Description
	CollectionChanged	(Inherited from ReadOnlyObservableCollection<T>.)
	PropertyChanged	(Inherited from ReadOnlyObservableCollection<T>.)

Explicit Interface Implementations

	Name	Description
	INotifyCollectionChanged.CollectionChanged	(Inherited from ReadOnlyObservableCollection<T>.)
	INotifyPropertyChanged.PropertyChanged	(Inherited from ReadOnlyObservableCollection<T>.)
	ICollection<T>.Add(T)	(Inherited from ReadOnlyCollection<T>.)
	ICollection<T>.Clear()	(Inherited from ReadOnlyCollection<T>.)
	ICollection<T>.Remove(T)	(Inherited from ReadOnlyCollection<T>.)
	IList<T>.Insert(Int32, T)	(Inherited from ReadOnlyCollection<T>.)
	IList<T>.RemoveAt(Int32)	(Inherited from ReadOnlyCollection<T>.)
	ICollection.CopyTo(Array, Int32)	(Inherited from ReadOnlyCollection<T>.)
	IEnumerable.GetEnumerator()	(Inherited from ReadOnlyCollection<T>.)
	IList.Add(Object)	(Inherited from ReadOnlyCollection<T>.)
	IList.Clear()	(Inherited from ReadOnlyCollection<T>.)
	IList.Contains(Object)	(Inherited from ReadOnlyCollection<T>.)
	IList.IndexOf(Object)	(Inherited from ReadOnlyCollection<T>.)
	IList.Insert(Int32, Object)	(Inherited from ReadOnlyCollection<T>.)
	IList.Remove(Object)	(Inherited from ReadOnlyCollection<T>.)
	IList.RemoveAt(Int32)	(Inherited from ReadOnlyCollection<T>.)
	ICollection<T>.IsReadOnly	(Inherited from ReadOnlyCollection<T>.)
	IList<T>.Item[Int32]	(Inherited from ReadOnlyCollection<T>.)
	ICollection.IsSynchronized	(Inherited from ReadOnlyCollection<T>.)
	ICollection.SyncRoot	(Inherited from ReadOnlyCollection<T>.)
	IList.IsFixedSize	(Inherited from ReadOnlyCollection<T>.)
	IList.IsReadOnly	(Inherited from ReadOnlyCollection<T>.)
	IList.Item[Int32]	(Inherited from ReadOnlyCollection<T>.)

Remarks

This collection class is returned from the DeviceInfoCollection property, the GetAllDevicesInfo method, and the GetAllDevicesInfoAsync method. Once you have subscribed and started the subscription via the CollectionChanged event, objects that match your subscription parameters are added, replaced, and removed from the collection as notifications are raised, updated, and cleared. It is useful to develop a self-updating user interface for your devices.

Note that the only difference between the DeviceInfoCollection property and the GetAllDevicesInfo/GetAllDevicesInfoAsync methods is that by getting the DeviceInfoCollection property value, the DevicesManager will not attempt to get the latest device list from the provider. However, when the DevicesManager is connected, it will be updated automatically and the caller is expected to receive the CollectionChanged events. Conversely, the GetAllDevicesInfo/GetAllDevicesInfoAsync methods will try to call the provider to get the latest device list.

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