Container for the parameters to the ListObjects operation.
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.
Inheritance Hierarchy
Namespace: Amazon.S3.Model
Assembly: AWSSDK.dll
Version: 2.0.0.3
Syntax
public class ListObjectsRequest : AmazonWebServiceRequest IRequestEvents
The ListObjectsRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
ListObjectsRequest() |
Properties
| Name | Description | |
|---|---|---|
|
|
BucketName | The name of the bucket containing the objects whose keys are to be listed. |
|
|
Delimiter | A delimiter is a character you use to group keys. |
|
|
Marker | Specifies the key to start with when listing objects in a bucket. |
|
|
MaxKeys | Sets the maximum number of keys returned in the response. The response might contain fewer keys but will never contain more. |
|
|
Prefix | Limits the response to keys that begin with the specified prefix. |
Examples
This example shows how to list all objects in a bucket.
ListObjects sample
// Create a client
AmazonS3Client client = new AmazonS3Client();
// List all objects
ListObjectsRequest listRequest = new ListObjectsRequest
{
BucketName = "SampleBucket",
};
ListObjectsResponse listResponse;
do
{
// Get a list of objects
listResponse = client.ListObjects(listRequest);
foreach (S3Object obj in listResponse.S3Objects)
{
Console.WriteLine("Object - " + obj.Key);
Console.WriteLine(" Size - " + obj.Size);
Console.WriteLine(" LastModified - " + obj.LastModified);
Console.WriteLine(" Storage class - " + obj.StorageClass);
}
// Set the marker property
listRequest.Marker = listResponse.NextMarker;
} while (listResponse.IsTruncated);
Version Information
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8
.NET for Windows Phone:
Supported in: Window Phone 8
