Freigeben über

CloudAppendBlob.AppendBlockAsync Methode

  • Referenz

Definition

Namespace:
Microsoft.Azure.Storage.Blob
Assembly:
Microsoft.Azure.Storage.Blob.dll
Paket:
Microsoft.Azure.Storage.Blob v11.2.3

Überlädt

AppendBlockAsync(Stream, String)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.
AppendBlockAsync(Stream, String, CancellationToken)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.
AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.
AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Committent einen neuen Datenblock an das Ende des Blobs.

AppendBlockAsync(Stream, String)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5 = default);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, Optional contentMD5 As String = Nothing) As Task(Of Long)

Parameter

blockData
Stream

Ein Stream -Objekt, das die Daten für den Block bereitstellt.

contentMD5
String

Ein optionaler Hashwert, der zum Sicherstellen der Transaktionsintegrität verwendet wird. Kann oder eine leere Zeichenfolge sein null .

Gibt zurück

Task<Int64>

Ein Task-Objekt, das den asynchronen Vorgang darstellt.

Attribute
DoesServiceRequestAttribute

Hinweise

Clients können den Content-MD5-Header für einen bestimmten Anfügeblockungsvorgang senden, um die Transaktionsintegrität über das Netzwerk sicherzustellen. Der contentMD5 Parameter ermöglicht Clients, die bereits Zugriff auf einen vorab berechneten MD5-Wert für einen bestimmten Bytebereich haben, diesen bereitzustellen. Wenn die BlobRequestOptions.UseTransactionalMd5 -Eigenschaft auf true und der contentMD5 Parameter auf nullfestgelegt ist, berechnet die Clientbibliothek den MD5-Wert intern.

Gilt für:

AppendBlockAsync(Stream, String, CancellationToken)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, cancellationToken As CancellationToken) As Task(Of Long)

Parameter

blockData
Stream

Ein Stream -Objekt, das die Daten für den Block bereitstellt.

contentMD5
String

Ein optionaler Hashwert, der zum Sicherstellen der Transaktionsintegrität verwendet wird. Kann oder eine leere Zeichenfolge sein null .

cancellationToken
CancellationToken

Ein CancellationToken, das beim Warten auf den Abschluss einer Aufgabe überwacht werden soll.

Gibt zurück

Task<Int64>

Ein Task-Objekt, das den asynchronen Vorgang darstellt.

Attribute
DoesServiceRequestAttribute

Hinweise

Clients können den Content-MD5-Header für einen bestimmten Put-Block-Vorgang senden, um die Transaktionsintegrität über das Netzwerk sicherzustellen. Der contentMD5 Parameter ermöglicht Clients, die bereits Zugriff auf einen vorab berechneten MD5-Wert für einen bestimmten Bytebereich haben, diesen bereitzustellen. Wenn die BlobRequestOptions.UseTransactionalMd5 -Eigenschaft auf true und der contentMD5 Parameter auf nullfestgelegt ist, berechnet die Clientbibliothek den MD5-Wert intern.

Gilt für:

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of Long)

Parameter

blockData
Stream

Ein Stream -Objekt, das die Daten für den Block bereitstellt.

contentMD5
String

Ein optionaler Hashwert, der zum Sicherstellen der Transaktionsintegrität verwendet wird. Kann oder eine leere Zeichenfolge sein null .

accessCondition
AccessCondition

Ein AccessCondition-Objekt, das die Bedingung darstellt, die erfüllt werden muss, damit die Anforderung fortgesetzt werden kann. Wenn null, wird keine Bedingung verwendet.

options
BlobRequestOptions

Ein BlobRequestOptions-Objekt, das zusätzliche Optionen für die Anforderung angibt.

operationContext
OperationContext

Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt.

Gibt zurück

Task<Int64>

Ein Task-Objekt, das den asynchronen Vorgang darstellt.

Attribute
DoesServiceRequestAttribute

Hinweise

Clients können den Content-MD5-Header für einen bestimmten Anfügeblockungsvorgang senden, um die Transaktionsintegrität über das Netzwerk sicherzustellen. Der contentMD5 Parameter ermöglicht Clients, die bereits Zugriff auf einen vorab berechneten MD5-Wert für einen bestimmten Bytebereich haben, diesen bereitzustellen. Wenn die BlobRequestOptions.UseTransactionalMd5 -Eigenschaft auf true und der contentMD5 Parameter auf nullfestgelegt ist, berechnet die Clientbibliothek den MD5-Wert intern.

Gilt für:

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)

Parameter

blockData
Stream

Ein Stream -Objekt, das die Daten für den Block bereitstellt.

contentMD5
String

Ein optionaler Hashwert, der zum Sicherstellen der Transaktionsintegrität verwendet wird. Kann oder eine leere Zeichenfolge sein null .

accessCondition
AccessCondition

Ein AccessCondition-Objekt, das die Bedingung darstellt, die erfüllt werden muss, damit die Anforderung fortgesetzt werden kann. Wenn null, wird keine Bedingung verwendet.

options
BlobRequestOptions

Ein BlobRequestOptions-Objekt, das zusätzliche Optionen für die Anforderung angibt.

operationContext
OperationContext

Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt.

cancellationToken
CancellationToken

