ITableOperationsQueryRecordAsync(RecordRestriction, CancellationToken) Method

Queries database and returns a single modeled table record for the specified restriction.

Definition

Namespace: Gemstone.Data.Model
Assembly: Gemstone.Data (in Gemstone.Data.dll) Version: 1.0.167 -- Release Build+a63d2f336930b0b8a2e0d51bc652b0af46e5d00a
ValueTask<Object> QueryRecordAsync(
	RecordRestriction? restriction,
	CancellationToken cancellationToken
)

Parameters

restriction  RecordRestriction
Record restriction to apply.
cancellationToken  CancellationToken
Propagates notification that operations should be canceled.

Return Value

ValueTaskObject
A single modeled table record for the queried record.

Remarks

If no record is found for specified restriction, null will be returned.

This is a convenience call to QueryRecords(String, RecordRestriction, Int32) specifying the RecordRestriction parameter with a limit of 1 record.

If any of the restriction parameters reference a table field that is modeled with either an EncryptDataAttribute or FieldDataTypeAttribute, then the function GetInterpretedFieldValue(String, Object) will need to be called, replacing the target parameter with the returned value so that the field value will be properly set prior to executing the database function.

See Also