CloudPageBlob.CreateAsync Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) |
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, pass in an AccessCondition object generated using GenerateIfNotExistsCondition(). |
| CreateAsync(Int64) |
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, use CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext). |
| CreateAsync(Int64, CancellationToken) |
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, use CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken). |
| CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext) |
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, pass in an AccessCondition object generated using GenerateIfNotExistsCondition(). |
| CreateAsync(Int64, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken) |
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, pass in an AccessCondition object generated using GenerateIfNotExistsCondition(). |
CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, pass in an AccessCondition object generated using GenerateIfNotExistsCondition().
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task CreateAsync (long size, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateAsync : int64 * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateAsync : int64 * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function CreateAsync (size As Long, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As TaskParameters
- size
- Int64
The maximum size of the blob, in bytes.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
CreateAsync(Int64)
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, use CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext).
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task CreateAsync (long size);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateAsync : int64 -> System.Threading.Tasks.Task
override this.CreateAsync : int64 -> System.Threading.Tasks.TaskPublic Overridable Function CreateAsync (size As Long) As TaskParameters
- size
- Int64
The maximum size of the blob, in bytes.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
CreateAsync(Int64, CancellationToken)
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, use CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken).
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task CreateAsync (long size, System.Threading.CancellationToken cancellationToken);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateAsync : int64 * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateAsync : int64 * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function CreateAsync (size As Long, cancellationToken As CancellationToken) As TaskParameters
- size
- Int64
The maximum size of the blob, in bytes.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
CreateAsync(Int64, AccessCondition, BlobRequestOptions, OperationContext)
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, pass in an AccessCondition object generated using GenerateIfNotExistsCondition().
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task CreateAsync (long size, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateAsync : int64 * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.Task
override this.CreateAsync : int64 * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext -> System.Threading.Tasks.TaskPublic Overridable Function CreateAsync (size As Long, accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext) As TaskParameters
- size
- Int64
The maximum size of the blob, in bytes.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
CreateAsync(Int64, Nullable<PremiumPageBlobTier>, AccessCondition, BlobRequestOptions, OperationContext, CancellationToken)
Initiates an asynchronous operation to create a page blob. If the blob already exists, this operation will overwrite it. To throw an exception if the blob exists, instead of overwriting, pass in an AccessCondition object generated using GenerateIfNotExistsCondition().
[Microsoft.Azure.Storage.DoesServiceRequest]
public virtual System.Threading.Tasks.Task CreateAsync (long size, Microsoft.Azure.Storage.Blob.PremiumPageBlobTier? premiumPageBlobTier, Microsoft.Azure.Storage.AccessCondition accessCondition, Microsoft.Azure.Storage.Blob.BlobRequestOptions options, Microsoft.Azure.Storage.OperationContext operationContext, System.Threading.CancellationToken cancellationToken);[<Microsoft.Azure.Storage.DoesServiceRequest>]
abstract member CreateAsync : int64 * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.CreateAsync : int64 * Nullable<Microsoft.Azure.Storage.Blob.PremiumPageBlobTier> * Microsoft.Azure.Storage.AccessCondition * Microsoft.Azure.Storage.Blob.BlobRequestOptions * Microsoft.Azure.Storage.OperationContext * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function CreateAsync (size As Long, premiumPageBlobTier As Nullable(Of PremiumPageBlobTier), accessCondition As AccessCondition, options As BlobRequestOptions, operationContext As OperationContext, cancellationToken As CancellationToken) As TaskParameters
- size
- Int64
The maximum size of the blob, in bytes.
- premiumPageBlobTier
- Nullable<PremiumPageBlobTier>
A PremiumPageBlobTier representing the tier to set.
- accessCondition
- AccessCondition
An AccessCondition object that represents the condition that must be met in order for the request to proceed. If null, no condition is used.
- options
- BlobRequestOptions
A BlobRequestOptions object that specifies additional options for the request.
- operationContext
- OperationContext
An OperationContext object that represents the context for the current operation.
- cancellationToken
- CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Returns
A Task object that represents the asynchronous operation.
- Attributes
Applies to
Azure SDK for .NET
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for