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;
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage, PageCount: Integer; ActionConditional: TBlobActionConditional; const ContentMD5: string = ''; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload;
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage: Integer; ActionConditional: TBlobActionConditional; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload;
function PutPage(ContainerName, BlobName: string; Content: TArray<Byte>; StartPage: Integer; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload;
C++
bool __fastcall PutPage(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(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(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(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 */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
説明
ページ blob に含まれるコンテンツを、PageCount
パラメータで指定された回数、書き込みます。
PutPage は、ページ blob に含まれるコンテンツを、PageCount
パラメータで指定された回数、書き込むために使用されます。 StartPage
パラメータは、書き込み開始場所を示します。
StartPage
は、0 始まりのインデックスが付き、コンテンツが作成または変更される 1 ページ以上の範囲での、最初のページにマップされます。
PutPage にはオーバーロード メソッドが 4 つあります。
第 1 および第 2 オーバーロード メソッドでは、各ページは 512 バイトちょうどであり、Content
内で渡される際、長さは「512 * PageCount
」でなければなりません。コンテンツの長さが足りない場合、0 で必ず埋めるようにしてください。
第 3 および第 4 オーバーロード メソッドでは、指定されたコンテンツの長さを基に、ページ数が動的に計算されます。コンテンツの長さは、512 で均等に割れないため、0 で埋められます。
第 2 および第 3 オーバーロード メソッドの場合、サポートされるアクション条件には次のものがあります:
- IfModifiedSince
- IfUnmodifiedSince
- IfMatch
- IfNoneMatch
- if-sequence-number-lte
- if-sequence-number-lt
- if-sequence-number-eq
第 4 オーバーロード メソッドは、すでに存在するページ blob に対してのみ呼び出します。
次の表では、4 つのすべてのオーバーロード メソッドのパラメータを説明しています:
パラメータ | 説明 |
---|---|
|
blob があるコンテナの名前。 |
|
ブロックを更新する blob の名前。 |
|
追加するコンテンツ。 512 で割り切れなければなりません。必要に応じて 0 で埋めます。 |
|
このコンテンツが適用される最初のページの、0 始まりのインデックス。 |
|
blob のコンテンツ(バイト単位)。 |
|
このコンテンツが広がるページ(512 バイト)の数。 |
|
アクションが実行されるために満たす必要のある条件。 |
|
検証のための、コンテンツの MD5 ハッシュ(省略可能)。 |
|
リース ID、blob がロックされている場合には必須。 |
|
レスポンス情報を格納する任意のクラス。 |
メソッドは、作成/置換が成功した場合に True を、そうでなければ False を返します。