CloudAppendBlob.BeginAppendFromFile Method (String, FileMode, AsyncCallback, Object)

Begins 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 ICancellableAsyncResult BeginAppendFromFile(
    string path,
    FileMode mode,
    AsyncCallback callback,
    object state
)

<DoesServiceRequestAttribute>
Public Function BeginAppendFromFile (
    path As String,
    mode As FileMode,
    callback As AsyncCallback,
    state As Object
) As ICancellableAsyncResult

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.

• callback
  Type: System.AsyncCallback

  An AsyncCallback delegate that will receive notification when the asynchronous operation completes.

• state
  Type: System.Object

  A user-defined object that will be passed to the callback delegate.

Return Value

Type: Microsoft.WindowsAzure.Storage.ICancellableAsyncResult

An ICancellableAsyncResult that references 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

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

Return to top