Get Method

SharedData Get Method

C# API

Reads the value associated with the specified key in the Shared Data Server.

Namespace: Facilita.Fc.Runtime
Assembly: fc_clr (in fc_clr.dll) Version: 9.5.7.98

Syntax

public string Get(
	string key,
	int timeout
)

public string Get(
	string key,
	int timeout
)

Parameters

key: Type: System String
The key against which the data is stored.

timeout: Type: System Int32
The maximum time in milliseconds to wait for a value to become available.

Return Value

Value for key that was created by a previous call to Set(String, String).

Exceptions

Exception	Condition
Facilita.Exception NoSuchValueException	The request has timed out.

Remarks

Set the timeout parameter to 0 (zero) to prevent blocking. Use -1 to wait forever. If no list of values exists for key, then the Virtual User thread will be suspended and the call will only return (dependent upon timeout) when a value is read from the Shared Data server. If the connection to the Shared Data Server is lost an exception is raised.

Values can be set by calling Set(String, String).

Note
The keys are case-sensitive.

Examples

The following example demonstrates reading a value from the Shared Data Server.

C++

Copy to Clipboard Print

using Facilita.Fc.Runtime;
SharedData sharedData = new SharedData(GetString("sharedDataHost", "localhost"), GetInt("sharedDataPort", 5099));
string value = sharedData.Get("CurrServer", 0);

using Facilita.Fc.Runtime;
SharedData sharedData = new SharedData(GetString("sharedDataHost", "localhost"), GetInt("sharedDataPort", 5099));
string value = sharedData.Get("CurrServer", 0);