TElWinAzureDataStorageObject.ReadBlock method

TElWinAzureDataStorageObject.ReadBlock

Reads a block of data from 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, TSBWinAzureObjectAccessCondition Condition, DateTime DateTime, string ETag, long SeqNum);
    void ReadBlock(System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBWinAzureObjectAccessCondition Condition, DateTime DateTime, string ETag, long SeqNum, TElStringList Metadata, ref string ObjContentType, ref string ObjContentEncoding, ref string ObjContentLanguage, ref string ObjETag);
    void ReadBlock(System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBWinAzureObjectAccessCondition Condition, DateTime DateTime, string ETag, long SeqNum, TElStringList Metadata, ref string ObjContentType, ref string ObjContentEncoding, ref string ObjContentLanguage, ref string ObjContentMD5, ref string ObjETag);
    void ReadBlock(string SharedAccessSignature, System.IO.Stream Strm, long Offset, long Size, ref long Read);
    void ReadBlock(string SharedAccessSignature, System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBWinAzureObjectAccessCondition Condition, DateTime DateTime, string ETag, long SeqNum);
    void ReadBlock(string SharedAccessSignature, System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBWinAzureObjectAccessCondition Condition, DateTime DateTime, string ETag, long SeqNum, TElStringList Metadata, ref string ObjContentType, ref string ObjContentEncoding, ref string ObjContentLanguage, ref string ObjETag);
    void ReadBlock(string SharedAccessSignature, System.IO.Stream Strm, long Offset, long Size, ref long Read, TSBWinAzureObjectAccessCondition Condition, DateTime DateTime, string ETag, long SeqNum, TElStringList Metadata, ref string ObjContentType, ref string ObjContentEncoding, ref string ObjContentLanguage, ref string ObjContentMD5, 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 TSBWinAzureObjectAccessCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal SeqNum 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 TSBWinAzureObjectAccessCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal SeqNum As Long, ByVal Metadata As TElStringList, ByRef ObjContentType As String, ByRef ObjContentEncoding As String, ByRef ObjContentLanguage 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 TSBWinAzureObjectAccessCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal SeqNum As Long, ByVal Metadata As TElStringList, ByRef ObjContentType As String, ByRef ObjContentEncoding As String, ByRef ObjContentLanguage As String, ByRef ObjContentMD5 As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal SharedAccessSignature As String, ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long)
    Sub ReadBlock(ByVal SharedAccessSignature As String, ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long, ByVal Condition As TSBWinAzureObjectAccessCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal SeqNum As Long)
    Sub ReadBlock(ByVal SharedAccessSignature As String, ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long, ByVal Condition As TSBWinAzureObjectAccessCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal SeqNum As Long, ByVal Metadata As TElStringList, ByRef ObjContentType As String, ByRef ObjContentEncoding As String, ByRef ObjContentLanguage As String, ByRef ObjETag As String)
    Sub ReadBlock(ByVal SharedAccessSignature As String, ByVal Strm As System.IO.Stream, ByVal Offset As Long, ByVal Size As Long, ByRef Read As Long, ByVal Condition As TSBWinAzureObjectAccessCondition, ByVal DateTime As DateTime, ByVal ETag As String, ByVal SeqNum As Long, ByVal Metadata As TElStringList, ByRef ObjContentType As String, ByRef ObjContentEncoding As String, ByRef ObjContentLanguage As String, ByRef ObjContentMD5 As String, ByRef ObjETag As String)

