Data.Cloud.AzureAPI.TAzureBlobService.GetBlobSnapshot

• Übergeordnet: TAzureBlobService

Delphi

function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;  ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;  out Properties, Metadata: TStrings; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;  StartByte: int64 = 0; EndByte: int64 = 0; GetAsHash: Boolean = False; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(ContainerName, BlobName, Snapshot: string; SnapshotStream: TStream;  out Properties, Metadata: TStrings; StartByte: int64 = 0; EndByte: int64 = 0; GetAsHash: Boolean = False; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function GetBlobSnapshot(const AContainerName, ABlobName, ASnapshot, ALeaseId: string; AStartByte, AEndByte: Int64;  AGetAsHash: Boolean; out AProperties, AMetadata: TArray<TPair<string, string>>; out ASnapshotStream: TStream; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, __int64 StartByte = 0LL, __int64 EndByte = 0LL, bool GetAsHash = false, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, System::UnicodeString Snapshot, System::Classes::TStream* SnapshotStream, /* out */ System::Classes::TStrings* &Properties, /* out */ System::Classes::TStrings* &Metadata, __int64 StartByte = 0LL, __int64 EndByte = 0LL, bool GetAsHash = false, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall GetBlobSnapshot(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ASnapshot, 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, /* out */ System::Classes::TStream* &ASnapshotStream, 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 den angegebenen Snapshot herunter, indem sein Inhalt in den bereitgestellten Stream geschrieben wird.

GetBlobSnapshot lädt den angegebenen Snapshot herunter, indem sein Inhalt in den bereitgestellten Stream geschrieben wird.

Es gibt vier überladene Methoden GetBlobSnapshot.

Die zweite überladene Methode gibt auch die Eigenschaften und die Metadaten des Snapshots 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 die Metadaten des Snapshots 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 Blobs, für das der Snapshot ist.
Snapshot	Der zu ermittelnde Snapshot.
SnapshotStream	Der Stream, in den der Snapshot-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 wurde, ansonsten False.

Siehe auch

• System.Classes.TStream

• DeleteBlob

• GetBlob