Freigeben über


CloudBlob.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.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual Microsoft.Azure.Storage.ICancellableAsyncResult BeginOpenRead (AsyncCallback callback, object state);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member BeginOpenRead : AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
override this.BeginOpenRead : AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Overridable Function BeginOpenRead (callback As AsyncCallback, state As Object) As ICancellableAsyncResult

Parameter

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

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 der Lesevorgang nicht beendet wird, bevor ein weiterer Lesevorgang beginnt, kann dies zu unerwartetem Verhalten führen.

Beachten Sie, dass diese Methode immer einen Aufruf der BeginFetchAttributes(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) Methode unter den Abdeckungen 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 sollen. 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.

[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual 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);
[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member BeginOpenRead : Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
override this.BeginOpenRead : Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * AsyncCallback * obj -> Microsoft.Azure.Storage.ICancellableAsyncResult
Public Overridable 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 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

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 der Lesevorgang nicht beendet wird, bevor ein weiterer Lesevorgang beginnt, kann dies zu unerwartetem Verhalten führen.

Beachten Sie, dass diese Methode immer einen Aufruf der BeginFetchAttributes(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) Methode unter den Abdeckungen 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 sollen. Der Wert muss mindestens 16 KB betragen.

Gilt für: