Initiates an asynchronous operation to append a stream to an append blob. Recommended only for single-writer scenarios.
Assembly: Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute] public virtual Task AppendFromStreamAsync( Stream source, long length, CancellationToken cancellationToken )
public: [DoesServiceRequestAttribute] virtual Task^ AppendFromStreamAsync( Stream^ source, long long length, CancellationToken cancellationToken )
[<DoesServiceRequestAttribute>] abstract AppendFromStreamAsync : source:Stream * length:int64 * cancellationToken:CancellationToken -> Task [<DoesServiceRequestAttribute>] override AppendFromStreamAsync : source:Stream * length:int64 * cancellationToken:CancellationToken -> Task
<DoesServiceRequestAttribute> Public Overridable Function AppendFromStreamAsync ( source As Stream, length As Long, cancellationToken As CancellationToken ) As Task
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
The number of bytes to write from the source stream at its current position.
- cancellationToken
-
Type:
System.Threading.CancellationTokenSystem.Threading::CancellationTokenSystem.Threading.CancellationTokenSystem.Threading.CancellationToken
A CancellationToken to observe while waiting for a task to complete.
Return Value
Type: System.Threading.Tasks.TaskSystem.Threading.Tasks::Task^System.Threading.Tasks.TaskSystem.Threading.Tasks.TaskA 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.
See Also
AppendFromStreamAsync Overload
CloudAppendBlob Class
Microsoft.WindowsAzure.Storage.Blob Namespace