Data.Cloud.AzureAPI.TAzureBlobService.GetBlob

• Übergeordnet: TAzureBlobService

Delphi

function GetBlob(ContainerName, BlobName: string; BlobStream: TStream;  const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream;  out Properties, Metadata: TStrings; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream;  StartByte: int64; EndByte: int64; GetAsHash: Boolean = False; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(ContainerName, BlobName: string; BlobStream: TStream;  out Properties, Metadata: TStrings; StartByte: int64; EndByte: int64; GetAsHash: Boolean = False; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlob(const AContainerName, ABlobName, ALeaseID: string; AStartByte, AEndByte: Int64;  AGetAsHash: Boolean; out AProperties, AMetadata: TArray<TPair<string, string>>; ABlobStream: TStream; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, __int64 StartByte, __int64 EndByte, bool GetAsHash = false, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStream* BlobStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, __int64 StartByte, __int64 EndByte, bool GetAsHash = false, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlob(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseID, __int64 AStartByte, __int64 AEndByte, bool AGetAsHash, /* out */ System::DynamicArray<System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> > &AProperties, /* out */ System::DynamicArray<System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> > &AMetadata, System::Classes::TStream* ABlobStream, 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

Lädt das angegebene Blob herunter, indem sein Inhalt in den bereitgestellten Stream geschrieben wird.

GetBlob lädt das angegebene Blob herunter, indem sein Inhalt in den bereitgestellten Stream geschrieben wird.

Es gibt vier überladene Methoden GetBlob.

Die zweite überladene Methode gibt auch die Eigenschaften und die Metadaten des Blobs zurück.

Mit der dritten überladenen Methode kann nur die Rückgabe eines Bereichs des Blobs angefordert werden, indem Werte für StartByte und EndByte angegeben werden. Wenn Sie ein Bereich angeben, können Sie auch GetAsHash auf True setzen, damit der MD5-Hash des Bereichsinhalts anstatt des Inhalts selbst zurückgegeben wird. Es kann nur der Hash für einen Bereich und nicht der ganze Inhalt zurückgegeben werden.

Die vierte überladene Methode gibt auch die Eigenschaften und Metadaten des Blobs zurück. Nur ein Bereich des Blobs kann zurückgegeben werden, indem Werte für StartByte und EndByte angegeben werden (genau wie bei der dritten überladenen Methode).

Die folgende Tabelle beschreibt die Parameter für alle vier überladenen Methoden:

Parameter	Beschreibung
ContainerName	Der Name des Containers, in dem sich das Blob befindet.
BlobName	Der Name des herunterzuladenden Blobs.
BlobStream	Der Stream, in den der Blob-Inhalt geschrieben werden soll.
StartByte	Der Byte-Startindex.
EndByte	Der Byte-Endindex oder 0, wenn kein Bereich des Blobs zurückgegeben werden soll.
GetAsHash	Bei True oder wenn EndByte größer als StartByte ist, gibt die Methode den Inhalt als MD5-Hash zurück.
Properties	Die Namens-/Wertepaare der Blob-Eigenschaften.
Metadata	Die Namens-/Wertepaare der Blob-Metadaten.
LeaseId	Die Leasing-ID, die erforderlich ist, wenn das Blob gesperrt ist.
ResponseInfo	Die optionale Klasse zum Speichern der Antwortinformationen.

Die Methode gibt True zurück, wenn die Aufgabe erfolgreich war, ansonsten False.

Siehe auch

• System.Classes.TStream

• DeleteBlob

• GetBlobSnapshot