StorageClientException Class

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

Represents an exception thrown by the Windows Azure storage client library.

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

Usage

Visual Basic
Dim instance As StorageClientException

Syntax

Visual Basic
<SerializableAttribute> _
Public Class StorageClientException
	Inherits StorageException
C#
[SerializableAttribute] 
public class StorageClientException : StorageException
C++
[SerializableAttribute] 
public ref class StorageClientException : public StorageException
J#
JScript

Remarks

When the StorageClientException is thrown it indicates that there was a problem with the request the client made to the server. Any timeout related exceptions are automatically retried, and therefore, retrying the operation yourself will almost certainly result in the same exception being thrown. The one exception to this rule is when the ExtendedErrorInformation property indicates that ErrorCode is equal to InternalError.

C# Copy Code
bool canRetry = true;
while (canRetry) 
{
    try
    {
        // Perform data access operation
    }
    catch (StorageClientException ex)
    {
        if (!ex.ExtendedErrorInformation.ErrorCode.Equals(
            StorageErrorCodeStrings.InternalError.ToString())
        {
            canRetry = false;
        }
        else 
        {
            // Wait before retrying the operation
            System.Threading.Thread.Sleep(1000);
        }
    }
}

Inheritance Hierarchy

System.Object
   System.Exception
     Microsoft.WindowsAzure.StorageClient.StorageException
      Microsoft.WindowsAzure.StorageClient.StorageClientException

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.

Platforms

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012

Change History

See Also