Data.Cloud.AzureAPI.TAzureBlobService.GetBlob

• 親: TAzureBlobService

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 */;

プロパティ

種類	可視性	ソース	ユニット	親
function	public	Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp	Data.Cloud.AzureAPI	TAzureBlobService

説明

指定された blob をダウンロードし、そのコンテンツを提供されたストリームに書き込みます。

GetBlob は、指定された blob をダウンロードし、そのコンテンツを提供されたストリームに書き込みます。

4 つのオーバーロード GetBlob メソッドがあります。

第 2 オーバーロード メソッドはまた、blob のプロパティとメタデータを返します。

第 3 オーバーロード メソッドを使用する場合、blob の範囲を限定して要求することができ、それには、StartByte と EndByte に対して値を指定することで返されます。 また範囲を指定する場合、GetAsHash を True に設定すると、コンテンツそのものが返される代わりに、その範囲のコンテンツの MD5 ハッシュが返されます。 返すことができるのはある範囲に対するハッシュのみで、すべてのコンテンツに対してはできない点に注意してください。

第 4 オーバーロード メソッドはまた、blob のプロパティとメタデータを返します。 第 3 オーバーロード メソッドと同様、blob の範囲を限定して要求することができ、それには、StartByte と EndByte に対して値を指定することで返されます。

次の表では、4 つのすべてのオーバーロード メソッドのパラメータを説明しています：

パラメータ	説明
ContainerName	blob があるコンテナの名前。
BlobName	ダウンロードする blob の名前。
BlobStream	blob のコンテンツを書き込むストリーム。
StartByte	開始バイト インデックス。
EndByte	終了バイト インデックス、または 0（ blob の範囲を限定したくない場合）。
GetAsHash	True または EndByte が StartByte より大きい場合、メソッドはコンテンツを MD5 ハッシュとして返します。
Properties	blob のプロパティの名前/値ペア。
Metadata	blob のメタデータの名前/値ペア。
LeaseId	リース ID、blob がロックされている場合には必須。
ResponseInfo	レスポンス情報を格納する任意のクラス。

メソッドは、タスクが成功した場合に True を、そうでなければ False を返します。

関連項目

• System.Classes.TStream

• DeleteBlob

• GetBlobSnapshot