Storage Client Library for Windows Phone (Version 7.0)

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

C#

Copy Code

 

[DoesServiceRequestAttribute]
public virtual Task UploadTextAsync(
	string content,
	CancellationToken cancellationToken
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual Task^ UploadTextAsync(
	String^ content,
	CancellationToken cancellationToken
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract UploadTextAsync : 
        content:string *
        cancellationToken:CancellationToken -> Task
[<DoesServiceRequestAttribute>]
override UploadTextAsync : 
        content:string *
        cancellationToken:CancellationToken -> Task

VB

Copy Code

 

<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.Task

A 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.

See Also

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

Return to top