Ein CancellationToken, das beim Warten auf den Abschluss einer Aufgabe überwacht werden soll.

Gibt zurück

Task<Int64>

Ein Task-Objekt, das den asynchronen Vorgang darstellt.

Attribute
DoesServiceRequestAttribute

Hinweise

Clients können den Content-MD5-Header für einen bestimmten Anfügeblockungsvorgang senden, um die Transaktionsintegrität über das Netzwerk sicherzustellen. Der contentMD5 Parameter ermöglicht Clients, die bereits Zugriff auf einen vorab berechneten MD5-Wert für einen bestimmten Bytebereich haben, diesen bereitzustellen. Wenn die BlobRequestOptions.UseTransactionalMd5 -Eigenschaft auf true und der contentMD5 Parameter auf nullfestgelegt ist, berechnet die Clientbibliothek den MD5-Wert intern.

Gilt für:

AppendBlockAsync(Stream, String, AccessCondition, BlobRequestOptions, OperationContext, IProgress<StorageProgress>, CancellationToken)

Initiiert einen asynchronen Vorgang, um einen neuen Datenblock an das Ende des Blobs zu committen.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (System.IO.Stream blockData, string contentMD5, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> progressHandler, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : System.IO.Stream * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * IProgress<Microsoft.Azure.Storage.Core.Util.StorageProgress> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (blockData As Stream, contentMD5 As String, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, progressHandler As IProgress(Of StorageProgress), cancellationToken As CancellationToken) As Task(Of Long)

Parameter

blockData
Stream

Ein Stream -Objekt, das die Daten für den Block bereitstellt.

contentMD5
String

Ein optionaler Hashwert, der zum Sicherstellen der Transaktionsintegrität verwendet wird. Kann oder eine leere Zeichenfolge sein null .

accessCondition
AccessCondition

Ein AccessCondition-Objekt, das die Bedingung darstellt, die erfüllt werden muss, damit die Anforderung fortgesetzt werden kann. Wenn null, wird keine Bedingung verwendet.

options
BlobRequestOptions

Ein BlobRequestOptions-Objekt, das zusätzliche Optionen für die Anforderung angibt.

operationContext
OperationContext

Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt.

progressHandler
IProgress<StorageProgress>

Ein IProgress<T> -Objekt zum Verarbeiten von StorageProgress Nachrichten.

cancellationToken
CancellationToken

Ein CancellationToken, das beim Warten auf den Abschluss einer Aufgabe überwacht werden soll.

Gibt zurück

Task<Int64>

Ein Task-Objekt, das den asynchronen Vorgang darstellt.

Attribute
DoesServiceRequestAttribute

Hinweise

Clients können den Content-MD5-Header für einen bestimmten Anfügeblockungsvorgang senden, um die Transaktionsintegrität über das Netzwerk sicherzustellen. Der contentMD5 Parameter ermöglicht Clients, die bereits Zugriff auf einen vorab berechneten MD5-Wert für einen bestimmten Bytebereich haben, diesen bereitzustellen. Wenn die BlobRequestOptions.UseTransactionalMd5 -Eigenschaft auf true und der contentMD5 Parameter auf nullfestgelegt ist, berechnet die Clientbibliothek den MD5-Wert intern.

Gilt für:

AppendBlockAsync(Uri, Int64, Int64, String, AccessCondition, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Committent einen neuen Datenblock an das Ende des Blobs.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<long> AppendBlockAsync (Uri sourceUri, long offset, long count, string sourceContentMd5, Microsoft.Azure.Storage.AccessCondition sourceAccessCondition, Microsoft.Azure.Storage.AccessCondition destAccessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
override this.AppendBlockAsync : Uri * int64 * int64 * string * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int64>
Public Overridable Function AppendBlockAsync (sourceUri As Uri, offset As Long, count As Long, sourceContentMd5 As String, sourceAccessCondition As AccessCondition, destAccessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of Long)

Parameter

sourceUri
Uri

Ein Uri , der den absoluten URI für das Quellblob angibt.

offset
Int64

Der Byteoffset in der Quelle, an dem mit dem Abrufen von Inhalten begonnen werden soll.

count
Int64

Die Anzahl der Bytes aus der Quelle, die zurückgegeben oder null alle Bytes bis zum Ende des Blobs zurückgegeben werden sollen.

sourceContentMd5
String

Ein optionaler Hashwert, der zum Festlegen der ContentMD5 Eigenschaft für das Blob verwendet wird. Kann oder eine leere Zeichenfolge sein null .

sourceAccessCondition
AccessCondition

Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Quellblob darstellt. Wenn null, wird keine Bedingung verwendet.

destAccessCondition
AccessCondition

Ein AccessCondition -Objekt, das die Zugriffsbedingungen für das Zielblob darstellt. Wenn null, wird keine Bedingung verwendet.

options
BlobRequestOptions

Ein BlobRequestOptions-Objekt, das zusätzliche Optionen für die Anforderung angibt.

operationContext
OperationContext

Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt.

cancellationToken
CancellationToken

Ein CancellationToken, das beim Warten auf den Abschluss einer Aufgabe überwacht werden soll.

Gibt zurück

Task<Int64>

Ein Task , der eine asynchrone Aktion darstellt.

Attribute
DoesServiceRequestAttribute

Gilt für: