IObservable<T>.Subscribe(IObserver<T>) Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Уведомляет поставщика о том, что наблюдатель должен получать уведомления.

public:
 IDisposable ^ Subscribe(IObserver<T> ^ observer);

public IDisposable Subscribe (IObserver<out T> observer);

abstract member Subscribe : IObserver<'T> -> IDisposable

Public Function Subscribe (observer As IObserver(Of Out T)) As IDisposable

Параметры

observer

IObserver<T>

Объект, который должен получать уведомления.

Возвращаемое значение

IDisposable

Ссылка на интерфейс, позволяющий наблюдателям прекратить получение уведомлений до того, как поставщик завершит их отправку.

Примеры

В следующем примере показан Subscribe метод для приложения, которое сообщает сведения о широте и долготе. Он определяет IList<T> объект коллекции, в который хранятся ссылки на все наблюдатели. Он также возвращает частный класс, который Unsubscriber реализует IDisposable интерфейс и позволяет подписчикам перестать получать уведомления о событиях. Полный пример см. в разделе IObservable<T> "Пример" раздела.

private List<IObserver<Location>> observers;

public IDisposable Subscribe(IObserver<Location> observer)
{
   if (! observers.Contains(observer))
      observers.Add(observer);
   return new Unsubscriber(observers, observer);
}

private class Unsubscriber : IDisposable
{
   private List<IObserver<Location>>_observers;
   private IObserver<Location> _observer;

   public Unsubscriber(List<IObserver<Location>> observers, IObserver<Location> observer)
   {
      this._observers = observers;
      this._observer = observer;
   }

   public void Dispose()
   {
      if (_observer != null && _observers.Contains(_observer))
         _observers.Remove(_observer);
   }
}

let observers = ResizeArray<IObserver<Location>>()

interface IObservable<Location> with
    member _.Subscribe(observer) =
        if observers.Contains observer |> not then
            observers.Add observer
        new Unsubscriber(observers, observer)

Private observers As List(Of IObserver(Of Location))

Public Function Subscribe(ByVal observer As System.IObserver(Of Location)) As System.IDisposable _
                         Implements System.IObservable(Of Location).Subscribe
   If Not observers.Contains(observer) Then
      observers.Add(observer)
   End If
   Return New Unsubscriber(observers, observer)
End Function

Private Class Unsubscriber : Implements IDisposable
   Private _observers As List(Of IObserver(Of Location))
   Private _observer As IObserver(Of Location)

   Public Sub New(ByVal observers As List(Of IObserver(Of Location)), ByVal observer As IObserver(Of Location))
      Me._observers = observers
      Me._observer = observer
   End Sub

   Public Sub Dispose() Implements IDisposable.Dispose
      If _observer IsNot Nothing AndAlso _observers.Contains(_observer) Then
         _observers.Remove(_observer)
      End If
   End Sub
End Class

Комментарии

Этот Subscribe метод необходимо вызвать для регистрации наблюдателя для push-уведомлений. Типичная реализация Subscribe метода выполняет следующие действия.

• Он сохраняет ссылку на наблюдателя в объекте коллекции, например List<T> объекте.

• Он возвращает ссылку на IDisposable интерфейс. Это позволяет наблюдателям отменить подписку (т. е. прекратить получение уведомлений) до завершения отправки и вызова метода подписчика OnCompleted .

В любой момент времени конкретный экземпляр IObservable<T> реализации отвечает за обработку всех подписок и уведомление всех подписчиков. Если в документации по конкретной IObservable<T> реализации не указано иное, наблюдатели не должны делать никаких предположений о IObservable<T> реализации, таких как порядок уведомлений, которые будут получать несколько наблюдателей.

См. также раздел

• IObserver<T>