Data.Cloud.AzureAPI.TAzureBlobService.PutBlock

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function PutBlock(ContainerName, BlobName: string; const BlockId: string; Content: TArray<Byte>;
const ContentMD5: string = ''; const LeaseId: string = '';
ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutBlock(const AContainerName, ABlobName, ALeaseId, ABlockId: string; AContent: TArray<Byte>;
const AContentMD5: string; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall PutBlock _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, const System::UnicodeString BlockId, System::DynamicArray<System::Byte> Content, const System::UnicodeString ContentMD5 = System::UnicodeString(), const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall PutBlock(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseId, const System::UnicodeString ABlockId, System::DynamicArray<System::Byte> AContent, const System::UnicodeString AContentMD5, 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

Crée un nouveau bloc à valider comme partie d'un blob.

PutBlock crée un nouveau bloc à valider comme partie d'un blob.

La taille d'un bloc peut avoir jusqu'à 4 Mo. BlockId doit être une chaîne codée en base 64, qui est inférieure ou égale à la taille de 64 octets avant son encodage.

Pour un blob donné, tous les identifiants de blocs doivent avoir la même taille. Après avoir téléchargé un ensemble de blocs, vous pouvez créer ou mettre à jour le blob sur le serveur depuis cet ensemble, en appelant PutBlockList. Jusqu'alors, le blob ne contient pas ce bloc en tant que partie de son contenu. Si vous appelez PutBlock sur un blob qui n'existe pas encore, un nouveau blob de blocs non validé est créé avec une taille de contenu de 0.

Si vous appelez PutBlock en utilisant un BlockId d'un bloc non validé existant, le contenu sera remplacé.

Si PutBlockList n'est pas appelée dans un délai d'une semaine, tous les blocs non validés sont supprimés. Après avoir appelé PutBlockList, tous les blocs non validés non inclus dans la liste sont supprimés.

Le tableau suivant décrit les paramètres :

Paramètre Description

ContainerName

Le nom du conteneur dans lequel se trouve le blob.

BlobName

Le nom du blob pour lequel télécharger le bloc.

BlockId

L'ID qui identifie le bloc de façon unique.

Content

Le contenu du bloc en octets.

ContentMD5

Un hachage MD5 facultatif du contenu, utilisé à des fins de vérification.

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