SALES: 1-800-867-1380

CloudBlob.UploadText Method (String, Encoding, BlobRequestOptions)

Updated: April 24, 2013

[This topic is part of the Windows Azure Storage Client Library 1.7, which has been deprecated. The current recommended version is Storage Client Library 3.0.]

Uploads a string of text to a block blob, with the specified encoding, and using a conditional request based on the BlobRequestOptions that you specify.

Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)

'Usage

public virtual void UploadText (
	string content,
	Encoding encoding,
	BlobRequestOptions options
)

Parameters

content

Type: System.String

The text to upload.

encoding

Type: System.Text.Encoding

An object that indicates the text encoding to use.

options

Type: Microsoft.WindowsAzure.StorageClient.BlobRequestOptions

An object that specifies any additional options for the request.

The following code example writes to a blob using two different service clients.

static void UploadIfNotExist(Uri blobEndpoint, string accountName, string accountKey)
{
    // Create service client for credentialed access to the blob.
    CloudBlobClient blobClient = 
        new CloudBlobClient(blobEndpoint, 
            new StorageCredentialsAccountAndKey(accountName, accountKey));

    // Get a reference to the blob.
    CloudBlob blob = blobClient.GetBlobReference("mycontainer/myblob.txt");

    // Specify the if-none-match condition.
    BlobRequestOptions options = new BlobRequestOptions();

    options.AccessCondition = AccessCondition.IfNoneMatch("*");

    try
    {
        // Upload the blob only if it does not already exist.
        blob.UploadText("Upload this blob if it does not already exist.", Encoding.UTF8, options);
    }
    catch (StorageClientException e)
    {
        if (e.ErrorCode == StorageErrorCode.BlobAlreadyExists)
        {
            Console.WriteLine("Blob was not uploaded because it already exists.");
        }
        else
        {
            Console.WriteLine(e.Message);
        }
    }
}

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows 7 and Windows Server 2008

Target Platforms

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft