BlockBlobClient Klasse

Definition

Mit BlockBlobClient können Sie Azure Storage-Blockblobs bearbeiten.

Mit Block-BLOBs können Sie große BLOBs effizient hochladen. Block-BLOBs bestehen aus Blöcken, von denen jeder durch eine Block-ID identifiziert wird. Sie erstellen oder ändern ein Block-BLOB, indem Sie bestimmte Blöcke schreiben und anhand der Block-IDs einen Commit ausführen. Jeder Block kann eine andere Größe aufweisen, bis zu einem Maximum von 4.000 MB (100 MB für Anforderungen mit REST-Versionen vor dem 12.12.2019 und 4 MB für Anforderungen mit REST-Versionen vor 2016-05-31), und ein Blockblob kann bis zu 50.000 Blöcke enthalten. Die maximale Größe eines Blockblobs beträgt daher ca. 190,73 TiB (4.000 MB x 50.000 Blöcke). Wenn Sie ein Blockblob schreiben, das nicht mehr als 5.000 MB groß ist, können Sie es vollständig mit einem einzelnen Schreibvorgang hochladen. Siehe UploadAsync(Stream, BlobUploadOptions, CancellationToken).

Wenn Sie einen Block in ein BLOB in Ihrem Speicherkonto hochladen, wird er dem angegebenen Block-BLOB zugeordnet. Der Block wird aber erst dann Teil des BLOB, wenn Sie für eine Liste von Blöcken, die die ID des neuen Blocks enthält, einen Commit ausführen. Neue Blöcke verbleiben ohne Commit, bis explizit ein Commit ausgeführt wird oder die Blöcke verworfen werden. Durch das Schreiben eines Blocks wird die Uhrzeit der letzten Änderung eines vorhandenen BLOB nicht aktualisiert.

Block-BLOBs stellen Funktionen bereit, die Ihnen bei der Verwaltung großer Dateien im Netzwerk helfen. Mit einem Block-BLOB können Sie mehrere Blöcke parallel hochladen, um die Uploadzeit zu verkürzen. Jeder Block kann einen MD5-Hash enthalten, um die Übertragung zu überprüfen, sodass Sie den Uploadfortschritt nachverfolgen und Blöcke nach Bedarf erneut senden können. Sie können Blöcke in beliebiger Reihenfolge hochladen und deren Reihenfolge im letzten Blocklisten-Verpflichtungsschritt bestimmen. Sie können auch einen neuen Block hochladen, um einen vorhandenen Block mit derselben Block-ID zu ersetzen, wenn für den Block noch kein Commit ausgeführt wurde. Sie haben eine Woche Zeit, den Commit für Blöcke in einem BLOB auszuführen, bevor die Blöcke verworfen werden. Zudem werden alle Blöcke ohne Commit auch dann verworfen, wenn ein Commit ausgeführt wird und die Blöcke nicht in der Blockliste des Commitvorgangs enthalten sind.

Sie können ein vorhandenes Block-BLOB ändern, indem Sie Blöcke einfügen oder ersetzen oder vorhandene Blöcke löschen. Nachdem Sie den oder die Blöcke hochgeladen haben, die sich geändert haben, bestätigen Sie die neue Version des BLOB, indem Sie in einem einzelnen Commitvorgang einen Commit für die neuen und für alle vorhandenen Blöcke ausführen, die erhalten bleiben sollen. Um denselben Bytebereich an zwei verschiedenen Speicherorten des committeten Blobs einzufügen, können Sie denselben Block an zwei Stellen innerhalb desselben Commitvorgangs committen. Wenn bei jedem Commitvorgang kein Block gefunden wird, schlägt der gesamte Verpflichtungsvorgang mit einem Fehler fehl, und das Blob wird nicht geändert. Jeder Commit für einen Block überschreibt die vorhandenen Eigenschaften und Metadaten des BLOB und verwirft alle Blöcke, für die kein Commit ausgeführt wurde.

Block-IDs sind Zeichenfolgen derselben Länge innerhalb eines BLOB. Block-Clientcode verwendet üblicherweise die Base-64-Codierung, um eine normalisierte Version der Zeichenfolgen mit gleicher Länge zu erstellen. Bei Verwendung der Base-64-Codierung darf die Ausgangszeichenfolge nicht länger sein als 64 Bytes. In unterschiedlichen BLOBs können dieselben Block-IDs verwendet werden. Ein Blob kann bis zu 100.000 Blöcke ohne Commit mit einer maximalen Gesamtgröße von ca. 381,46 TiB (4.000 MB x 100.000 Blöcke) enthalten.

Wenn Sie einen Block für ein BLOB schreiben, das noch nicht vorhanden ist, wird ein neues Block-BLOB mit der Größe 0 Bytes erstellt. Dieses BLOB wird in BLOB-Listen aufgeführt, die BLOBs ohne Commit enthalten. Wenn Sie für dieses BLOB keinen Block-Commit ausführen, werden das BLOB und alle ggf. vorhandenen Blöcke ohne Commit eine Woche nach dem letzten erfolgreichen Hochladen eines Blocks verworfen. Alle nicht committeten Blöcke werden auch verworfen, wenn ein neues Blob mit demselben Namen mithilfe eines einzelnen Schritts (anstelle des zweistufigen Blockupload-then-commit-Prozesses) erstellt wird.

