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

Initiates an asynchronous operation to append a file to an append blob. Recommended only for single-writer scenarios.

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

Syntax

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

<DoesServiceRequestAttribute>
Public Function AppendFromFileAsync (
    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.

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.

See Also

AppendFromFileAsync Overload
CloudAppendBlob Class
Microsoft.WindowsAzure.Storage.Blob Namespace

Return to top