Container for the parameters to the GetObject operation.
Retrieves objects from Amazon S3.
Inheritance Hierarchy
Namespace: Amazon.S3.Model
Assembly: AWSSDK.dll
Version: 2.0.0.3
Syntax
public class GetObjectRequest : AmazonWebServiceRequest IRequestEvents
The GetObjectRequest type exposes the following members
Constructors
Name | Description | |
---|---|---|
![]() |
GetObjectRequest() |
Properties
Name | Description | |
---|---|---|
![]() |
BucketName | The name of the bucket containing the object. |
![]() |
ByteRange | Downloads the specified range bytes of an object. |
![]() |
EtagToMatch | ETag to be matched as a pre-condition for returning the object, otherwise a PreconditionFailed signal is returned. |
![]() |
EtagToNotMatch | ETag that should not be matched as a pre-condition for returning the object, otherwise a PreconditionFailed signal is returned. |
![]() |
Key | |
![]() |
ModifiedSinceDate | Returns the object only if it has been modified since the specified time, otherwise returns a PreconditionFailed. |
![]() |
ResponseExpires | Sets the Expires header of the response. |
![]() |
ResponseHeaderOverrides | A set of response headers that should be returned with the object. |
![]() |
UnmodifiedSinceDate | Returns the object only if it has not been modified since the specified time, otherwise returns a PreconditionFailed. |
![]() |
VersionId | VersionId used to reference a specific version of the object. |
Examples
This example shows how to get an object.
GetObject sample
// Create a client AmazonS3Client client = new AmazonS3Client(); // Create a GetObject request GetObjectRequest request = new GetObjectRequest { BucketName = "SampleBucket", Key = "Item1" }; // Issue request and remember to dispose of the response using (GetObjectResponse response = client.GetObject(request)) { using (StreamReader reader = new StreamReader(response.ResponseStream)) { string contents = reader.ReadToEnd(); Console.WriteLine("Object - " + response.Key); Console.WriteLine(" Version Id - " + response.VersionId); Console.WriteLine(" Contents - " + contents); } }
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