public class BlockBlobClient : Azure.Storage.Blobs.Specialized.BlobBaseClient
type BlockBlobClient = class
    inherit BlobBaseClient
Public Class BlockBlobClient
Inherits BlobBaseClient
Vererbung
BlockBlobClient

Konstruktoren

BlockBlobClient()

Initialisiert eine neue instance der BlockBlobClient -Klasse zum Mocking.

BlockBlobClient(String, String, String)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

BlockBlobClient(String, String, String, BlobClientOptions)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

BlockBlobClient(Uri, AzureSasCredential, BlobClientOptions)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

BlockBlobClient(Uri, BlobClientOptions)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

BlockBlobClient(Uri, StorageSharedKeyCredential, BlobClientOptions)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

BlockBlobClient(Uri, TokenCredential, BlobClientOptions)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

Eigenschaften

AccountName

Ruft den Speicherkontonamen ab, der dem Blobclient entspricht.

(Geerbt von BlobBaseClient)
BlobContainerName

Ruft den Containernamen ab, der dem Blobclient entspricht.

(Geerbt von BlobBaseClient)
BlockBlobMaxBlocks

Ruft die maximale Anzahl von Blöcken ab, die in einem Blockblob zulässig sind.

BlockBlobMaxStageBlockLongBytes

Ruft die maximale Anzahl von Bytes ab, die in einem Aufruf von Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)gesendet werden können.

BlockBlobMaxUploadBlobLongBytes

Ruft die maximale Anzahl von Bytes ab, die in einem Aufruf von UploadAsync(Stream, BlobUploadOptions, CancellationToken)gesendet werden können.

CanGenerateSasUri

Bestimmt, ob der Client eine SAS generieren kann. Wenn der Client mit einem StorageSharedKeyCredentialauthentifiziert wird.

(Geerbt von BlobBaseClient)
Name

Ruft den Namen des Blobs ab.

(Geerbt von BlobBaseClient)
Uri

Ruft den primären Uri Endpunkt des Blobs ab.

(Geerbt von BlobBaseClient)

Methoden

AbortCopyFromUri(String, BlobRequestConditions, CancellationToken)

Der AbortCopyFromUri(String, BlobRequestConditions, CancellationToken) Vorgang bricht einen ausstehenden CopyFromUriOperationab und belässt ein dieses Blob mit der Länge 0 (null) und vollständigen Metadaten.

Weitere Informationen finden Sie unter Abbrechen des Kopierblobs.

(Geerbt von BlobBaseClient)
AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken)

Der AbortCopyFromUriAsync(String, BlobRequestConditions, CancellationToken) Vorgang bricht einen ausstehenden CopyFromUriOperationab und belässt ein dieses Blob mit der Länge 0 (null) und vollständigen Metadaten.

Weitere Informationen finden Sie unter Abbrechen des Kopierblobs.

(Geerbt von BlobBaseClient)
CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

Der CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)-Vorgang schreibt ein BLOB, indem die Liste der Block-IDs angegeben wird, aus denen sich das BLOB zusammensetzt. Wenn ein Block als Teil eines BLOB geschrieben werden soll, muss er zuvor erfolgreich in einem Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)-Vorgang auf den Server geschrieben worden sein. Sie können CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) aufrufen, um ein BLOB zu aktualisieren, indem Sie nur die Blöcke mit Änderungen hochladen und anschließend für die neuen und vorhandenen Blöcke einen Commit ausführen. Dies erreichen Sie, indem Sie angeben, ob für einen Block aus der Liste der Blöcke mit ausgeführtem Commit oder der Liste der Blöcke ohne ausgeführten Commit ein Commit ausgeführt werden soll, oder ob für die zuletzt hochgeladene Version des Blocks ein Commit ausgeführt werden soll, je nachdem, in welcher Liste der Block enthalten ist. Alle Blöcke, die nicht in der Blockliste angegeben und endgültig gelöscht wurden.

Weitere Informationen finden Sie unter Blockliste platzieren.

CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)

Der CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)-Vorgang schreibt ein BLOB, indem die Liste der Block-IDs angegeben wird, aus denen sich das BLOB zusammensetzt. Wenn ein Block als Teil eines BLOB geschrieben werden soll, muss er zuvor erfolgreich in einem Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)-Vorgang auf den Server geschrieben worden sein. Sie können CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) aufrufen, um ein BLOB zu aktualisieren, indem Sie nur die Blöcke mit Änderungen hochladen und anschließend für die neuen und vorhandenen Blöcke einen Commit ausführen. Dies erreichen Sie, indem Sie angeben, ob für einen Block aus der Liste der Blöcke mit ausgeführtem Commit oder der Liste der Blöcke ohne ausgeführten Commit ein Commit ausgeführt werden soll, oder ob für die zuletzt hochgeladene Version des Blocks ein Commit ausgeführt werden soll, je nachdem, in welcher Liste der Block enthalten ist. Alle Blöcke, die nicht in der Blockliste angegeben und endgültig gelöscht wurden.

Weitere Informationen finden Sie unter Blockliste platzieren.

CreateClient(Uri, BlobClientOptions, HttpPipeline)

Initialisiert eine neue Instanz der BlockBlobClient-Klasse.

CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Der CreateSnapshot(IDictionary<String,String>, BlobRequestConditions, CancellationToken)-Vorgang erstellt eine schreibgeschützte Momentaufnahme eines BLOB.

Weitere Informationen finden Sie unter Momentaufnahmeblob.

(Geerbt von BlobBaseClient)
CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Der CreateSnapshotAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)-Vorgang erstellt eine schreibgeschützte Momentaufnahme eines BLOB.

Weitere Informationen finden Sie unter Momentaufnahmeblob.

(Geerbt von BlobBaseClient)
Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

Der Vorgang Delete(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) kennzeichnet das angegebene BLOB oder die angegebene Momentaufnahme zum Löschen. Das Blob wird später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit IncludeSnapshotslöschen.

Weitere Informationen finden Sie unter Blob löschen.

(Geerbt von BlobBaseClient)
DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

Der Vorgang DeleteAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) kennzeichnet das angegebene BLOB oder die angegebene Momentaufnahme zum Löschen. Das Blob wird später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit IncludeSnapshotslöschen.

Weitere Informationen finden Sie unter Blob löschen.

(Geerbt von BlobBaseClient)
DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

Der DeleteIfExists(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) Vorgang markiert das angegebene Blob oder Momentaufnahme zum Löschen, sofern das Blob vorhanden ist. Das Blob wird später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit IncludeSnapshotslöschen.

Weitere Informationen finden Sie unter Blob löschen.

(Geerbt von BlobBaseClient)
DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)

Der DeleteIfExistsAsync(DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) Vorgang markiert das angegebene Blob oder Momentaufnahme zum Löschen, sofern das Blob vorhanden ist. Das Blob wird später während der Garbage Collection gelöscht, was einige Minuten dauern kann.

Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit IncludeSnapshotslöschen.

Weitere Informationen finden Sie unter Blob löschen.

(Geerbt von BlobBaseClient)
DeleteImmutabilityPolicy(CancellationToken)

Löscht die Unveränderlichkeitsrichtlinie, die dem Blob zugeordnet ist. Beachten Sie, dass die Blobversionsverwaltung für Ihr Speicherkonto aktiviert sein muss und sich das Blob in einem Container mit unveränderlichem Speicher mit aktivierter Versionsverwaltung befinden muss, um diese API aufzurufen.

(Geerbt von BlobBaseClient)
DeleteImmutabilityPolicyAsync(CancellationToken)

Löscht die Unveränderlichkeitsrichtlinie, die dem Blob zugeordnet ist. Beachten Sie, dass die Blobversionsverwaltung für Ihr Speicherkonto aktiviert sein muss und sich das Blob in einem Container mit unveränderlichem Speicher mit aktivierter Versionsverwaltung befinden muss, um diese API aufzurufen.

(Geerbt von BlobBaseClient)
DownloadContent()

Der DownloadContent() Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadContent(BlobDownloadOptions, CancellationToken)

Der DownloadContent(BlobDownloadOptions, CancellationToken) Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadContent(CancellationToken)

Der DownloadContent(CancellationToken) Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadContentAsync()

Der DownloadContentAsync() Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadContentAsync(BlobDownloadOptions, CancellationToken)

Der DownloadContentAsync(BlobDownloadOptions, CancellationToken) Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadContentAsync(CancellationToken)

Der DownloadContentAsync(CancellationToken) Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadStreaming(BlobDownloadOptions, CancellationToken)

Der DownloadStreaming(BlobDownloadOptions, CancellationToken) Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadStreamingAsync(BlobDownloadOptions, CancellationToken)

Der DownloadStreamingAsync(BlobDownloadOptions, CancellationToken) Vorgang lädt ein Blob aus dem Dienst herunter, einschließlich seiner Metadaten und Eigenschaften.

Weitere Informationen finden Sie unter Blob abrufen.

(Geerbt von BlobBaseClient)
DownloadTo(Stream)

Der DownloadTo(Stream) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in destination.

(Geerbt von BlobBaseClient)
DownloadTo(Stream, BlobDownloadToOptions, CancellationToken)

Der Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in options.Path.Path oder options.Stream.Stream.

(Geerbt von BlobBaseClient)
DownloadTo(Stream, CancellationToken)

