Data.Cloud.AzureAPI.TAzureBlobService.GetBlob

De RAD Studio API Documentation
Aller à : navigation, rechercher

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