Data.Cloud.AzureAPI.TAzureBlobService.GetBlob

• Aller au parent : 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 */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp	Data.Cloud.AzureAPI	TAzureBlobService

Description

Télécharge le blob donné, en écrivant son contenu dans le flux fourni.

GetBlob télécharge le blob donné, en écrivant son contenu dans le flux fourni.

Il existe 4 méthodes GetBlob surchargées.

La deuxième méthode surchargée renvoie également les propriétés et les métadonnées du blob.

En utilisant la troisième méthode surchargée, vous pouvez demander à ce qu'un intervalle du blob soit renvoyé en spécifiant des valeurs pour StartByte et EndByte. Si vous spécifiez un intervalle, vous pouvez également définir GetAsHash sur True, qui va renvoyer le hachage MD5 du contenu de l'intervalle, à la place du contenu lui-même. Notez que vous pouvez seulement renvoyer le hachage pour un intervalle, pas pour l'intégralité du contenu.

La quatrième méthode surchargée renvoie aussi les propriétés et les métadonnées du blob ; vous pouvez demander seulement un intervalle du blob en spécifiant des valeurs pour StartByte et EndByte, de façon analogue à la troisième méthode surchargée.

Le tableau suivant décrit les paramètres pour les quatre méthodes surchargées :

Paramètre	Description
ContainerName	Le nom du conteneur dans lequel se trouve le blob.
BlobName	Le nom du blob à télécharger.
BlobStream	Le flux dans lequel écrire le contenu du blob.
StartByte	L'index de l'octet de début.
EndByte	L'index de l'octet de fin, ou 0 si vous ne souhaitez pas obtenir un intervalle du blob.
GetAsHash	Si True ou si EndByte est supérieur à StartByte, la méthode renvoie le contenu en tant que hachage MD5.
Properties	Les paires nom/valeur des propriétés du blob.
Metadata	Les paires nom/valeur des métadonnées du blob.
LeaseId	L'ID du bail, requis si le blob est verrouillé.
ResponseInfo	La classe facultative dans laquelle stocker les informations sur la réponse.

La méthode renvoie True si l'opération a réussi, False dans le cas contraire.

Voir aussi

• System.Classes.TStream

• DeleteBlob

• GetBlobSnapshot