Der DownloadTo(Stream, CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in destination.

(Geerbt von BlobBaseClient)
DownloadTo(String)

Der DownloadTo(String) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in path.

(Geerbt von BlobBaseClient)
DownloadTo(String, BlobDownloadToOptions, CancellationToken)

Der Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadTo(System.String,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in options.Path.Path oder options.Stream.Stream.

(Geerbt von BlobBaseClient)
DownloadTo(String, CancellationToken)

Der DownloadTo(String, CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in path.

(Geerbt von BlobBaseClient)
DownloadToAsync(Stream)

Lädt DownloadToAsync(Stream) ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in destination.

(Geerbt von BlobBaseClient)
DownloadToAsync(Stream, BlobDownloadToOptions, CancellationToken)

Der Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in options.Path.Path oder options.Stream.Stream.

(Geerbt von BlobBaseClient)
DownloadToAsync(Stream, CancellationToken)

Der DownloadToAsync(Stream, CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in destination.

(Geerbt von BlobBaseClient)
DownloadToAsync(String)

Lädt DownloadToAsync(String) ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in path.

(Geerbt von BlobBaseClient)
DownloadToAsync(String, BlobDownloadToOptions, CancellationToken)

Der Azure.Storage.Blobs.Specialized.BlobBaseClient.DownloadToAsync(System.IO.Stream,Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.StorageTransferOptions,System.Threading.CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in options.Path.Path oder options.Stream.Stream.

(Geerbt von BlobBaseClient)
DownloadToAsync(String, CancellationToken)

Der DownloadToAsync(String, CancellationToken) Vorgang lädt ein Blob mithilfe paralleler Anforderungen herunter und schreibt den Inhalt in path.

(Geerbt von BlobBaseClient)
Exists(CancellationToken)

Der Exists(CancellationToken) Vorgang kann für ein BlobBaseClient aufgerufen werden, um festzustellen, ob das zugeordnete Blob im Container im Speicherkonto im Speicherdienst vorhanden ist.

(Geerbt von BlobBaseClient)
ExistsAsync(CancellationToken)

Der ExistsAsync(CancellationToken) Vorgang kann für ein BlobBaseClient aufgerufen werden, um festzustellen, ob das zugeordnete Blob im Container im Speicherkonto im Speicherdienst vorhanden ist.

(Geerbt von BlobBaseClient)
GenerateSasUri(BlobSasBuilder)

Gibt GenerateSasUri(BlobSasBuilder) einen Uri zurück, der einen SAS-Uri (Shared Access Signature, Shared Access Signature, Shared Access Signature) des Blob-Diensts basierend auf den Clienteigenschaften und dem Generator generiert. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.

Informationen zur Überprüfung, ob der Client eine Service Sas-Instanz signieren kann, finden Sie unter CanGenerateSasUri.

Weitere Informationen finden Sie unter Erstellen einer Dienst-SAS

(Geerbt von BlobBaseClient)
GenerateSasUri(BlobSasPermissions, DateTimeOffset)

Gibt GenerateSasUri(BlobSasPermissions, DateTimeOffset) einen Uri zurück, der basierend auf den übergebenen Clienteigenschaften und Parametern einen SAS-Uri (Shared Access Signature, Shared Access Signature) des Blobdiensts generiert. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.

Informationen zur Überprüfung, ob der Client eine Service Sas-Instanz signieren kann, finden Sie unter CanGenerateSasUri.

Weitere Informationen finden Sie unter Erstellen einer Dienst-SAS.

(Geerbt von BlobBaseClient)
GetBlobLeaseClientCore(String)

Initialisiert eine neue Instanz der BlobLeaseClient-Klasse.

(Geerbt von BlobBaseClient)
GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken)

Der GetBlockList(BlockListTypes, String, BlobRequestConditions, CancellationToken) Vorgangsvorgang ruft die Liste der Blöcke ab, die als Teil eines Blockblobs hochgeladen wurden. Für ein Blob werden zwei Blocklisten verwaltet. Die Liste "Committeter Block" enthält Blöcke, die erfolgreich für ein bestimmtes Blob mit CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken)festgelegt wurden. Die Liste Nicht gebundener Block enthält Blöcke, die für ein Blob mit Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)hochgeladen wurden, aber noch nicht committet wurden. Diese Blöcke werden in Azure in Verbindung mit einem BLOB gespeichert, sind aber noch nicht Teil des BLOB.

GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken)

Der GetBlockListAsync(BlockListTypes, String, BlobRequestConditions, CancellationToken) Vorgangsvorgang ruft die Liste der Blöcke ab, die als Teil eines Blockblobs hochgeladen wurden. Für ein Blob werden zwei Blocklisten verwaltet. Die Liste "Committeter Block" enthält Blöcke, die erfolgreich für ein bestimmtes Blob mit CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken)festgelegt wurden. Die Liste Nicht gebundener Block enthält Blöcke, die für ein Blob mit Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlockAsync(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken)hochgeladen wurden, aber noch nicht committet wurden. Diese Blöcke werden in Azure in Verbindung mit einem BLOB gespeichert, sind aber noch nicht Teil des BLOB.

GetParentBlobContainerClientCore()

Erstellen Sie einen neuen BlobContainerClient , der auf diesen BlobBaseClientübergeordneten Container verweist. Das neue BlockBlobClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die BlobBaseClient.

(Geerbt von BlobBaseClient)
GetProperties(BlobRequestConditions, CancellationToken)

Mit dem GetProperties(BlobRequestConditions, CancellationToken)-Vorgang werden alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurückgegeben. Der Inhalt des BLOB wird nicht zurückgegeben.

