CloudPageBlob.OpenWriteAsync Método

Definição

Namespace:

Microsoft.Azure.Storage.Blob

Assembly:

Microsoft.Azure.Storage.Blob.dll

Pacote:

Microsoft.Azure.Storage.Blob v11.2.3

Sobrecargas

OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext)	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.
OpenWriteAsync(Nullable<Int64>, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	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.
OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)	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.
OpenWriteAsync(Nullable<Int64>)	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.
OpenWriteAsync(Nullable<Int64>, CancellationToken)	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.

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

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 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)

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ágina já deve 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.

Retornos

Task<CloudBlobStream>

Um objeto Task<TResult> do tipo CloudBlobStream que representa a operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) método sob as capas.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravado, 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().

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

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 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)

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ágina já deve existir.

premiumPageBlobTier

Nullable<PremiumPageBlobTier>

Um PremiumPageBlobTier que representa a camada a ser definida.

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.

cancellationToken

CancellationToken

Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.

Retornos

Task<CloudBlobStream>

Um objeto Task<TResult> do tipo CloudBlobStream que representa a operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) método sob as capas.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravado, 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().

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

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 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)

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ágina já deve 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.

cancellationToken

CancellationToken

Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.

Retornos

Task<CloudBlobStream>

Um objeto Task<TResult> do tipo CloudBlobStream que representa a operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) método sob as capas.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravado, 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().

OpenWriteAsync(Nullable<Int64>)

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 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)

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ágina já deve existir.

Retornos

Task<CloudBlobStream>

Um objeto Task<TResult> do tipo CloudBlobStream que representa a operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) método sob as capas.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravado, 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 OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext).

OpenWriteAsync(Nullable<Int64>, CancellationToken)

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 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)

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ágina já deve existir.

cancellationToken

CancellationToken

Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.

Retornos

Task<CloudBlobStream>

Um objeto Task<TResult> do tipo CloudBlobStream que representa a operação assíncrona.

Atributos

DoesServiceRequestAttribute

Comentários

Observe que esse método sempre faz uma chamada para o FetchAttributesAsync(AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) método sob as capas.

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho da página a ser gravado, 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 OpenWriteAsync(Nullable<Int64>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken).