AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

The Select operation returns a set of attributes for ItemNames that match the select expression. Select is similar to the standard SQL SELECT statement.

The total size of the response cannot exceed 1 MB in total size. Amazon SimpleDB automatically adjusts the number of items returned per page to enforce this limit. For example, if the client asks to retrieve 2500 items, but each individual item is 10 kB in size, the system returns 100 items and an appropriate NextToken so the client can access the next page of results.

For information on how to construct select expressions, see Using Select to Create Amazon SimpleDB Queries in the Developer Guide.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginSelect and EndSelect.

Namespace: Amazon.SimpleDB
Assembly: AWSSDK.SimpleDB.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<SelectResponse> SelectAsync(
         SelectRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.SimpleDB.Model.SelectRequest

Container for the necessary parameters to execute the Select service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the Select service method, as returned by SimpleDB.

Exceptions

ExceptionCondition
InvalidNextTokenException The specified NextToken is not valid.
InvalidNumberPredicatesException Too many predicates exist in the query expression.
InvalidNumberValueTestsException Too many predicates exist in the query expression.
InvalidParameterValueException The value for a parameter is invalid.
InvalidQueryExpressionException The specified query expression syntax is not valid.
MissingParameterException The request must contain the specified missing parameter.
NoSuchDomainException The specified domain does not exist.
RequestTimeoutException A timeout occurred when attempting to query the specified domain with specified query expression.
TooManyRequestedAttributesException Too many attributes requested.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also