CloudAppendBlob.AppendTextAsync Method (String, Encoding, AccessCondition, BlobRequestOptions, OperationContext) (Microsoft.WindowsAzure.Storage.Blob)

Initiates an asynchronous operation to append a string of text to an append blob. This API should be used strictly in a single writer scenario because the API internally uses the append-offset conditional header to avoid duplicate blocks which does not work in a multiple writer scenario.

Namespace:   Microsoft.WindowsAzure.Storage.Blob
Assembly:  Microsoft.WindowsAzure.Storage (in Microsoft.WindowsAzure.Storage.dll)

Syntax

C#

Copy Code

 

[DoesServiceRequestAttribute]
public virtual Task AppendTextAsync(
	string content,
	Encoding encoding,
	AccessCondition accessCondition,
	BlobRequestOptions options,
	OperationContext operationContext
)

C++

Copy Code

 

public:
[DoesServiceRequestAttribute]
virtual Task^ AppendTextAsync(
	String^ content,
	Encoding^ encoding,
	AccessCondition^ accessCondition,
	BlobRequestOptions^ options,
	OperationContext^ operationContext
)

F#

Copy Code

 

[<DoesServiceRequestAttribute>]
abstract AppendTextAsync : 
        content:string *
        encoding:Encoding *
        accessCondition:AccessCondition *
        options:BlobRequestOptions *
        operationContext:OperationContext -> Task
[<DoesServiceRequestAttribute>]
override AppendTextAsync : 
        content:string *
        encoding:Encoding *
        accessCondition:AccessCondition *
        options:BlobRequestOptions *
        operationContext:OperationContext -> Task

VB

Copy Code

 

<DoesServiceRequestAttribute>
Public Overridable Function AppendTextAsync (
	content As String,
	encoding As Encoding,
	accessCondition As AccessCondition,
	options As BlobRequestOptions,
	operationContext As OperationContext
) As Task

Parameters

content

Type: System.StringSystem::String^System.StringSystem.String

A string containing the text to upload.

encoding

Type: System.Text.EncodingSystem.Text::Encoding^System.Text.EncodingSystem.Text.Encoding

A Encoding object that indicates the text encoding to use. If null, UTF-8 will be used.

accessCondition

Type: Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage::AccessCondition^Microsoft.WindowsAzure.Storage.AccessConditionMicrosoft.WindowsAzure.Storage.AccessCondition

An AccessCondition object that represents the condition that must be met in order for the request to proceed.

options

Type: Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptionsMicrosoft.WindowsAzure.Storage.Blob::BlobRequestOptions^Microsoft.WindowsAzure.Storage.Blob.BlobRequestOptionsMicrosoft.WindowsAzure.Storage.Blob.BlobRequestOptions

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

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

If you have a single-writer scenario, see AbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetryAbsorbConditionalErrorsOnRetry to determine whether setting this flag to true is acceptable for your scenario.

See Also

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

Return to top