CloudAppendBlob.BeginAppendFromStream Method (Stream, Int64, AsyncCallback, Object) (Microsoft.WindowsAzure.Storage.Blob)

Begins an asynchronous operation to append a stream 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

C#

Copy Code

 

[DoesServiceRequestAttribute]
public virtual ICancellableAsyncResult BeginAppendFromStream(
	Stream source,
	long length,
	AsyncCallback callback,
	object state
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual ICancellableAsyncResult^ BeginAppendFromStream(
	Stream^ source,
	long long length,
	AsyncCallback^ callback,
	Object^ state
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract BeginAppendFromStream : 
        source:Stream *
        length:int64 *
        callback:AsyncCallback *
        state:Object -> ICancellableAsyncResult
[<DoesServiceRequestAttribute>]
override BeginAppendFromStream : 
        source:Stream *
        length:int64 *
        callback:AsyncCallback *
        state:Object -> ICancellableAsyncResult

VB

Copy Code

 

<DoesServiceRequestAttribute>
Public Overridable Function BeginAppendFromStream (
	source As Stream,
	length As Long,
	callback As AsyncCallback,
	state As Object
) As ICancellableAsyncResult

Parameters

source

Type: System.IO.StreamSystem.IO::Stream^System.IO.StreamSystem.IO.Stream

A Stream object providing the blob content.

length

Type: System.Int64System::Int64System.Int64System.Int64

Specifies the number of bytes from the Stream source to upload from the start position.

callback

Type: System.AsyncCallbackSystem::AsyncCallback^System.AsyncCallbackSystem.AsyncCallback

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

state

Type: System.ObjectSystem::Object^System.ObjectSystem.Object

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

Return Value

Type: Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.WindowsAzure.Storage::ICancellableAsyncResult^Microsoft.WindowsAzure.Storage.ICancellableAsyncResultMicrosoft.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.

See Also

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

Return to top