Data.Cloud.AzureAPI.TAzureBlobService.SetBlobProperties

• 親: TAzureBlobService

Delphi

function SetBlobProperties(ContainerName, BlobName: string; Properties: TStrings;  const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function SetBlobProperties(const AContainerName, ABlobName, ALeaseId: string;  const AProperties: array of TPair<string, string>; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall SetBlobProperties _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStrings* Properties, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall SetBlobProperties(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseId, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AProperties, const int AProperties_High, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;

プロパティ

種類	可視性	ソース	ユニット	親
function	public	Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp	Data.Cloud.AzureAPI	TAzureBlobService

説明

指定された blob に対して、指定されたプロパティを設定します。

SetBlobProperties は、指定された blob に対してプロパティを設定するために使用されます。

次の表では、パラメータを説明しています。

パラメータ	説明
ContainerName	blob があるコンテナの名前。
BlobName	プロパティを設定する blob の名前。
Properties	設定するプロパティ。
LeaseId	リース ID、blob がロックされている場合に必須。
ResponseInfo	レスポンス情報を保管するための、任意のクラス。

サポートされているプロパティは次のとおりです：

• x-ms-blob-cache-control
• x-ms-blob-content-type
• x-ms-blob-content-md5
• x-ms-blob-content-encoding
• x-ms-blob-content-language

ページ blob に対しては、次のものもサポートされています：

• x-ms-blob-content-length
• x-ms-sequence-number-action (max, update, incremen)
• x-ms-blob-sequence-number (x-ms-sequence-number-action = increment 以外の場合)

GetBlobProperties リクエストを発行する際、プロパティの名前は異なってきます：

• Cache-Control
• Content-Type
• Content-MD5
• Content-Encoding
• Content-Language

渡されたプロパティには、x-ms-blob- 接頭辞がない場合には、それが不可されます。他のすべてのプロパティは無視されます。

LeaseId は、blob がロックされている場合には空文字列ではいけません。

警告： このメソッドは、現在 blob 上にあるメタデータのフルセットを置き換えます。追加するわけではありません。

メモ： スナップショットのメタデータの更新はサポートされていません。

x-ms-blob-content-length プロパティを設定して、PutPageBlob が実行される際に指定される MaximumSize 値を変更することができます。

x-ms-sequence-number-action プロパティは、次のいずれかになります： max、update、increment。

• max： x-ms-blob-sequence-number で指定されたものか、サーバーにすでにあるもので、最大の整数値を使用。
• update： サーバーの x-ms-blob-sequence-number の値を、指定した値に置換。
• increment： サーバーの x-ms-blob-sequence-number の値を、1 つ増加。このリクエストでは、x-ms-blob-sequence-number ヘッダーを指定しないでください。

このメソッドは、アクションが成功した場合には True を、そうでない場合には False を返します。

関連項目

• SetContainerMetadata

• GetBlobMetadata

• GetBlobProperties