CloudAppendBlob.UploadFromFileAsync Method (String, FileMode, AccessCondition, BlobRequestOptions, OperationContext)

Article
11/01/2015
2 minutes to read

Initiates an asynchronous operation to upload a file to an append blob. If the blob already exists, it will be overwritten. Recommended only for single-writer scenarios.

Namespace: Microsoft.WindowsAzure.Storage.Blob
Assembly: Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)

Syntax

[DoesServiceRequestAttribute]
public Task UploadFromFileAsync(
    string path,
    FileMode mode,
    AccessCondition accessCondition,
    BlobRequestOptions options,
    OperationContext operationContext
)

<DoesServiceRequestAttribute>
Public Function UploadFromFileAsync (
    path As String,
    mode As FileMode,
    accessCondition As AccessCondition,
    options As BlobRequestOptions,
    operationContext As OperationContext
) As Task

Parameters

path
Type: System.String

A string containing the file path providing the blob content.

mode
Type: System.IO.FileMode

A FileMode enumeration value that specifies how to open the file.

accessCondition
Type: Microsoft.WindowsAzure.Storage.AccessCondition

An AccessCondition object that represents the condition that must be met in order for the request to proceed.

options
Type: Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptions

A BlobRequestOptions object that specifies additional options for the request.

operationContext
Type: Microsoft.WindowsAzure.Storage.OperationContext

An OperationContext object that represents the context for the current operation.

Return Value

Type: System.Threading.Tasks.Task

A Task object that represents the asynchronous operation.

Implements

ICloudBlob.UploadFromFileAsync(String, FileMode, AccessCondition, BlobRequestOptions, OperationContext)

Remarks

Use this method only in single-writer scenarios. Internally, this method uses the append-offset conditional header to avoid duplicate blocks, which may cause problems in multiple-writer scenarios. If you have a single-writer scenario, see AbsorbConditionalErrorsOnRetry to determine whether setting this flag to true is acceptable for your scenario. To append data to an append blob that already exists, see AppendFromFileAsync.