Sends a tuple to an existing StreamBase application. If responseOutputStreamName and expectedResponseSchema are BOTH non-null, it will wait for a corresponding tuple to be output from the outputStream. Note that the app must be written such that BOTH the inputStream and the OutputStream must have a String field named "__SendTupleResponseKey" or it will give an error. This field will be set by the server when sending the tuple, and the response will be checked to make sure it has the same value. (This is to prevent one client from getting a response that was intended for a different client). If the client has not included the responseOutputStreamName, then the field is not required.

Namespace: StreamBase.LiveView.API
Assembly: StreamBase.LiveView.API (in StreamBase.LiveView.API.dll) Version: 2.2.8.5956 (2.2.8.5956)

Syntax

         
 C#  Visual Basic  Visual C++ 
Tuple SendTupleAction(
	StreamBaseURI sbURI,
	string targetInputStreamName,
	Tuple tuple,
	string responseOutputStreamName,
	Schema expectedResponseSchema,
	TimeSpan timeout
)
Function SendTupleAction ( _
	sbURI As StreamBaseURI, _
	targetInputStreamName As String, _
	tuple As Tuple, _
	responseOutputStreamName As String, _
	expectedResponseSchema As Schema, _
	timeout As TimeSpan _
) As Tuple
Tuple^ SendTupleAction(
	StreamBaseURI^ sbURI, 
	String^ targetInputStreamName, 
	Tuple^ tuple, 
	String^ responseOutputStreamName, 
	Schema^ expectedResponseSchema, 
	TimeSpan timeout
)

Parameters

sbURI
StreamBaseURI
(Optional) The URI of the StreamBase server. The LV server's current SB server will be used if null.
targetInputStreamName
String
The pathname of the input stream to which to send the tuple.
tuple
Tuple
The tuple to send.
responseOutputStreamName
String
(Optional) The pathname of the OutputStream on which to listen for a response.
expectedResponseSchema
Schema
(Optional) The schema that the response is expected to have, likely retrieved via GetSendTupleInfo(StreamBaseURI, String, String).
timeout
TimeSpan
Maximum time to wait for response. Valid range is 50 - 120000 MILLISECONDS.

Return Value

The response tuple if responseOutputStreamName and expectedResponseSchema are both non-null, or null otherwise.

See Also