你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
PageBlobClient.CreateIfNotExistsAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
操作 CreateIfNotExistsAsync(Int64, PageBlobCreateOptions, CancellationToken) 创建指定 size
的新页 Blob。 如果 Blob 已存在,现有 Blob 的内容将保持不变。 如果 Blob 尚不存在,将创建具有指定 size
的新页 Blob。
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) 操作。
有关详细信息,请参阅 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))
参数
- size
- Int64
指定页 Blob 的最大大小,最大为 8 TB。 大小必须与 512 字节边界对齐。
- options
- PageBlobCreateOptions
可选参数。
- cancellationToken
- CancellationToken
可选 CancellationToken ,用于传播应取消操作的通知。
返回
如果页 Blob 尚不存在,则为 描述 Response<T> 新创建的页 Blob 的 。 否则为 null
。
注解
RequestFailedException如果失败,将引发 。