TElAWSS3DataStorageObject.ReadBlock method

TElAWSS3DataStorageObject.ReadBlock

Reads block of data from the object in the storage.

Declaration

[C#]
    void ReadBlock(System.IO.Stream Strm, long Offset, long Size, ref long Read);
    void ReadBlock(System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBAWSS3ReadObjectCondition Condition, DateTime DateTime, string ETag);
    void ReadBlock(System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBAWSS3ReadObjectCondition Condition, DateTime DateTime, string ETag, TElStringList Metadata, ref string ObjContentType, ref string ObjContentDisposition, ref string ObjETag);
    void ReadBlock(System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBAWSS3ReadObjectCondition Condition, DateTime DateTime, string ETag, TElStringList Metadata, ref string ObjContentType, ref string ObjContentDisposition, ref string ObjContentEncoding, ref string ObjETag);

[VB.NET]
    Sub ReadBlock(ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long)
    Sub ReadBlock(ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long, ByVal Condition As TSBAWSS3ReadObjectCondition, ByVal DateTime As DateTime, ByVal ETag As String)
    Sub ReadBlock(ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long, ByVal Condition As TSBAWSS3ReadObjectCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal Metadata As TElStringList, ByRef ObjContentType As String, ByRef ObjContentDisposition As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long, ByVal Condition As TSBAWSS3ReadObjectCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal Metadata As TElStringList, ByRef ObjContentType As String, ByRef ObjContentDisposition As String, ByRef ObjContentEncoding As String, ByRef ObjETag As String)

[Pascal]
    procedure ReadBlock(Strm : System.IO.Stream; Offset, Size : Int64; var Read : Int64);
    procedure ReadBlock(Strm : System.IO.Stream; Offset, Size : Int64; var Read : Int64; Condition : TSBAWSS3ReadObjectCondition; DateTime : DateTime; const ETag : String);
    procedure ReadBlock(Strm : System.IO.Stream; Offset, Size : Int64; var Read : Int64; Condition : TSBAWSS3ReadObjectCondition; DateTime : DateTime; const ETag : String; Metadata : TElStringList; var ObjContentType : String; var ObjContentDisposition : String; var ObjETag : String);

[C++]
    void ReadBlock(TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read);
    void ReadBlock(TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBAWSS3ReadObjectCondition Condition, int64_t DateTime, const std::string &ETag);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBAWSS3ReadObjectCondition Condition, int64_t DateTime, const std::string &ETag);
    void ReadBlock(TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBAWSS3ReadObjectCondition Condition, int64_t DateTime, const std::string &ETag, TElStringList &Metadata, std::string &ObjContentType, std::string &ObjContentDisposition, std::string &ObjETag);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBAWSS3ReadObjectCondition Condition, int64_t DateTime, const std::string &ETag, TElStringList *Metadata, std::string &ObjContentType, std::string &ObjContentDisposition, std::string &ObjETag);
    void ReadBlock(TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBAWSS3ReadObjectCondition Condition, int64_t DateTime, const std::string &ETag, TElStringList &Metadata, std::string &ObjContentType, std::string &ObjContentDisposition, std::string &ObjContentEncoding, std::string &ObjETag);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBAWSS3ReadObjectCondition Condition, int64_t DateTime, const std::string &ETag, TElStringList *Metadata, std::string &ObjContentType, std::string &ObjContentDisposition, std::string &ObjContentEncoding, std::string &ObjETag);

[PHP]
    void ReadBlock(TStream $Strm, integer $Offset, integer $Size, integer &$Read)
    void ReadBlock(TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag)
    void ReadBlock(TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, TElStringList $Metadata, string &$ObjContentType, string &$ObjContentDisposition, string &$ObjETag)
    void ReadBlock(TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, TElStringList $Metadata, string &$ObjContentType, string &$ObjContentDisposition, string &$ObjContentEncoding, string &$ObjETag)

[Java]
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read, TSBAWSS3ReadObjectCondition Condition, Date DateTime, String ETag, TElStringList Metadata, TSBString ObjContentType, TSBString ObjContentDisposition, TSBString ObjETag);
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read, TSBAWSS3ReadObjectCondition Condition, Date DateTime, String ETag);
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read);
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read, TSBAWSS3ReadObjectCondition Condition, Date DateTime, String ETag, TElStringList Metadata, TSBString ObjContentType, TSBString ObjContentDisposition, TSBString ObjContentEncoding, TSBString ObjETag);

Parameters

Strm - stream where the data will be read to
Offset - offset of the data block
Size - size the data block
Read - number of bytes that were actually read
Condition - condition under which the object will be retrieved
DateTime - object's modification date and time
ETag - object's entity tag
Metadata - contains metadata of the object
ObjContentType - contains content type of the object that has been read
ObjContentDisposition - contains content disposition of the object that has been read
ObjETag - contains entity tag of the object that has been read
ObjContentEncoding - ...

Values

[.NET] [C++]	[Pascal]	Description
awsrNone = 0	awsrNone	Object will always be read
awsrIfModifiedSince = 1	awsrIfModifiedSince	Object will be read only if it has been modified since modification time passed to the Read function
awsrIfUnmodifiedSince = 2	awsrIfUnmodifiedSince	Object will be read only if it has not been modified since modification time passed to the Read function
awsrIfMatch = 3	awsrIfMatch	Object will be read only if its ETag matches the value passed to the Read function
awsrIfNoneMatch = 4	awsrIfNoneMatch	Object will be read only if its ETag does not match the value passed to the Read function

Description

Use this method to read a block of data from the object in the storage.