Freigeben über


CloudPageBlob.OpenWriteAsync Methode

Definition

Überlädt

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

OpenWriteAsync(Nullable<Int64>, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

OpenWriteAsync(Nullable<Int64>)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

OpenWriteAsync(Nullable<Int64>, CancellationToken)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As Task(Of CloudBlobStream)

Parameter

size
Nullable<Int64>

Die Größe des Seitenblobs in Bytes. Die Größe muss ein Vielfaches von 512 sein. Wenn null, muss das Seitenblob bereits vorhanden sein.

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

Ein Task<TResult>-Objekt vom Typ CloudBlobStream, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer im Cover einen Aufruf der FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) -Methode ausgibt.

Legen Sie die StreamWriteSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die zu schreibende Seitengröße in Vielfachen von 512 Byte anzugeben, die zwischen 512 und 4 MB einschließlich reicht.

Um eine Ausnahme auszulösen, wenn das Blob vorhanden ist, anstatt es zu überschreiben, übergeben Sie ein AccessCondition Objekt, das mit GenerateIfNotExistsCondition()generiert wird.

Gilt für:

OpenWriteAsync(Nullable<Int64>, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, Microsoft.Azure.Storage.Blob.PremiumPageBlobTier? premiumPageBlobTier, 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 OpenWriteAsync : Nullable<int64> * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), premiumPageBlobTier As Nullable(Of PremiumPageBlobTier), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of CloudBlobStream)

Parameter

size
Nullable<Int64>

Die Größe des Seitenblobs in Bytes. Die Größe muss ein Vielfaches von 512 sein. Wenn null, muss das Seitenblob bereits vorhanden sein.

premiumPageBlobTier
Nullable<PremiumPageBlobTier>

Ein PremiumPageBlobTier , der die festzulegende Ebene darstellt.

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

Ein Task<TResult>-Objekt vom Typ CloudBlobStream, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer im Cover einen Aufruf der FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) -Methode ausgibt.

Legen Sie die StreamWriteSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die zu schreibende Seitengröße in Vielfachen von 512 Byte anzugeben, die zwischen 512 und 4 MB einschließlich reicht.

Um eine Ausnahme auszulösen, wenn das Blob vorhanden ist, anstatt es zu überschreiben, übergeben Sie ein AccessCondition Objekt, das mit GenerateIfNotExistsCondition()generiert wird.

Gilt für:

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, 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 OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As Task(Of CloudBlobStream)

Parameter

size
Nullable<Int64>

Die Größe des Seitenblobs in Bytes. Die Größe muss ein Vielfaches von 512 sein. Wenn null, muss das Seitenblob bereits vorhanden sein.

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

Ein Task<TResult>-Objekt vom Typ CloudBlobStream, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer im Cover einen Aufruf der FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) -Methode ausgibt.

Legen Sie die StreamWriteSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die zu schreibende Seitengröße in Vielfachen von 512 Byte anzugeben, die zwischen 512 und 4 MB einschließlich reicht.

Um eine Ausnahme auszulösen, wenn das Blob vorhanden ist, anstatt es zu überschreiben, übergeben Sie ein AccessCondition Objekt, das mit GenerateIfNotExistsCondition()generiert wird.

Gilt für:

OpenWriteAsync(Nullable<Int64>)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : Nullable<int64> -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
Public Overridable Function OpenWriteAsync (size As Nullable(Of Long)) As Task(Of CloudBlobStream)

Parameter

size
Nullable<Int64>

Die Größe des Seitenblobs in Bytes. Die Größe muss ein Vielfaches von 512 sein. Wenn null, muss das Seitenblob bereits vorhanden sein.

Gibt zurück

Ein Task<TResult>-Objekt vom Typ CloudBlobStream, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer im Cover einen Aufruf der FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) -Methode ausgibt.

Legen Sie die StreamWriteSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die zu schreibende Seitengröße in Vielfachen von 512 Byte anzugeben, die zwischen 512 und 4 MB einschließlich reicht.

Informationen zum Auslösen einer Ausnahme, wenn das Blob vorhanden ist, anstatt es zu überschreiben, finden Sie unter OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext).

Gilt für:

OpenWriteAsync(Nullable<Int64>, CancellationToken)

Initiiert einen asynchronen Vorgang zum Öffnen eines Datenstroms, um Daten in das Blob zu schreiben. Wenn das Blob bereits vorhanden ist, können vorhandene Daten im Blob überschrieben werden.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream> OpenWriteAsync (long? size, System.Threading.CancellationToken cancellationToken);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWriteAsync : Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
override this.OpenWriteAsync : Nullable<int64> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Storage.Blob.CloudBlobStream>
Public Overridable Function OpenWriteAsync (size As Nullable(Of Long), cancellationToken As CancellationToken) As Task(Of CloudBlobStream)

Parameter

size
Nullable<Int64>

Die Größe des Seitenblobs in Bytes. Die Größe muss ein Vielfaches von 512 sein. Wenn null, muss das Seitenblob bereits vorhanden sein.

cancellationToken
CancellationToken

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

Gibt zurück

Ein Task<TResult>-Objekt vom Typ CloudBlobStream, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer im Cover einen Aufruf der FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) -Methode ausgibt.

Legen Sie die StreamWriteSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die zu schreibende Seitengröße in Vielfachen von 512 Byte anzugeben, die zwischen 512 und 4 MB einschließlich reicht.

Informationen zum Auslösen einer Ausnahme, wenn das Blob vorhanden ist, anstatt es zu überschreiben, finden Sie unter OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken).

Gilt für: