DOFObjectSubscribeOperationListenerpropertyChanged Method OpenDOF Object Access Library

Note: This API is now obsolete.

Process a result.

Namespace: org.opendof.core.oal
Assembly: dof-oal (in dof-oal.dll) Version: 7.0.1.2
Syntax
C#
Copy
[ObsoleteAttribute("Replaced by Listener.propertyChanged(DOFSubscription, DOFObjectID, DOFValue)")]
void propertyChanged(
	DOFOperationSubscribe operation,
	DOFProviderInfo providerInfo,
	DOFValue value,
	DOFException exception
)

Parameters

operation
Type: org.opendof.core.oalDOFOperationSubscribe
Information about the subscribe operation. This will never be null.
providerInfo
Type: org.opendof.core.oalDOFProviderInfo
Information about the provider of the property. This will never be null.
value
Type: org.opendof.core.oalDOFValue
The property's new value, if any. May be null if
Copy
exception
is not null or for null return values.
exception
Type: org.opendof.core.oalDOFException
An exception received from the Provider, if any. May be null.
Remarks
Process a result. This method is called when a subscribed-to property's value has changed.

NOTE: If the primary provider changes during the lifetime of the operation, and the Control response level includes exceptions, then this method will be passed a DOFErrorException.TERMINATED exception. In order to start processing the property changes from the new source, you may:

  • Cancel and reestablish the subscription with DOFObject.beginSubscribe(Property, int, int, SubscribeOperationListener, object) .
  • Wait for the operation retry to automatically switch over to the new provider.
  • Or, if you expect this to occur, before calling DOFObject.beginSubscribe(Property, int, int, SubscribeOperationListener, object) , you may set a shorter retry period for the operation with Control.setRetryPeriod(int) or Control.setRetryTime(RetryTime) .
See Also

Reference

DOFObjectSubscribeOperationListener Interface
org.opendof.core.oal Namespace