Data.Cloud.AzureAPI.TAzureBlobService.GetBlobSnapshot

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;
ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;
out Properties, Metadata: TStrings;
ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;
StartByte: int64 = 0; EndByte: int64 = 0;
GetAsHash: Boolean = False;
ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;
out Properties, Metadata: TStrings;
StartByte: int64 = 0; EndByte: int64 = 0;
GetAsHash: Boolean = False;
ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(const AContainerName, ABlobName, ASnapshot, ALeaseId: string; AStartByte, AEndByte: Int64;
AGetAsHash: Boolean; out AProperties, AMetadata: TArray<TPair<string, string>>; out ASnapshotStream: TStream;
const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, __int64 StartByte = 0LL, __int64 EndByte = 0LL, bool GetAsHash = false, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, __int64 StartByte = 0LL, __int64 EndByte = 0LL, bool GetAsHash = false, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ASnapshot, 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, /* out */ System::Classes::TStream* &ASnapshotStream, 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 l'instantané donné, en écrivant son contenu dans le flux fourni.

GetBlobSnapshot télécharge l'instantané donné, en écrivant son contenu dans le flux fourni.

Il existe 4 méthodes GetBlobSnapshot.

La deuxième méthode surchargée renvoie également les propriétés et les métadonnées de l'instantané.

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 de l'instantané ; 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 auquel est destiné l'instantané.

Snapshot

L'instantané à obtenir.

SnapshotStream

Le flux dans lequel écrire le contenu de l'instantané.

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 de l'instantané.

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