Compartilhar via


PageBlobClient.CreateIfNotExistsAsync Método

Definição

A CreateIfNotExistsAsync(Int64, PageBlobCreateOptions, CancellationToken) operação cria um novo blob de páginas do especificado size. Se o blob já existir, o conteúdo do blob existente permanecerá inalterado. Se o blob ainda não existir, um novo blob de páginas com o especificado size será criado. Azure.Storage.Blobs.Specialized.PageBlobClient.UploadPages(System.IO.Stream,System.Int64,System.Byte[],Azure.Storage.Blobs.Models.PageBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) Operação.

Para obter mais informações, consulte https://docs.microsoft.com/rest/api/storageservices/put-blob.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>> CreateIfNotExistsAsync (long size, Azure.Storage.Blobs.Models.PageBlobCreateOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateIfNotExistsAsync : int64 * Azure.Storage.Blobs.Models.PageBlobCreateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>
override this.CreateIfNotExistsAsync : int64 * Azure.Storage.Blobs.Models.PageBlobCreateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>
Public Overridable Function CreateIfNotExistsAsync (size As Long, options As PageBlobCreateOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobContentInfo))

Parâmetros

size
Int64

Especifica o tamanho máximo para o blob de página, até 8 TB. O tamanho deve ser alinhado a um limite de 512 bytes.

options
PageBlobCreateOptions

Parâmetros opcionais.

cancellationToken
CancellationToken

Opcional CancellationToken para propagar notificações de que a operação deve ser cancelada.

Retornos

Se o blob de páginas ainda não existir, A Response<T> descrevendo o blob de página recém-criado. Caso contrário, null.

Comentários

Um RequestFailedException será gerado se ocorrer uma falha.

Aplica-se a