ITableOperationsQueryRecordsAsync(String, RecordRestriction, Int32, CancellationToken) Method

Queries database and returns modeled table records for the specified parameters.

Definition

Namespace: Gemstone.Data.Model
Assembly: Gemstone.Data (in Gemstone.Data.dll) Version: 1.0.138 -- Release Build+f7ceb3e02ea3c92b27e86b99ae16cee337a20b9e
IAsyncEnumerable<Object?> QueryRecordsAsync(
	string? orderByExpression = null,
	RecordRestriction? restriction = null,
	int limit = -1,
	CancellationToken cancellationToken = default
)

Parameters

orderByExpression  String  (Optional)
Field name expression used for sort order, include ASC or DESC as needed - does not include ORDER BY; defaults to primary keys.
restriction  RecordRestriction  (Optional)
Record restriction to apply, if any.
limit  Int32  (Optional)
Limit of number of record to return.
cancellationToken  CancellationToken  (Optional)
Propagates notification that operations should be canceled.

Return Value

IAsyncEnumerableObject
An enumerable of modeled table row instances for queried records.

Remarks

If no record restriction or limit is provided, all rows will be returned.

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