Interface INotificationRegistration

Namespace

PushTechnology.ClientInterface.Client.Features.Control.Topics

Assembly

Diffusion.Client.dll

This represents the registration state of the associated listener on the server.

public interface INotificationRegistration : IRegistration

Inherited Members

IRegistration.CloseAsync()

Remarks

This registration also provides operations to control which topic paths the listener will receive notifications for.

Methods

DeselectAsync(ITopicSelector)

Requests to stop receiving notifications for all topics matched by the given selector.

[Obsolete("Topic selectors are now deprecated and will be removed in a future release.Instead, use the DeselectAsync method that accepts a string argument.", false)]
Task<object> DeselectAsync(ITopicSelector selector)

Parameters

selector ITopicSelector

The selector to register.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

Caution

Deprecated since 6.4. Topic selectors are no longer verified locally by the client library. Instead System.String expressions will be sent to (and verified by) the Diffusion server. This method will be removed in a future release.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

DeselectAsync(ITopicSelector, CancellationToken)

Requests to stop receiving notifications for all topics matched by the given selector.

[Obsolete("Topic selectors are now deprecated and will be removed in a future release.Instead, use the DeselectAsync method that accepts a string argument.", false)]
Task<object> DeselectAsync(ITopicSelector selector, CancellationToken cancellationToken)

Parameters

selector ITopicSelector

The selector to register.

cancellationToken CancellationToken

The cancellation token used to cancel the current operation.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

This method is the same as calling DeselectAsync(ITopicSelector, CancellationToken) with System.Threading.CancellationToken.None.

Caution

Deprecated since 6.4. Topic selectors are no longer verified locally by the client library. Instead System.String expressions will be sent to (and verified by) the Diffusion server. This method will be removed in a future release.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

See Also

DeselectAsync(ITopicSelector)

DeselectAsync(string)

Requests to stop receiving notifications for all topics matched by the given selector.

Task<object> DeselectAsync(string selector)

Parameters

selector string

The selector to register.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

This is equivalent to calling DeselectAsync(ITopicSelector) with a selector parsed using Parse(string).

This method is the same as calling DeselectAsync(string, CancellationToken) with System.Threading.CancellationToken.None.

The given selector expression will be evaluated by the server.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

See Also

DeselectAsync(ITopicSelector)

DeselectAsync(string, CancellationToken)

DeselectAsync(string, CancellationToken)

Requests to stop receiving notifications for all topics matched by the given selector.

Task<object> DeselectAsync(string selector, CancellationToken cancellationToken)

Parameters

selector string

The selector to register.

cancellationToken CancellationToken

The cancellation token used to cancel the current operation.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

This is equivalent to calling DeselectAsync(ITopicSelector) with a selector parsed using Parse(string).

The given selector expression will be evaluated by the server.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

See Also

DeselectAsync(ITopicSelector, CancellationToken)

SelectAsync(ITopicSelector)

Requests to receive notifications for all topics matched by the provided topic selector.

[Obsolete("Topic selectors are now deprecated and will be removed in a future release.Instead, use the SelectAsync method that accepts a string argument.", false)]
Task<object> SelectAsync(ITopicSelector selector)

Parameters

selector ITopicSelector

The selector to register.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

This method is the same as calling SelectAsync(ITopicSelector, CancellationToken) with System.Threading.CancellationToken.None.

Caution

Deprecated since 6.4. Topic selectors are no longer verified locally by the client library. Instead System.String expressions will be sent to (and verified by) the Diffusion server. This method will be removed in a future release.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

See Also

SelectAsync(ITopicSelector, CancellationToken)

SelectAsync(ITopicSelector, CancellationToken)

Requests to receive notifications for all topics matched by the provided topic selector.

[Obsolete("Topic selectors are now deprecated and will be removed in a future release.Instead, use the SelectAsync method that accepts a string argument.", false)]
Task<object> SelectAsync(ITopicSelector selector, CancellationToken cancellationToken)

Parameters

selector ITopicSelector

The selector to register.

cancellationToken CancellationToken

The cancellation token used to cancel the current operation.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

Caution

Deprecated since 6.4. Topic selectors are no longer verified locally by the client library. Instead System.String expressions will be sent to (and verified by) the Diffusion server. This method will be removed in a future release.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

SelectAsync(string)

Requests to receive notifications for all topics matched by the provided selector.

Task<object> SelectAsync(string selector)

Parameters

selector string

The selector to register.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

This is equivalent to calling SelectAsync(ITopicSelector) with a selector parsed using Parse(string).

This method is the same as calling SelectAsync(string, CancellationToken) with System.Threading.CancellationToken.None.

The given selector expression will be evaluated by the server.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

See Also

SelectAsync(ITopicSelector)

SelectAsync(string, CancellationToken)

SelectAsync(string, CancellationToken)

Requests to receive notifications for all topics matched by the provided selector.

Task<object> SelectAsync(string selector, CancellationToken cancellationToken)

Parameters

selector string

The selector to register.

cancellationToken CancellationToken

The cancellation token used to cancel the current operation.

Returns

Task<object>

The Task representing the current operation.

Remarks

If the operation completes successfully, the Task result will be null.

This is equivalent to calling SelectAsync(ITopicSelector) with a selector parsed using Parse(string).

The given selector expression will be evaluated by the server.

Exceptions

SessionSecurityException

The calling session does not have SELECT_TOPIC permission for the selector expression. Thrown by the returned Task.

SessionClosedException

The calling session is closed. Thrown by the returned Task.

See Also

SelectAsync(ITopicSelector, CancellationToken)