Diffusion .NET API  5.9.24
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Properties Events Pages
PushTechnology.ClientInterface.Client.Topics.Update.IPagedRecordOrderedUpdateFactory Interface Reference

Update factory for ordered TopicType.PAGED_RECORD topics. More...

Inheritance diagram for PushTechnology.ClientInterface.Client.Topics.Update.IPagedRecordOrderedUpdateFactory:
PushTechnology.ClientInterface.Client.Topics.Update.IPagedUpdateFactory PushTechnology.ClientInterface.Client.Topics.Update.IUpdateFactory

Public Member Functions

IUpdate Add (IRecord line)
 Create an update that will add a line to the paged topic. More...
 
IUpdate Update (IRecord line)
 Create an update that will update a line within the paged topic. More...
 
IUpdate Remove (IRecord line)
 Create an update that will remove a line of data from the paged topic. More...
 
- Public Member Functions inherited from PushTechnology.ClientInterface.Client.Topics.Update.IPagedUpdateFactory
IUpdate RemoveAll ()
 Create an update which removes all lines from the paged topic. More...
 

Detailed Description

Update factory for ordered TopicType.PAGED_RECORD topics.

Instances of this factory can be obtained from the ITopicUpdateControl feature using ITopicUpdateControl.UpdateFactory{TF}, for example:

var updateControl = session.GetTopicUpdateControlFeature(); var factory = updateControl.UpdateFactory<IPagedRecordOrderedUpdateFactory>();

Deprecated since 5.9.

Member Function Documentation

IUpdate PushTechnology.ClientInterface.Client.Topics.Update.IPagedRecordOrderedUpdateFactory.Add ( IRecord  line)

Create an update that will add a line to the paged topic.

The line will be added at the position indicated by the IPagedRecordOrderingPolicy policy of the topic. Duplicates will be handled according to the PagedTopicDuplicates policy indicated for the topic.

Parameters
lineThe line to add.
Returns
A new update.
IUpdate PushTechnology.ClientInterface.Client.Topics.Update.IPagedRecordOrderedUpdateFactory.Remove ( IRecord  line)

Create an update that will remove a line of data from the paged topic.

The IPagedRecordOrderingPolicy policy is used to locate a line that matches the specified line and that line is then removed and all interested clients are notified. If no match is found then no action occurs. If there is more than one line that matches then the line removed would depend upon the PagedTopicDuplicates policy.

Only as much data as is needed to match a line according to its ordering policy is needed to locate a line for removal. For example, if the policy only orders on the first field of the record then that is the only field that will be used when locating the line to remove.

Parameters
lineThe line to remove.
Returns
A new update.
IUpdate PushTechnology.ClientInterface.Client.Topics.Update.IPagedRecordOrderedUpdateFactory.Update ( IRecord  line)

Create an update that will update a line within the paged topic.

An update will involve removing a line that matches the supplied line according to the IPagedRecordOrderingPolicy and then adding the new line. Each update will result in all interested clients being notified of the change.

Where there is more than one line that matches then the match would be made according to the PagedTopicDuplicates policy. If there is no line that matches the new line then the result would be the same as for a simple add.

Parameters
lineThe line of data to use for update.
Returns
A new update.

The documentation for this interface was generated from the following file: