CloudPageBlob.OpenWrite Método

Definição

Namespace:

Microsoft.Azure.Storage.Blob

Assembly:

Microsoft.Azure.Storage.Blob.dll

Pacote:

Microsoft.Azure.Storage.Blob v11.2.3

Abre 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.Blob.CloudBlobStream OpenWrite (long? size, Microsoft.Azure.Storage.AccessCondition accessCondition = default, Microsoft.Azure.Storage.Blob.BlobRequestOptions options = default, Microsoft.Azure.Storage.OperationContext operationContext = default);

[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member OpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> Microsoft.Azure.Storage.Blob.CloudBlobStream
override this.OpenWrite : Nullable<int64> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> Microsoft.Azure.Storage.Blob.CloudBlobStream

Public Overridable Function OpenWrite (size As Nullable(Of Long), Optional accessCondition As AccessCondition = Nothing, Optional options As BlobRequestOptions = Nothing, Optional operationContext As OperationContext = Nothing) As 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. Se null, as opções padrão serão aplicadas à solicitação.

operationContext

OperationContext

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

Retornos

CloudBlobStream

Um objeto CloudBlobStream.

Atributos

DoesServiceRequestAttribute

Comentários

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

Defina a StreamWriteSizeInBytes propriedade antes de chamar esse método para especificar o tamanho do bloco a ser gravado, em bytes, variando entre 16 KB 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().