Weitere Informationen finden Sie unter Abrufen von Blobeigenschaften.

(Geerbt von BlobBaseClient)
GetPropertiesAsync(BlobRequestConditions, CancellationToken)

Mit dem GetPropertiesAsync(BlobRequestConditions, CancellationToken)-Vorgang werden alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurückgegeben. Der Inhalt des BLOB wird nicht zurückgegeben.

Weitere Informationen finden Sie unter Abrufen von Blobeigenschaften.

(Geerbt von BlobBaseClient)
GetTags(BlobRequestConditions, CancellationToken)

Ruft die Tags ab, die dem zugrunde liegenden Blob zugeordnet sind.

Weitere Informationen finden Sie unter Blobtags abrufen

(Geerbt von BlobBaseClient)
GetTagsAsync(BlobRequestConditions, CancellationToken)

Ruft die Tags ab, die dem zugrunde liegenden Blob zugeordnet sind.

Weitere Informationen finden Sie unter Blobtags abrufen

(Geerbt von BlobBaseClient)
OpenRead(BlobOpenReadOptions, CancellationToken)

Öffnet einen Datenstrom, um Daten aus dem Blob zu lesen. Über den Stream wird das Blob nur heruntergeladen, während der Stream gelesen wird.

(Geerbt von BlobBaseClient)
OpenReadAsync(BlobOpenReadOptions, CancellationToken)

Öffnet einen Datenstrom, um Daten aus dem Blob zu lesen. Über den Stream wird das Blob nur heruntergeladen, während der Stream gelesen wird.

(Geerbt von BlobBaseClient)
OpenWrite(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

Öffnet einen Datenstrom, um in das Blob zu schreiben.

OpenWriteAsync(Boolean, BlockBlobOpenWriteOptions, CancellationToken)

Öffnet einen Datenstrom, um in das Blob zu schreiben. Wenn das Blob vorhanden ist, wird es überschrieben.

Query(String, BlobQueryOptions, CancellationToken)

Die Query(String, BlobQueryOptions, CancellationToken) API gibt das Ergebnis einer Abfrage für das Blob zurück.

Weitere Informationen finden Sie unter Abfragen von Blobinhalten.

QueryAsync(String, BlobQueryOptions, CancellationToken)

Die QueryAsync(String, BlobQueryOptions, CancellationToken) API gibt das Ergebnis einer Abfrage für das Blob zurück.

Weitere Informationen finden Sie unter Abfragen von Blobinhalten.

SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

Der SetAccessTier(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) Vorgang legt die Ebene für ein Blob fest. Der Vorgang ist für ein Seitenblob in einem Storage Premium-Konto und für ein Blockblob in einem Blobspeicher- oder v2-Konto mit allgemeinem Zweck zulässig.

Die Ebene eines Premium-Seitenblobs bestimmt die zulässige Größe, IOPS und Bandbreite des Blobs. Die Ebene eines Blockblobs bestimmt den Speichertyp Hot/Cool/Archive. Bei diesem Vorgang wird das ETag des Blobs nicht aktualisiert. Ausführliche Informationen zum Tiering von Blob Storage-Ebenen auf Blockblobebene.

Weitere Informationen zum Festlegen der Ebene finden Sie unter Blob Storage-Tarife.

(Geerbt von BlobBaseClient)
SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken)

Der SetAccessTierAsync(AccessTier, BlobRequestConditions, Nullable<RehydratePriority>, CancellationToken) Vorgang legt die Ebene für ein Blob fest. Der Vorgang ist für ein Seitenblob in einem Storage Premium-Konto und für ein Blockblob in einem Blobspeicher- oder v2-Konto mit allgemeinem Zweck zulässig.

Die Ebene eines Premium-Seitenblobs bestimmt die zulässige Größe, IOPS und Bandbreite des Blobs. Die Ebene eines Blockblobs bestimmt den Speichertyp Hot/Cool/Archive. Bei diesem Vorgang wird das ETag des Blobs nicht aktualisiert. Ausführliche Informationen zum Tiering von Blob Storage-Ebenen auf Blockblobebene.

Weitere Informationen zum Festlegen der Ebene finden Sie unter Blob Storage-Tarife.

(Geerbt von BlobBaseClient)
SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

Mit dem Vorgang SetHttpHeaders(BlobHttpHeaders, BlobRequestConditions, CancellationToken) werden Systemeigenschaften für das BLOB festgelegt.

Weitere Informationen finden Sie unter Legen Sie Blobeigenschaften fest.

(Geerbt von BlobBaseClient)
SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken)

Mit dem Vorgang SetHttpHeadersAsync(BlobHttpHeaders, BlobRequestConditions, CancellationToken) werden Systemeigenschaften für das BLOB festgelegt.

Weitere Informationen finden Sie unter Legen Sie Blobeigenschaften fest.

