PageBlobClient.CreateIfNotExists Méthode

Définition

Espace de noms:

Azure.Storage.Blobs.Specialized

Assembly:

Azure.Storage.Blobs.dll

Paquet:

Azure.Storage.Blobs v12.20.0

Source:

PageBlobClient.cs

L’opération CreateIfNotExists(Int64, PageBlobCreateOptions, CancellationToken) crée un objet blob de page du spécifié size. Si l’objet blob existe déjà, le contenu de l’objet blob existant reste inchangé. Si l’objet blob n’existe pas encore, un nouvel objet blob de page avec le spécifié size est créé. 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) Opération.

Pour plus d’informations, consultez 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)

Paramètres

size

Int64

Spécifie la taille maximale de l’objet blob de page, jusqu’à 8 To. La taille doit être alignée sur une limite de 512 octets.

options

PageBlobCreateOptions

Paramètres facultatifs.

cancellationToken

CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Response<BlobContentInfo>

Si l’objet blob de page n’existe pas encore, A Response<T> décrivant l’objet blob de page nouvellement créé. Sinon, null.

Remarques

Un RequestFailedException sera levée en cas d’échec.