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 */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
Beschreibung
Schreibt den in einem Seiten-Blob enthaltenen Inhalt so oft, wie im Parameter PageCount angegeben.
Mit PutPage wird der in einem Seiten-Blob enthaltene Inhalt so oft geschrieben, wie im Parameter PageCount angegeben. Der Parameter StartPage gibt an, wo das Schreiben beginnt.
Der Parameter StartPage hat den Index 0 und wird der ersten Seite in einem Bereich von 1 oder mehreren Seiten zugeordnet, für die Inhalt erstellt oder geändert wird.
Es gibt vier überladene PutPage-Methoden.
Für die erste und die zweite überladene Methode ist jede Seite genau 512 Byte lang. Beim Übergeben im Parameter Content muss die Länge daher (512 * PageCount) sein. Wenn der Inhalt nicht lang genug ist, füllen Sie ihn mit Nullen auf.
Für die dritte und die vierte überladene Methode wird die Anzahl der Seiten dynamisch auf Basis der Länge des angegebenen Inhalts berechnet. Wenn die Länge des Inhalts nicht gleichmäßig durch 512 teilbar ist, wird sie mit Nullen aufgefüllt.
Zu den unterstützten Aktionsbedingungen für die zweite und die dritte überladene Methode gehören:
- IfModifiedSince
- IfUnmodifiedSince
- IfMatch
- IfNoneMatch
- if-sequence-number-lte
- if-sequence-number-lt
- if-sequence-number-eq
Die vierte überladene Methode muss nur für ein bereits vorhandenes Seiten-Blob aufgerufen werden.
Die folgende Tabelle beschreibt die Parameter für alle vier überladenen Methoden.
| Parameter | Beschreibung |
|---|---|
|
|
Der Name des Containers, in dem sich das Blob befindet. |
|
|
Der Name des Blobs, für das der Block hochgeladen werden soll. |
|
|
Der Inhalt, der hinzugefügt werden soll. Er muss gleichmäßig durch 512 teilbar sein. Mit Nullen auffüllen, falls erforderlich. |
|
|
Der nullbasierte Index der ersten Seite, für die dieser Inhalt gilt. |
|
|
Der Inhalt des Blocks in Byte. |
|
|
Die Anzahl der jeweils 512 Byte großen Seiten, über die sich dieser Inhalt erstreckt. |
|
|
Bedingungen, die für das Ausführen der Aktion erfüllt sein müssen. |
|
|
Ein optionaler MD5-Hashwert des Inhalts zu Überprüfungszwecken. |
|
|
Die Leasing-ID, die erforderlich ist, wenn das Blob gesperrt ist. |
|
|
Die optionale Klasse zum Speichern von Antwortinformationen. |
Die Methode gibt True zurück, wenn das Erstellen/Ersetzen erfolgreich war; ansonsten False.