[Pascal]
    procedure ReadBlock(Strm : TStream; Offset, Size : Int64; var Read : Int64);
    procedure ReadBlock(Strm : TStream; Offset, Size : Int64; var Read : Int64; Condition : TSBWinAzureObjectAccessCondition; DateTime : TDateTime; const ETag : string; SeqNum : Int64);
    procedure ReadBlock(Strm : TStream; Offset, Size : Int64; var Read : Int64; Condition : TSBWinAzureObjectAccessCondition; DateTime : TDateTime; const ETag : string; SeqNum : Int64; Metadata : TStringList; var ObjContentType : string; var ObjContentEncoding : string; var ObjContentLanguage : string; var ObjETag : string);
    procedure ReadBlock(Strm : TStream; Offset, Size : int64; var Read : int64; Condition : TSBWinAzureObjectAccessCondition; DateTime : TDateTime; const ETag : string; SeqNum : int64; Metadata : TStringList; var ObjContentType : string; var ObjContentEncoding : string; var ObjContentLanguage : string; var ObjContentMD5 : string; var ObjETag : string);
    procedure ReadBlock(const SharedAccessSignature : string; Strm : TStream; Offset, Size : int64; var Read : int64);
    procedure ReadBlock(const SharedAccessSignature : string; Strm : TStream; Offset, Size : int64; var Read : int64; Condition : TSBWinAzureObjectAccessCondition; DateTime : TDateTime; const ETag : string; SeqNum : int64);
    procedure ReadBlock(const SharedAccessSignature : string; Strm : TStream; Offset, Size : int64; var Read : int64; Condition : TSBWinAzureObjectAccessCondition; DateTime : TDateTime; const ETag : string; SeqNum : int64; Metadata : TStringList; var ObjContentType : string; var ObjContentEncoding : string; var ObjContentLanguage : string; var ObjETag : string);
    procedure ReadBlock(const SharedAccessSignature : string; Strm : TStream; Offset, Size : int64; var Read : int64; Condition : TSBWinAzureObjectAccessCondition; DateTime : TDateTime; const ETag : string; SeqNum : int64; Metadata : TStringList; var ObjContentType : string; var ObjContentEncoding : string; var ObjContentLanguage : string; var ObjContentMD5 : 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, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum);
    void ReadBlock(TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList &Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjETag);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList *Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjETag);
    void ReadBlock(TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList &Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjContentMD5, std::string &ObjETag);
    void ReadBlock(TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList *Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjContentMD5, std::string &ObjETag);
    void ReadBlock(const std::string &SharedAccessSignature, TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read);
    void ReadBlock(const std::string &SharedAccessSignature, TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read);
    void ReadBlock(const std::string &SharedAccessSignature, TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum);
    void ReadBlock(const std::string &SharedAccessSignature, TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum);
    void ReadBlock(const std::string &SharedAccessSignature, TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList &Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjETag);
    void ReadBlock(const std::string &SharedAccessSignature, TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList *Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjETag);
    void ReadBlock(const std::string &SharedAccessSignature, TStream &Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList &Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjContentMD5, std::string &ObjETag);
    void ReadBlock(const std::string &SharedAccessSignature, TStream *Strm, int64_t Offset, int64_t Size, int64_t &Read, TSBWinAzureObjectAccessCondition Condition, int64_t DateTime, const std::string &ETag, int64_t SeqNum, TElStringList *Metadata, std::string &ObjContentType, std::string &ObjContentEncoding, std::string &ObjContentLanguage, std::string &ObjContentMD5, 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, integer $SeqNum)
    void ReadBlock(TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, integer $SeqNum, TElStringList $Metadata, string &$ObjContentType, string &$ObjContentEncoding, string &$ObjContentLanguage, string &$ObjETag)
    void ReadBlock(TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, integer $SeqNum, TElStringList $Metadata, string &$ObjContentType, string &$ObjContentEncoding, string &$ObjContentLanguage, string &$ObjContentMD5, string &$ObjETag)
    void ReadBlock(string $SharedAccessSignature, TStream $Strm, integer $Offset, integer $Size, integer &$Read)
    void ReadBlock(string $SharedAccessSignature, TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, integer $SeqNum)
    void ReadBlock(string $SharedAccessSignature, TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, integer $SeqNum, TElStringList $Metadata, string &$ObjContentType, string &$ObjContentEncoding, string &$ObjContentLanguage, string &$ObjETag)
    void ReadBlock(string $SharedAccessSignature, TStream $Strm, integer $Offset, integer $Size, integer &$Read, integer $Condition, DateTime $DateTime, string $ETag, integer $SeqNum, TElStringList $Metadata, string &$ObjContentType, string &$ObjContentEncoding, string &$ObjContentLanguage, string &$ObjContentMD5, string &$ObjETag)

