CloudAppendBlob.UploadTextAsync Method (String, CancellationToken) (Microsoft.WindowsAzure.Storage.Blob)
From Microsoft Windows Azure Storage Blob
Initiates an asynchronous operation to upload a string of text to an append blob. If the blob already exists, it will be overwritten. Recommended only for single-writer scenarios.
Namespace:
Microsoft.WindowsAzure.Storage.Blob
Assembly:
Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)
Syntax
[DoesServiceRequestAttribute]
public virtual Task UploadTextAsync(
string content,
CancellationToken cancellationToken
)
C++public:
[DoesServiceRequestAttribute]
virtual Task^ UploadTextAsync(
String^ content,
CancellationToken cancellationToken
)
[<DoesServiceRequestAttribute>]
abstract UploadTextAsync :
content:string *
cancellationToken:CancellationToken -> Task
[<DoesServiceRequestAttribute>]
override UploadTextAsync :
content:string *
cancellationToken:CancellationToken -> Task
<DoesServiceRequestAttribute>
Public Overridable Function UploadTextAsync (
content As String,
cancellationToken As CancellationToken
) As Task
Parameters
- content
-
Type:
System.StringSystem::String^System.StringSystem.String
A string containing the text to upload.
- 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.
If you have a single-writer scenario, see AbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetry to determine whether setting this flag to true is acceptable for your scenario.
To append data to an append blob that already exists, see AppendTextAsync.
Return to top
Initiates an asynchronous operation to upload a string of text to an append blob. If the blob already exists, it will be overwritten. Recommended only for single-writer scenarios.
Syntax
[DoesServiceRequestAttribute] public virtual Task UploadTextAsync( string content, CancellationToken cancellationToken )
public: [DoesServiceRequestAttribute] virtual Task^ UploadTextAsync( String^ content, CancellationToken cancellationToken )
[<DoesServiceRequestAttribute>] abstract UploadTextAsync : content:string * cancellationToken:CancellationToken -> Task [<DoesServiceRequestAttribute>] override UploadTextAsync : content:string * cancellationToken:CancellationToken -> Task
<DoesServiceRequestAttribute> Public Overridable Function UploadTextAsync ( content As String, cancellationToken As CancellationToken ) As Task
Parameters
- content
-
Type:
System.StringSystem::String^System.StringSystem.String
A string containing the text to upload.
- 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. If you have a single-writer scenario, see AbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetry to determine whether setting this flag to true is acceptable for your scenario. To append data to an append blob that already exists, see AppendTextAsync.