This method is provides the Developer with a simple means of controlling data flow between client and server without fully implementing their own MarkupImageDataProvider. This method can be overridden in a derivation of either of the 2 provided MarkupImageDataProvider implementations (File and Sql) to retain all of the functionality of that MarkupImageDataProvider while giving the Developer the opportunity to intercept, reject, process, and alter the Markup Layer returned by any request.
If markupLayer is set to null or this method throws an exception, no Markup Layer will be returned to the client.
Syntax
'Declaration
Public Overridable Sub OnRead( _
ByRef As ImGearARTDocumentXML, _
ByVal As String, _
ByVal As String, _
ByVal As NameValueCollection _
)
'Usage
Dim instance As MarkupArtMiddleware
Dim markupLayer As ImGearARTDocumentXML
Dim documentIdentifier As String
Dim markupLayerRecordId As String
Dim documentContextData As NameValueCollection
instance.OnRead(markupLayer, documentIdentifier, markupLayerRecordId, documentContextData)
public virtual void OnRead(
ref ImGearARTDocumentXML ,
string ,
string ,
NameValueCollection
)
public: virtual void OnRead(
ref ImGearARTDocumentXML* ,
string* ,
string* ,
NameValueCollection*
)
public:
virtual void OnRead(
ImGearARTDocumentXML^% ,
String^ ,
String^ ,
NameValueCollection^
)
Parameters
- markupLayer
- A reference to the Markup Layer being returned to the client viewer. This Markup Layer may be altered
in any manner deemed necessary, or set to null in which case no Markup Layer will be returned to the client.
- documentIdentifier
- The Document Identifier of the Markup Layer being read
- markupLayerRecordId
- The Markup Layer Record ID of the Markup Layer being read
- documentContextData
- The context data with which the MarkupArtDocumentDataConnection was created
See Also