Data.Cloud.AzureAPI.TAzureBlobService.PutPage
Delphi
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage, PageCount: Integer; const LeaseId: string = ''; const ContentMD5: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage, PageCount: Integer; ActionConditional: TBlobActionConditional; const ContentMD5: string = ''; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage: Integer; ActionConditional: TBlobActionConditional; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage: Integer; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutPage(const AContainerName, ABlobName, ALeaseID: string; AStartPage: Integer; AContent: TArray<Byte>; const AContentMD5: string; AActionConditional: TBlobActionConditional; const AResponseInfo: TCloudResponseInfo): Boolean; overload;
C++
bool __fastcall PutPage _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, int StartPage, int PageCount, const System::UnicodeString LeaseId = System::UnicodeString(), const System::UnicodeString ContentMD5 = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall PutPage _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, int StartPage, int PageCount, const TBlobActionConditional &ActionConditional, 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 PutPage _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, int StartPage, const TBlobActionConditional &ActionConditional, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall PutPage _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, int StartPage, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall PutPage(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseID, int AStartPage, System::DynamicArray<System::Byte> AContent, const System::UnicodeString AContentMD5, const TBlobActionConditional &AActionConditional, 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
Ecrit le contenu inclus dans un blob de pages autant de fois que spécifié par le paramètre PageCount.
PutPage est utilisé pour écrire le contenu inclus dans un blob de pages autant de fois que spécifié par le paramètre PageCount. Le paramètre StartPage spécifie où commence l'écriture.
Le paramètre StartPage a l'index de base zéro et effectue un mappage sur la première page dans un intervalle d'une ou plusieurs pages pour lesquelles du contenu est créé ou modifié.
Il existe quatre méthodes PutPage surchargées.
Pour les deux premières méthodes surchargées, la taille de chaque page a exactement 512 octets ; ainsi, lors de la transmission de Content, la longueur doit être (512 * PageCount). Si le contenu n'est pas suffisamment long, assurez-vous de le remplir avec des zéros.
Pour la troisième et la quatrième méthodes surchargées, le nombre de pages est calculé de façon dynamique, en fonction de la longueur du contenu spécifié. Si la longueur du contenu n'est pas divisible uniformément par 512, celui-ci est rempli avec des zéros.
Pour la deuxième et la troisième méthodes surchargées, les conditions des actions prises en charge comprennent :
- IfModifiedSince
- IfUnmodifiedSince
- IfMatch
- IfNoneMatch
- if-sequence-number-lte
- if-sequence-number-lt
- if-sequence-number-eq
La quatrième méthode surchargée doit être appelée sur un blob de pages déjà existant.
Le tableau suivant décrit les paramètres pour les quatre méthodes surchargées :
| Paramètre | Description |
|---|---|
|
|
Le nom du conteneur dans lequel se trouve le blob. |
|
|
Le nom du blob pour lequel télécharger le bloc. |
|
|
Le contenu à ajouter. Il doit être divisible uniformément par 512. Remplissez avec des zéros, si nécessaire. |
|
|
L'index de base zéro de la première page à laquelle ce contenu s'applique. |
|
|
Le contenu du bloc en octets. |
|
|
Le nombre de pages (de 512 octets) que ce contenu recouvre. |
|
|
Les conditions qui doivent être respectées afin que l'action s'exécute. |
|
|
Un hachage MD5 facultatif du contenu, utilisé à des fins de vérification. |
|
|
L'ID du bail, requis si le blob est verrouillé. |
|
|
La classe facultative dans laquelle stocker les informations sur la réponse. |
La méthode renvoie True si l'opération de création/remplacement a réussi, False dans le cas contraire.