Data.Cloud.AzureAPI.TAzureBlobService.PutPage

提供: RAD Studio API Documentation
移動先: 案内、 検索

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 */;

プロパティ

種類 可視性 ソース ユニット 親
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 つのすべてのオーバーロード メソッドのパラメータを説明しています：

パラメータ 説明

ContainerName

blob があるコンテナの名前。

BlobName

ブロックを更新する blob の名前。

Content

追加するコンテンツ。 512 で割り切れなければなりません。必要に応じて 0 で埋めます。

StartPage

このコンテンツが適用される最初のページの、0 始まりのインデックス。

Content

blob のコンテンツ（バイト単位）。

PageCount

このコンテンツが広がるページ（512 バイト）の数。

ActionConditional

アクションが実行されるために満たす必要のある条件。

ContentMD5

検証のための、コンテンツの MD5 ハッシュ（省略可能）。

LeaseId

リース ID、blob がロックされている場合には必須。

ResponseInfo

レスポンス情報を格納する任意のクラス。


メソッドは、作成/置換が成功した場合に True を、そうでなければ False を返します。

関連項目

「http://docwiki.embarcadero.com/Libraries/Rio/j/index.php?title=Data.Cloud.AzureAPI.TAzureBlobService.PutPage&oldid=691231」から取得