BlobContainerClient.UploadBlobAsync 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
| UploadBlobAsync(String, BinaryData, CancellationToken) |
The UploadBlobAsync(String, BinaryData, CancellationToken) operation creates a new block blob. For partial block blob updates and other advanced features, please see BlockBlobClient. To create or modify page or append blobs, please see PageBlobClient or AppendBlobClient. For more information, see Put Blob. |
| UploadBlobAsync(String, Stream, CancellationToken) |
The UploadBlobAsync(String, Stream, CancellationToken) operation creates a new block blob. For partial block blob updates and other advanced features, please see BlockBlobClient. To create or modify page or append blobs, please see PageBlobClient or AppendBlobClient. For more information, see Put Blob. |
UploadBlobAsync(String, BinaryData, CancellationToken)
- Source:
- BlobContainerClient.cs
- Source:
- BlobContainerClient.cs
The UploadBlobAsync(String, BinaryData, CancellationToken) operation creates a new block blob.
For partial block blob updates and other advanced features, please see BlockBlobClient. To create or modify page or append blobs, please see PageBlobClient or AppendBlobClient.
For more information, see Put Blob.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>> UploadBlobAsync(string blobName, BinaryData content, System.Threading.CancellationToken cancellationToken = default);abstract member UploadBlobAsync : string * BinaryData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>
override this.UploadBlobAsync : string * BinaryData * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>Public Overridable Function UploadBlobAsync (blobName As String, content As BinaryData, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobContentInfo))Parameters
- blobName
- String
The name of the blob to upload.
- content
- BinaryData
A BinaryData containing the content to upload.
- cancellationToken
- CancellationToken
Optional CancellationToken to propagate notifications that the operation should be cancelled.
Returns
A Response<T> describing the state of the updated block blob.
Remarks
A RequestFailedException will be thrown if the blob already exists. To overwrite an existing block blob, get a BlobClient by calling GetBlobClient(String), and then call Upload(Stream, Boolean, CancellationToken) with the override parameter set to true. If multiple failures occur, an AggregateException will be thrown, containing each failure instance.
Applies to
UploadBlobAsync(String, Stream, CancellationToken)
- Source:
- BlobContainerClient.cs
- Source:
- BlobContainerClient.cs
The UploadBlobAsync(String, Stream, CancellationToken) operation creates a new block blob.
For partial block blob updates and other advanced features, please see BlockBlobClient. To create or modify page or append blobs, please see PageBlobClient or AppendBlobClient.
For more information, see Put Blob.
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>> UploadBlobAsync(string blobName, System.IO.Stream content, System.Threading.CancellationToken cancellationToken = default);abstract member UploadBlobAsync : string * System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>
override this.UploadBlobAsync : string * System.IO.Stream * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Blobs.Models.BlobContentInfo>>Public Overridable Function UploadBlobAsync (blobName As String, content As Stream, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of BlobContentInfo))Parameters
- blobName
- String
The name of the blob to upload.
- cancellationToken
- CancellationToken
Optional CancellationToken to propagate notifications that the operation should be cancelled.
Returns
A Response<T> describing the state of the updated block blob.
Remarks
A RequestFailedException will be thrown if the blob already exists. To overwrite an existing block blob, get a BlobClient by calling GetBlobClient(String), and then call Upload(Stream, Boolean, CancellationToken) with the override parameter set to true. If multiple failures occur, an AggregateException will be thrown, containing each failure instance.
