Starts watching the specified attributeNames for this Interaction. (See InteractionAttributeName.)

Namespace: ININ.IceLib.Interactions
Assembly: ININ.IceLib.Interactions (in ININ.IceLib.Interactions.dll) Version: 0.0.0.0 (22.3.0.218)

Syntax

C#
public void StartWatching(
	string[] attributeNames
)
Visual Basic
Public Sub StartWatching ( _
	attributeNames As String() _
)

Parameters

attributeNames
Type: array<System..::..String>[]()[][]
The attribute names.

Remarks

Applications cannot call StartWatching(array<String>[]()[][]) on the interactions that this object caches. A new instance of interaction object needs to be constructed in order to watch. However, actions such as Join()()()(), Listen(Boolean, Boolean) can be performed on this instance of interaction. A new instance need not be created. This instance of the interaction object is not based off InteractionQueue.

Note
All event handlers should be added before calling StartWatching(array<String>[]()[][]) or StartWatchingAsync(array<String>[]()[][], AsyncCompletedEventHandler, Object).
Note
Strings for attributeNames are defined in InteractionAttributeName however custom strings may also be used for custom handlers.
Note
For more information on watches see How Watches Work.

Exceptions

ExceptionCondition
System..::..ArgumentNullExceptionA parameter is nullNothingnullptra null reference (Nothing in Visual Basic).
System..::..InvalidOperationExceptionA watch is already in progress.
System..::..ArgumentExceptionThe parameter array is empty.
ININ.IceLib.Connection..::..RequestTimeoutExceptionThe request timed out while waiting for a response.
ININ.IceLib.Connection..::..SessionDisconnectedExceptionThe Session does not have a valid connection.
System..::..ObjectDisposedExceptionThe Session has been disposed.

Version Information

Supported for IC Server version 2015 R1 and beyond.
For 4.0, supported for IC Server version 4.0 GA and beyond.
For 3.0, supported for IC Server version 3.0 SU 6 and beyond.

See Also