[Java]
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read);
    void readBlock(String SharedAccessSignature, TElStream Strm, long Offset, long Size, TSBLong Read, TSBWinAzureObjectAccessCondition Condition, Date DateTime, String ETag, long SeqNum, TElStringList Metadata, TSBString ObjContentType, TSBString ObjContentEncoding, TSBString ObjContentLanguage, TSBString ObjContentMD5, TSBString ObjETag);
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read, TSBWinAzureObjectAccessCondition Condition, Date DateTime, String ETag, long SeqNum);
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read, TSBWinAzureObjectAccessCondition Condition, Date DateTime, String ETag, long SeqNum, TElStringList Metadata, TSBString ObjContentType, TSBString ObjContentEncoding, TSBString ObjContentLanguage, TSBString ObjContentMD5, TSBString ObjETag);
    void readBlock(String SharedAccessSignature, TElStream Strm, long Offset, long Size, TSBLong Read);
    void readBlock(TElStream Strm, long Offset, long Size, TSBLong Read, TSBWinAzureObjectAccessCondition Condition, Date DateTime, String ETag, long SeqNum, TElStringList Metadata, TSBString ObjContentType, TSBString ObjContentEncoding, TSBString ObjContentLanguage, TSBString ObjETag);
    void readBlock(String SharedAccessSignature, TElStream Strm, long Offset, long Size, TSBLong Read, TSBWinAzureObjectAccessCondition Condition, Date DateTime, String ETag, long SeqNum);
    void readBlock(String SharedAccessSignature, TElStream Strm, long Offset, long Size, TSBLong Read, TSBWinAzureObjectAccessCondition Condition, Date DateTime, String ETag, long SeqNum, TElStringList Metadata, TSBString ObjContentType, TSBString ObjContentEncoding, TSBString ObjContentLanguage, TSBString ObjETag);

Parameters

Condition - condition under which the object will be read.
DateTime - object's modification date and time.
ETag - object's entity tag.
Metadata - contains object's metadata.
ObjContentEncoding - specifies content encoding of the object that has been read.
ObjContentLanguage - specifies content language of the object that has been read.
ObjContentMD5 - MD5 hash of the content of the object that has been read.
ObjContentType - specifies content type of the object that has been read.
ObjETag - contains entity tag of the object that has been read.
Offset - offset of the data block.
Read - number of bytes that were actually read.
SeqNum - object's sequence number.
SharedAccessSignature - contains the Shared Access Signature (SAS).
Size - size the data block.
Strm - the stream where the object will be stored.

Values

[.NET] [C++]	[Pascal]	Description
msoaNone = 0	msoaNone	Object will always be accessed
msoaIfModifiedSince = 1	msoaIfModifiedSince	Object will be accessed only if it has been modified since modification time passed to the Read function
msoaIfUnmodifiedSince = 2	msoaIfUnmodifiedSince	Object will be accessed only if it has not been modified since modification time passed to the Read function
msoaIfMatch = 3	msoaIfMatch	Object will be accessed only if its ETag matches the value passed to the Read function
msoaIfNoneMatch = 4	msoaIfNoneMatch	Object will be accessed only if its ETag does not match the value passed to the Read function
msoaIfSequenceNumberIsLessThanOrEqual = 5	msoaIfSequenceNumberIsLessThanOrEqual	Object will be accessed only if its sequence number is less than or equal to the value passed to the Read function
msoaIfSequenceNumberIsLess = 6	msoaIfSequenceNumberIsLess	Object will be accessed only if its sequence number is less than the value passed to the Read function
msoaIfSequenceNumberIsEqual = 7	msoaIfSequenceNumberIsEqual	Object will be accessed only if its sequence number is equal to the value passed to the Read function

Description

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