(Geerbt von BlobBaseClient)
SetImmutabilityPolicy(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Legt die Unveränderlichkeitsrichtlinie für ein Blob, eine Blobmomentaufnahme oder eine Blobversion fest. Beachten Sie, dass die Blobversionsverwaltung für Ihr Speicherkonto aktiviert sein muss und sich das Blob in einem Container mit unveränderlichem Speicher mit aktivierter Versionsverwaltung befinden muss, um diese API aufzurufen.

(Geerbt von BlobBaseClient)
SetImmutabilityPolicyAsync(BlobImmutabilityPolicy, BlobRequestConditions, CancellationToken)

Legt die Unveränderlichkeitsrichtlinie für ein Blob, eine Blobmomentaufnahme oder eine Blobversion fest. Beachten Sie, dass die Blobversionsverwaltung für Ihr Speicherkonto aktiviert sein muss und sich das Blob in einem Container mit unveränderlichem Speicher mit aktivierter Versionsverwaltung befinden muss, um diese API aufzurufen.

(Geerbt von BlobBaseClient)
SetLegalHold(Boolean, CancellationToken)

Legt einen rechtlichen Halteraum für das Blob fest. Beachten Sie, dass die Blobversionsverwaltung für Ihr Speicherkonto aktiviert sein muss und sich das Blob in einem Container mit unveränderlichem Speicher mit aktivierter Versionsverwaltung befinden muss, um diese API aufzurufen.

(Geerbt von BlobBaseClient)
SetLegalHoldAsync(Boolean, CancellationToken)

Legt einen rechtlichen Halteraum für das Blob fest. Beachten Sie, dass die Blobversionsverwaltung für Ihr Speicherkonto aktiviert sein muss und sich das Blob in einem Container mit unveränderlichem Speicher mit aktivierter Versionsverwaltung befinden muss, um diese API aufzurufen.

(Geerbt von BlobBaseClient)
SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Der SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken)-Vorgang legt benutzerdefinierte Metadaten für das angegebene BLOB als ein oder mehrere Name-Wert-Paare fest.

Weitere Informationen finden Sie unter Legen Sie Blobmetadaten fest.

(Geerbt von BlobBaseClient)
SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Der SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)-Vorgang legt benutzerdefinierte Metadaten für das angegebene BLOB als ein oder mehrere Name-Wert-Paare fest.

Weitere Informationen finden Sie unter Legen Sie Blobmetadaten fest.

(Geerbt von BlobBaseClient)
SetTags(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Legt Tags für das zugrunde liegende Blob fest. Ein Blob kann bis zu 10 Tags aufweisen. Tagschlüssel müssen zwischen 1 und 128 Zeichen lang sein. Tagwerte müssen zwischen 0 und 256 Zeichen lang sein. Gültige Tagschlüssel- und Wertzeichen umfassen Klein- und Großbuchstaben, Ziffern (0-9), Leerzeichen (' '), plus ('+'), Minuszeichen ('-'), Punkt ('.'), Schrägstrich ('/'), Doppelpunkt (':'), gleich ('=') und Unterstrich ('_') .

Weitere Informationen finden Sie unter Legen Sie Blobtags fest.

(Geerbt von BlobBaseClient)
SetTagsAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)

Legt Tags für das zugrunde liegende Blob fest. Ein Blob kann bis zu 10 Tags aufweisen. Tagschlüssel müssen zwischen 1 und 128 Zeichen lang sein. Tagwerte müssen zwischen 0 und 256 Zeichen lang sein. Gültige Tagschlüssel- und Wertzeichen umfassen Klein- und Großbuchstaben, Ziffern (0-9), Leerzeichen (' '), plus ('+'), Minuszeichen ('-'), Punkt ('.'), Schrägstrich ('/'), Doppelpunkt (':'), gleich ('=') und Unterstrich ('_') .

Weitere Informationen finden Sie unter Legen Sie Blobtags fest.

(Geerbt von BlobBaseClient)
StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

Der StageBlock(String, Stream, BlockBlobStageBlockOptions, CancellationToken) Vorgang erstellt einen neuen Block als Teil des "Stagingbereichs" eines Blockblobs, der schließlich über den CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) Vorgang committet werden soll.

Weitere Informationen finden Sie unter Put Block.

StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken)

Der StageBlockAsync(String, Stream, BlockBlobStageBlockOptions, CancellationToken) Vorgang erstellt einen neuen Block als Teil des "Stagingbereichs" eines Blockblobs, der schließlich über den CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) Vorgang committet werden soll.

Weitere Informationen finden Sie unter Put Block.

StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken)

Der StageBlockFromUri(Uri, String, StageBlockFromUriOptions, CancellationToken) Vorgang erstellt einen neuen Block, der als Teil eines Blobs committet wird, in dem der Inhalt aus dem sourceUrigelesen wird.

Weitere Informationen finden Sie unter Legen Sie Block from URL (Block from URL) fest.

StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken)

Der StageBlockFromUriAsync(Uri, String, StageBlockFromUriOptions, CancellationToken) Vorgang erstellt einen neuen Block, der als Teil eines Blobs committet wird, in dem der Inhalt aus dem sourceUrigelesen wird.

Weitere Informationen finden Sie unter Legen Sie Block from URL (Block from URL) fest.

StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

Der StartCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken) Vorgang beginnt eine asynchrone Kopie der Daten aus dem source in dieses Blob. Sie können überprüfen, ob die Azure.Storage.Blobs.Models.BlobProperties.CopyStatusGetProperties(BlobRequestConditions, CancellationToken) Kopie abgeschlossen wurde.

Weitere Informationen finden Sie unter Blob kopieren.

(Geerbt von BlobBaseClient)
StartCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

Der Azure.Storage.Blobs.Specialized.BlobBaseClient.StartCopyFromUri(System.Uri,System.Collections.Generic.IDictionary{System.String,System.String},System.Nullable{Azure.Storage.Blobs.Models.AccessTier},Azure.Storage.Blobs.Models.BlobRequestConditions,Azure.Storage.Blobs.Models.BlobRequestConditions,System.Nullable{Azure.Storage.Blobs.Models.RehydratePriority},System.Threading.CancellationToken) Vorgang beginnt eine asynchrone Kopie der Daten aus dem source in dieses Blob. Sie können überprüfen, ob die Azure.Storage.Blobs.Models.BlobProperties.CopyStatusGetPropertiesAsync(BlobRequestConditions, CancellationToken) Kopie abgeschlossen wurde.

Weitere Informationen finden Sie unter Blob kopieren.

(Geerbt von BlobBaseClient)
SyncCopyFromUri(Uri, BlobCopyFromUriOptions, CancellationToken)

Der Vorgang "Blob aus URL kopieren" kopiert ein Blob synchron in ein Ziel innerhalb des Speicherkontos für Quellblobgrößen von bis zu 256 MiB. Diese API ist ab Version 2018-03-28 verfügbar. Die Quelle für einen Vorgang "Blob aus URL kopieren" kann ein beliebiges committetes Blockblob in einem beliebigen Azure-Speicherkonto sein, das entweder öffentlich oder mit einer Freigegebenen Zugriffssignatur autorisiert ist.

Die Größe des Quellblobs kann eine maximale Länge von bis zu 256 MiB aufweisen.

Weitere Informationen finden Sie unter Blob aus URL kopieren.

(Geerbt von BlobBaseClient)
SyncCopyFromUriAsync(Uri, BlobCopyFromUriOptions, CancellationToken)

Der Vorgang "Blob aus URL kopieren" kopiert ein Blob synchron in ein Ziel innerhalb des Speicherkontos für Quellblobgrößen von bis zu 256 MiB. Diese API ist ab Version 2018-03-28 verfügbar. Die Quelle für einen Vorgang "Blob aus URL kopieren" kann ein beliebiges committetes Blockblob in einem beliebigen Azure-Speicherkonto sein, das entweder öffentlich oder mit einer Freigegebenen Zugriffssignatur autorisiert ist.

Die Größe des Quellblobs kann eine maximale Länge von bis zu 256 MiB aufweisen.

Weitere Informationen finden Sie unter Blob aus URL kopieren.

