Data.Cloud.AzureAPI.TAzureBlobService.GetBlob
Delphi
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream; out Properties, Metadata: TStrings; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream; StartByte: int64; EndByte: int64; GetAsHash: Boolean = False; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream; out Properties, Metadata: TStrings; StartByte: int64; EndByte: int64; GetAsHash: Boolean = False; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(const AContainerName, ABlobName, ALeaseID: string; AStartByte, AEndByte: Int64; AGetAsHash: Boolean; out AProperties, AMetadata: TArray<TPair<string, string>>; ABlobStream: TStream; const AResponseInfo: TCloudResponseInfo): Boolean; overload;
C++
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, __int64 StartByte, __int64 EndByte, bool GetAsHash = false, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, __int64 StartByte, __int64 EndByte, bool GetAsHash = false, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseID, __int64 AStartByte, __int64 AEndByte, bool AGetAsHash, /* out */ System::DynamicArray<System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> > &AProperties, /* out */ System::DynamicArray<System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> > &AMetadata, System::Classes::TStream* ABlobStream, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
Description
Downloads the given blob, writing its content into the provided stream.
GetBlob downloads the given blob, writing its content into the provided stream.
There are 4 overloaded GetBlob methods.
The second overloaded method also returns the blob's properties and metadata.
Using the third overloaded method, you can request only a range of the blob to be returned by specifying values for StartByte
and EndByte
. If you specify a range, you can also set GetAsHash
to True, which will return the MD5 hash of the range's content, instead of the content itself. Note that you can only return the hash for a range, and not the full content.
The fourth overloaded method also returns the blob's properties and metadata; you can request only a range of the blob to be returned by specifying values for StartByte
and EndByte
, similarly to the third overloaded method.
The following table describes the parameters for all four overloaded methods:
Parameter | Description |
---|---|
|
The name of the container the blob is in. |
|
The name of the blob to download. |
|
The stream to write the blob content into. |
|
The starting byte index. |
|
The ending byte index, or 0 if you do not want a range of the blob. |
|
If True or if |
|
The blob's property name/value pairs. |
|
The blob's metadata name/value pairs. |
|
The lease ID, required if the blob is locked. |
|
The optional class for storing response info into. |
The method returns True if the task was successful, False otherwise.