Data.Cloud.AzureAPI.TAzureBlobService.PutBlockBlob

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function PutBlockBlob(ContainerName, BlobName: string; Content: TArray<Byte>;  LeaseId: string = ''; OptionalHeaders: TStrings = nil; Metadata: TStrings = nil; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutBlockBlob(const AContainerName, ABlobName, ALeaseID: string; const AContent: TArray<Byte>;  const AOptionalHeaders, AMetadata: array of TPair<string, string>; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall PutBlockBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, System::UnicodeString LeaseId = System::UnicodeString(), System::Classes::TStrings* OptionalHeaders = (System::Classes::TStrings*)(0x0), System::Classes::TStrings* Metadata = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall PutBlockBlob(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseID, const System::DynamicArray<System::Byte> AContent, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AOptionalHeaders, const int AOptionalHeaders_High, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AMetadata, const int AMetadata_High, 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

Erstellt im angegebenen Container ein neues Block-Blob oder aktualisiert ein bereits vorhandenes Block-Blob.

Mit PutBlockBlob wird im angegebenen Container ein Block-Blob erstellt oder ein bereits vorhandenes Block-Blob ersetzt.

Die folgende Tabelle beschreibt die Parameter:

Parameter Beschreibung

ContainerName

Der Name des Blob-Containers

BlobName

Der Name des Blobs

Content

Der Inhalt, der im Blob gesetzt werden soll

LeaseId

Die optionale Leasing-ID

OptionalHeaders

Die optionalen Header

Metadata

Die Metadaten, die im Blob gesetzt werden sollen

ResponseInfo

Die optionale Klasse zum Speichern der Antwortinformationen

Wenn ein Blob mit dem gegebenen Namen (im angegebenen Container) bereits vorhanden ist, wird sein Inhalt mit den Daten aus diesem Aufruf ersetzt.

LeaseId sollte als leerer String gesetzt werden, außer wenn ein Blob mit dem angegebenen Namen bereits vorhanden und aktuell gesperrt ist.

Der Parameter OptionalHeaders kann in der Anforderung gesetzt werden. Solche optionale Header sind:

  • Content-Type (oder x-ms-blob-content-type)
  • Content-Encoding (oder x-ms-blob-content-encoding)
  • Content-Language (oder x-ms-blob-content-language)
  • Content-MD5 (oder x-ms-blob-content-md5)
  • Cache-Control (oder x-ms-blob-cache-control)
  • If-Modified-Since
  • If-Unmodified-Since
  • If-None-Match (Vergleicht den Wert des Entitäts-Tag (Etag) der Ressource mit dem Wert dieses Headers)
  • If-None-Match (Vergleicht den Etag-Wert der Ressource mit dem Wert dieses Headers)

Die Namen der optionalen Metadaten sollten mit 'x-ms-meta-' beginnen. Wenn nicht, wird dieses Präfix hinzugefügt.

Die maximale zulässige Inhaltslänge eines Block-Blobs ist 64 MB. Wenn größer, müssen Sie sie als Blöcke hochladen.

Die Methode gibt True zurück, wenn das Erstellen/Ersetzen erfolgreich war, ansonsten False.

Siehe auch