(Geerbt von BlobBaseClient)
SyncUploadFromUri(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

Der Vorgang Upload from URI erstellt ein neues Blockblob, in dem der Inhalt des Blobs aus einer bestimmten URL gelesen wird. Diese API wird ab version 2020-04-08 unterstützt.

Partielle Updates werden mit Put Blob from URL nicht unterstützt. Der Inhalt eines vorhandenen Blobs wird mit dem Inhalt des neuen Blobs überschrieben. Um partielle Aktualisierungen des Inhalts eines Blockblobs mithilfe einer Quell-URL durchzuführen, verwenden Sie die API Put Block from URL in Verbindung mit Put Block List.

SyncUploadFromUri(Uri, Boolean, CancellationToken)

Der Vorgang Upload from URI erstellt ein neues Blockblob, in dem der Inhalt des Blobs aus einer bestimmten URL gelesen wird. Diese API wird ab version 2020-04-08 unterstützt.

Partielle Updates werden mit Put Blob from URL nicht unterstützt. Der Inhalt eines vorhandenen Blobs wird mit dem Inhalt des neuen Blobs überschrieben. Um partielle Aktualisierungen des Inhalts eines Blockblobs mithilfe einer Quell-URL durchzuführen, verwenden Sie die API Put Block from URL in Verbindung mit Put Block List.

SyncUploadFromUriAsync(Uri, BlobSyncUploadFromUriOptions, CancellationToken)

Der Vorgang Upload from URI erstellt ein neues Blockblob, in dem der Inhalt des Blobs aus einer bestimmten URL gelesen wird. Diese API wird ab version 2020-04-08 unterstützt.

Partielle Updates werden mit Put Blob from URL nicht unterstützt. Der Inhalt eines vorhandenen Blobs wird mit dem Inhalt des neuen Blobs überschrieben. Um partielle Aktualisierungen des Inhalts eines Blockblobs mithilfe einer Quell-URL durchzuführen, verwenden Sie die API Put Block from URL in Verbindung mit Put Block List.

SyncUploadFromUriAsync(Uri, Boolean, CancellationToken)

Der Vorgang Upload from URI erstellt ein neues Blockblob, in dem der Inhalt des Blobs aus einer bestimmten URL gelesen wird. Diese API wird ab version 2020-04-08 unterstützt.

Partielle Updates werden mit Put Blob from URL nicht unterstützt. Der Inhalt eines vorhandenen Blobs wird mit dem Inhalt des neuen Blobs überschrieben. Um partielle Aktualisierungen des Inhalts eines Blockblobs mithilfe einer Quell-URL durchzuführen, verwenden Sie die API Put Block from URL in Verbindung mit Put Block List.

Undelete(CancellationToken)

Der Undelete(CancellationToken) Vorgang stellt den Inhalt und die Metadaten eines vorläufig gelöschten Blobs und alle zugeordneten vorläufig gelöschten Momentaufnahmen wieder her.

Weitere Informationen finden Sie unter Wiederherstellen des Blobs.

(Geerbt von BlobBaseClient)
UndeleteAsync(CancellationToken)

Der UndeleteAsync(CancellationToken) Vorgang stellt den Inhalt und die Metadaten eines vorläufig gelöschten Blobs und alle zugeordneten vorläufig gelöschten Momentaufnahmen wieder her.

Weitere Informationen finden Sie unter Wiederherstellen des Blobs.

(Geerbt von BlobBaseClient)
Upload(Stream, BlobUploadOptions, CancellationToken)

Der Upload(Stream, BlobUploadOptions, CancellationToken) Vorgang überschreibt den Inhalt des Blobs und erstellt ein neues Blockblob, falls kein vorhanden ist. Das Überschreiben eines vorhandenen Blockblobs ersetzt alle vorhandenen Metadaten im Blob.

Legen Sie Zugriffsbedingungen durch Conditions fest, um zu vermeiden, dass vorhandene Daten überschrieben werden.

Teilweise Updates werden von Upload(Stream, BlobUploadOptions, CancellationToken) nicht unterstützt; der Inhalt des vorhandenen BLOB wird mit dem Inhalt des neuen BLOB überschrieben. Verwenden Sie Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) die - und CommitBlockList(IEnumerable<String>, CommitBlockListOptions, CancellationToken) -Vorgänge, um eine partielle Aktualisierung des Inhalts eines Blockblobs durchzuführen.

Weitere Informationen finden Sie unter Legen Sie Blob fest.

UploadAsync(Stream, BlobUploadOptions, CancellationToken)

Der UploadAsync(Stream, BlobUploadOptions, CancellationToken) Vorgang überschreibt den Inhalt des Blobs und erstellt ein neues Blockblob, falls kein vorhanden ist. Das Überschreiben eines vorhandenen Blockblobs ersetzt alle vorhandenen Metadaten im Blob.

Legen Sie Zugriffsbedingungen durch Conditions fest, um zu vermeiden, dass vorhandene Daten überschrieben werden.

Teilweise Updates werden von UploadAsync(Stream, BlobUploadOptions, CancellationToken) nicht unterstützt; der Inhalt des vorhandenen BLOB wird mit dem Inhalt des neuen BLOB überschrieben. Verwenden Sie Azure.Storage.Blobs.Specialized.BlockBlobClient.StageBlock(System.String,System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.BlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) die - und CommitBlockListAsync(IEnumerable<String>, CommitBlockListOptions, CancellationToken) -Vorgänge, um eine partielle Aktualisierung des Inhalts eines Blockblobs durchzuführen.

Weitere Informationen finden Sie unter Legen Sie Blob fest.

WithCustomerProvidedKey(Nullable<CustomerProvidedKey>)

Initialisiert eine neue instance der BlockBlobClient -Klasse mit einer identischen Uri Quelle, aber der angegebenen customerProvidedKey.

WithEncryptionScope(String)

Initialisiert eine neue instance der BlockBlobClient -Klasse mit einer identischen Uri Quelle, aber der angegebenen encryptionScope.

WithSnapshot(String)

Initialisiert einen neuen instance der BlockBlobClient -Klasse mit einer identischen Uri Quelle, aber dem angegebenen snapshot Zeitstempel.

Weitere Informationen finden Sie unter Erstellen Sie eine Momentaufnahme eines Blobs.

WithSnapshotCore(String)

Erstellt einen neuen instance der BlockBlobClient -Klasse mit einer identischen Uri Quelle, aber dem angegebenen snapshot Zeitstempel.

WithVersion(String)

Initialisiert einen neuen instance der BlockBlobClient -Klasse mit einer identischen Uri Quelle, aber dem angegebenen versionId Zeitstempel.

Erweiterungsmethoden

GetBlobLeaseClient(BlobBaseClient, String)

Initialisiert eine neue Instanz der BlobLeaseClient-Klasse.

GetParentBlobContainerClient(BlobBaseClient)

Erstellen Sie eine neue BlobContainerClient , die auf den übergeordneten Container verweist BlobBaseClient. Die neue BlockBlobClient verwendet dieselbe Anforderungsrichtlinienpipeline wie die BlobBaseClient.

Gilt für: