Website Download Support
 

Discuss this help topic in SecureBlackbox Forum

TElAWSS3DataStorage.ReadBlock

TElAWSS3DataStorage     See also     

Filter: C#  VB.NET  Pascal  C++  PHP  Java  

Reads block of data from the object in the storage.

Declaration

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

[VB.NET]
    Sub ReadBlock(ByVal BucketName As String, ByVal Key As String, ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long)
    Sub ReadBlock(ByVal BucketName As String, ByVal Key As String, 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 Obj As TElAWSS3DataStorageObject, 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 BucketName As String, ByVal Key As String, 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, ByVal Headers As TElStringList, ByRef ObjContentType As String, ByRef ObjContentDisposition As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal BucketName As String, ByVal Key As String, 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, ByVal Headers As TElStringList, ByRef ObjContentType As String, ByRef ObjContentDisposition As String, ByRef ObjContentEncoding As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal Obj As TElAWSS3DataStorageObject, 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, ByVal Headers As TElStringList, ByRef ObjContentType As String, ByRef ObjContentDisposition As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal Obj As TElAWSS3DataStorageObject, 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, ByVal Headers As TElStringList, ByRef ObjContentType As String, ByRef ObjContentDisposition As String, ByRef ObjContentEncoding As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal Obj As TElCustomDataStorageObject, ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long)

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

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

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

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

Parameters

  • BucketName - name of the bucket with object
  • Key - a unique identifier of the object within a bucket
  • Obj - data object
  • 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
  • Headers - contains HTTP headers
  • 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.

See also:     ReadObject    

Discuss this help topic in SecureBlackbox Forum

Copyright (c) 2018, /n software, inc.