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;
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream;  out Properties, Metadata: TStrings; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload;
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream;  StartByte: int64; EndByte: int64; GetAsHash: Boolean = False; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload;
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;

C++

bool __fastcall GetBlob(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(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(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(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 */;

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 quatre 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.

Par l'utilisation de la troisième méthode surchargée, vous pouvez demander seulement le renvoi d'un intervalle du blob 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 renvoyer seulement le hachage pour un intervalle mais pas pour le contenu intégral.

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 d'octet de début.
EndByte	L'index d'octet de fin, ou 0 si vous ne souhaitez pas un intervalle du blob.
GetAsHash	Si True, ou si EndByte est supérieure à 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 optionnelle dans laquelle stocker les informations de la réponse.

La méthode renvoie True si l'opération a réussi, et False sinon.

Voir aussi

• DeleteBlob

• GetBlobSnapshot