PageBlobClient.CreateIfNotExists Método

Referência

Definição

Namespace:: Azure.Storage.Blobs.Specialized

Assembly:: Azure.Storage.Blobs.dll

Pacote:: Azure.Storage.Blobs v12.20.0

Pacote:: Azure.Storage.Blobs v12.21.0-beta.1

Origem:: PageBlobClient.cs

Origem:: PageBlobClient.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A CreateIfNotExists(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 Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo> CreateIfNotExists (long size, Azure.Storage.Blobs.Models.PageBlobCreateOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateIfNotExists : int64 * Azure.Storage.Blobs.Models.PageBlobCreateOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>
override this.CreateIfNotExists : int64 * Azure.Storage.Blobs.Models.PageBlobCreateOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>

Public Overridable Function CreateIfNotExists (size As Long, options As PageBlobCreateOptions, Optional cancellationToken As CancellationToken = Nothing) As 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

Response<BlobContentInfo>

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

Partilhar via