CloudBlob.UploadText Method (String, Encoding, BlobRequestOptions)
From Storage Client Library NET API
[This topic is part of the Microsoft Azure Storage Client Library 1.7, which has been deprecated. See Storage Client Library for the latest version.]
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.
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
| Visual Basic |
|---|
Dim instance As CloudBlob Dim content As String Dim encoding As Encoding Dim options As BlobRequestOptions instance.UploadText(content, encoding, options) |
Syntax
| Visual Basic |
|---|
Public Overridable Sub UploadText ( _ content As String, _ encoding As Encoding, _ options As BlobRequestOptions _ ) |
| C# |
|---|
public virtual void UploadText ( string content, Encoding encoding, BlobRequestOptions options ) |
| C++ |
|---|
public: virtual void UploadText ( String^ content, Encoding^ encoding, BlobRequestOptions^ options ) |
| J# |
|---|
| JScript |
|---|
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.
Example
The following code example writes to a blob using two different service clients.
| C# | Copy Code |
|---|---|
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);
}
}
}
| |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.