CloudFile.BeginWriteRange Method (Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, AsyncCallback, Object) (Microsoft.WindowsAzure.Storage.File)
From Microsoft Windows Azure Storage Blob
C#
C++
F#
VB
CloudFile.::..BeginWriteRange Method (Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, AsyncCallback, Object)(Stream^, Int64, String^, AccessCondition^, FileRequestOptions^, OperationContext^, AsyncCallback^, Object^)(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, AsyncCallback, Object)(Stream, Int64, String, AccessCondition, FileRequestOptions, OperationContext, AsyncCallback, Object)
Begins an asynchronous operation to write a range to a file.
Namespace:
Microsoft.WindowsAzure.Storage.File
Assembly:
Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute]
public virtual ICancellableAsyncResult BeginWriteRange(
Stream rangeData,
long startOffset,
string contentMD5,
AccessCondition accessCondition,
FileRequestOptions options,
OperationContext operationContext,
AsyncCallback callback,
object state
)
C++public:
[DoesServiceRequestAttribute]
virtual ICancellableAsyncResult^ BeginWriteRange(
Stream^ rangeData,
long long startOffset,
String^ contentMD5,
AccessCondition^ accessCondition,
FileRequestOptions^ options,
OperationContext^ operationContext,
AsyncCallback^ callback,
Object^ state
)
[<DoesServiceRequestAttribute>]
abstract BeginWriteRange :
rangeData:Stream *
startOffset:int64 *
contentMD5:string *
accessCondition:AccessCondition *
options:FileRequestOptions *
operationContext:OperationContext *
callback:AsyncCallback *
state:Object -> ICancellableAsyncResult
[<DoesServiceRequestAttribute>]
override BeginWriteRange :
rangeData:Stream *
startOffset:int64 *
contentMD5:string *
accessCondition:AccessCondition *
options:FileRequestOptions *
operationContext:OperationContext *
callback:AsyncCallback *
state:Object -> ICancellableAsyncResult
<DoesServiceRequestAttribute>
Public Overridable Function BeginWriteRange (
rangeData As Stream,
startOffset As Long,
contentMD5 As String,
accessCondition As AccessCondition,
options As FileRequestOptions,
operationContext As OperationContext,
callback As AsyncCallback,
state As Object
) As ICancellableAsyncResult
Parameters
- rangeData
-
Type:
System.IO.StreamSystem.IO::Stream^System.IO.StreamSystem.IO.Stream
A stream providing the data.
- startOffset
-
Type:
System.Int64System::Int64System.Int64System.Int64
The offset at which to begin writing, in bytes.
- contentMD5
-
Type:
System.StringSystem::String^System.StringSystem.String
An optional hash value that will be used to set the ContentMD5ContentMD5ContentMD5ContentMD5 property on the file. May be null or an empty string.
- accessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the access conditions for the file. If null, no condition is used.
- options
-
Type:
Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File::FileRequestOptions^Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File.FileRequestOptions
A FileRequestOptions object that specifies additional options for the request.
- operationContext
-
Type:
Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage::OperationContext^Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage.OperationContext
An OperationContext object that represents the context for the current operation.
- callback
-
Type:
System.AsyncCallbackSystem::AsyncCallback^System.AsyncCallbackSystem.AsyncCallback
The callback 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.ICancellableAsyncResultAn ICancellableAsyncResult that references the asynchronous operation.
Return to top
Begins an asynchronous operation to write a range to a file.
Syntax
[DoesServiceRequestAttribute] public virtual ICancellableAsyncResult BeginWriteRange( Stream rangeData, long startOffset, string contentMD5, AccessCondition accessCondition, FileRequestOptions options, OperationContext operationContext, AsyncCallback callback, object state )
C++
public: [DoesServiceRequestAttribute] virtual ICancellableAsyncResult^ BeginWriteRange( Stream^ rangeData, long long startOffset, String^ contentMD5, AccessCondition^ accessCondition, FileRequestOptions^ options, OperationContext^ operationContext, AsyncCallback^ callback, Object^ state )
[<DoesServiceRequestAttribute>] abstract BeginWriteRange : rangeData:Stream * startOffset:int64 * contentMD5:string * accessCondition:AccessCondition * options:FileRequestOptions * operationContext:OperationContext * callback:AsyncCallback * state:Object -> ICancellableAsyncResult [<DoesServiceRequestAttribute>] override BeginWriteRange : rangeData:Stream * startOffset:int64 * contentMD5:string * accessCondition:AccessCondition * options:FileRequestOptions * operationContext:OperationContext * callback:AsyncCallback * state:Object -> ICancellableAsyncResult
<DoesServiceRequestAttribute> Public Overridable Function BeginWriteRange ( rangeData As Stream, startOffset As Long, contentMD5 As String, accessCondition As AccessCondition, options As FileRequestOptions, operationContext As OperationContext, callback As AsyncCallback, state As Object ) As ICancellableAsyncResult
Parameters
- rangeData
-
Type:
System.IO.StreamSystem.IO::Stream^System.IO.StreamSystem.IO.Stream
A stream providing the data.
- startOffset
-
Type:
System.Int64System::Int64System.Int64System.Int64
The offset at which to begin writing, in bytes.
- contentMD5
-
Type:
System.StringSystem::String^System.StringSystem.String
An optional hash value that will be used to set the ContentMD5ContentMD5ContentMD5ContentMD5 property on the file. May be null or an empty string.
- accessCondition
-
Type:
Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition
An AccessCondition object that represents the access conditions for the file. If null, no condition is used.
- options
-
Type:
Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File::FileRequestOptions^Microsoft.WindowsAzure.Storage.File.FileRequestOptionsMicrosoft.WindowsAzure.Storage.File.FileRequestOptions
A FileRequestOptions object that specifies additional options for the request.
- operationContext
-
Type:
Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage::OperationContext^Microsoft.WindowsAzure.Storage.OperationContextMicrosoft.WindowsAzure.Storage.OperationContext
An OperationContext object that represents the context for the current operation.
- callback
-
Type:
System.AsyncCallbackSystem::AsyncCallback^System.AsyncCallbackSystem.AsyncCallback
The callback 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.ICancellableAsyncResultAn ICancellableAsyncResult that references the asynchronous operation.