Freigeben über


CloudPageBlob.BeginOpenWrite Methode

Definition

Überlädt

BeginOpenWrite(Nullable<Int64>, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Schreiben in das Blob zu öffnen. Wenn das Blob bereits vorhanden ist, werden vorhandene Daten im Blob möglicherweise überschrieben.

BeginOpenWrite(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Schreiben in das Blob zu öffnen. Wenn das Blob bereits vorhanden ist, werden vorhandene Daten im Blob möglicherweise überschrieben.

BeginOpenWrite(Nullable<Int64>, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Schreiben in das Blob zu öffnen. Wenn das Blob bereits vorhanden ist, werden vorhandene Daten im Blob möglicherweise überschrieben.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenWrite (long? size, AsyncCallback callback, object state);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member BeginOpenWrite : Nullable<int64> * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
override this.BeginOpenWrite : Nullable<int64> * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Overridable Function BeginOpenWrite (size As Nullable(Of Long), callback As AsyncCallback, state As Object) As ICancellableAsyncResult

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.

callback
AsyncCallback

Ein AsyncCallback Delegat, der nach Abschluss des asynchronen Vorgangs eine Benachrichtigung erhält.

state
Object

Ein benutzerdefiniertes Objekt, das an den Rückrufdelegat übergeben wird.

Gibt zurück

Eine ICancellableAsyncResult , die auf den asynchronen Vorgang verweist.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer einen Aufruf der BeginFetchAttributes(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) Methode unter den Abdeckungen ausgibt.

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

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

Gilt für:

BeginOpenWrite(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Schreiben in das Blob zu öffnen. Wenn das Blob bereits vorhanden ist, werden vorhandene Daten im Blob möglicherweise überschrieben.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenWrite (long? size, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, AsyncCallback callback, object state);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member BeginOpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
override this.BeginOpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Overridable Function BeginOpenWrite (size As Nullable(Of Long), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, callback As AsyncCallback, state As Object) As ICancellableAsyncResult

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.

callback
AsyncCallback

Ein AsyncCallback Delegat, der nach Abschluss des asynchronen Vorgangs eine Benachrichtigung erhält.

state
Object

Ein benutzerdefiniertes Objekt, das an den Rückrufdelegat übergeben wird.

Gibt zurück

Eine ICancellableAsyncResult , die auf den asynchronen Vorgang verweist.

Attribute

Hinweise

Beachten Sie, dass diese Methode immer einen Aufruf der BeginFetchAttributes(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) Methode unter den Abdeckungen ausgibt.

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

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

Gilt für: