Freigeben über


ICloudBlob.BeginOpenRead Methode

Definition

Überlädt

BeginOpenRead(AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Lesen aus dem Blob zu öffnen.

BeginOpenRead(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Lesen aus dem Blob zu öffnen.

BeginOpenRead(AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Lesen aus dem Blob zu öffnen.

public Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenRead (AsyncCallback callback, object state);
abstract member BeginOpenRead : AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Function BeginOpenRead (callback As AsyncCallback, state As Object) As ICancellableAsyncResult

Parameter

callback
AsyncCallback

Ein AsyncCallback Delegat, der eine Benachrichtigung erhält, wenn der asynchrone Vorgang abgeschlossen ist.

state
Object

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

Gibt zurück

Ein ICancellableAsyncResult , der auf den asynchronen Vorgang verweist.

Hinweise

Für das Stream von der EndOpenRead(IAsyncResult) -Methode zurückgegebene Objekt muss die EndRead(IAsyncResult) Methode für jeden BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Aufruf genau einmal aufgerufen werden. Wenn sie den Lesevorgang nicht beenden, bevor ein anderer Lesevorgang gestartet wird, kann dies zu unerwartetem Verhalten führen.

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

Legen Sie die StreamMinimumReadSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die mindestanzahl von Bytes anzugeben, die beim Lesen aus dem Stream gepuffert werden soll. Der Wert muss mindestens 16 KB betragen.

Gilt für:

BeginOpenRead(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)

Startet einen asynchronen Vorgang, um einen Stream zum Lesen aus dem Blob zu öffnen.

public Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenRead (Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, AsyncCallback callback, object state);
abstract member BeginOpenRead : Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Function BeginOpenRead (accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, callback As AsyncCallback, state As Object) As ICancellableAsyncResult

Parameter

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 eine Benachrichtigung erhält, wenn der asynchrone Vorgang abgeschlossen ist.

state
Object

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

Gibt zurück

Ein ICancellableAsyncResult , der auf den asynchronen Vorgang verweist.

Hinweise

Für das Stream von der EndOpenRead(IAsyncResult) -Methode zurückgegebene Objekt muss die EndRead(IAsyncResult) Methode für jeden BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) Aufruf genau einmal aufgerufen werden. Wenn sie den Lesevorgang nicht beenden, bevor ein anderer Lesevorgang gestartet wird, kann dies zu unerwartetem Verhalten führen.

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

Legen Sie die StreamMinimumReadSizeInBytes -Eigenschaft vor dem Aufrufen dieser Methode fest, um die mindestanzahl von Bytes anzugeben, die beim Lesen aus dem Stream gepuffert werden soll. Der Wert muss mindestens 16 KB betragen.

Gilt für: