CloudPageBlob.BeginOpenWrite Método

Definição

Namespace:

Microsoft.Azure.Storage.Blob

Assembly:

Microsoft.Azure.Storage.Blob.dll

Pacote:

Microsoft.Azure.Storage.Blob v11.2.3

Sobrecargas

BeginOpenWrite(Nullable<Int64>, AsyncCallback, Object)	Inicia uma operação assíncrona para abrir um fluxo para gravação no blob. Se o blob já existir, os dados existentes no blob poderão ser substituídos.
BeginOpenWrite(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object)	Inicia uma operação assíncrona para abrir um fluxo para gravação no blob. Se o blob já existir, os dados existentes no blob poderão ser substituídos.

BeginOpenWrite(Nullable<Int64>, AsyncCallback, Object)

Inicia uma operação assíncrona para abrir um fluxo para gravação no blob. Se o blob já existir, os dados existentes no blob poderão ser substituídos.

[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

Parâmetros

size

Nullable<Int64>

O tamanho do blob de páginas, em bytes. O tamanho deve ser um múltiplo de 512. Se null, o blob de páginas já deverá existir.

callback

AsyncCallback

Um AsyncCallback delegado que receberá uma notificação quando a operação assíncrona for concluída.

state

Object

Um objeto definido pelo usuário que será passado para o delegado de retorno de chamada.

Retornos

ICancellableAsyncResult

Um ICancellableAsyncResult que faz referência à operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o BeginFetchAttributes(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) método nos covers.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravada, em múltiplos de 512 bytes, variando entre 512 e 4 MB, inclusive.

Para gerar uma exceção se o blob existir em vez de substituí-lo, consulte BeginOpenWrite(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object).

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

Inicia uma operação assíncrona para abrir um fluxo para gravação no blob. Se o blob já existir, os dados existentes no blob poderão ser substituídos.

[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

Parâmetros

size

Nullable<Int64>

O tamanho do blob de páginas, em bytes. O tamanho deve ser um múltiplo de 512. Se null, o blob de páginas já deverá existir.

accessCondition

AccessCondition

Um objeto AccessCondition que representa a condição que deve ser atendida para que a solicitação continue. Se for null, nenhuma condição é usada.

options

BlobRequestOptions

Um objeto BlobRequestOptions que especifica opções adicionais para a solicitação.

operationContext

OperationContext

Um objeto OperationContext que representa o contexto da operação atual.

callback

AsyncCallback

Um AsyncCallback delegado que receberá uma notificação quando a operação assíncrona for concluída.

state

Object

Um objeto definido pelo usuário que será passado para o delegado de retorno de chamada.

Retornos

ICancellableAsyncResult

Um ICancellableAsyncResult que faz referência à operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o BeginFetchAttributes(AccessCondition, BlobRequestOptions, OperationContext, AsyncCallback, Object) método nos covers.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravada, em múltiplos de 512 bytes, variando entre 512 e 4 MB, inclusive.

Para gerar uma exceção se o blob existir em vez de substituí-lo, passe um AccessCondition objeto gerado usando GenerateIfNotExistsCondition().