CloudTableClient.ListTables Method (String)

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

Returns an enumerable collection of table names that begin with the specified prefix.

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

Usage

Visual Basic
Dim instance As CloudTableClient
Dim prefix As String
Dim returnValue As IEnumerable(Of String)

returnValue = instance.ListTables(prefix)

Syntax

Visual Basic
Public Function ListTables ( _
	prefix As String _
) As IEnumerable(Of String)
C#
public IEnumerable<string> ListTables (
	string prefix
)
C++
public:
IEnumerable<String^>^ ListTables (
	String^ prefix
)
J#
JScript

Parameters

prefix

Type: System.String

The table name prefix.

Return Value

Type: System.Collections.Generic.IEnumerable

An enumerable collection of table names.

Example

The following code example lists tables in the storage account that begin with the specified prefix.

C# Copy Code
public static void ListTablesByPrefix(CloudStorageAccount storageAccount, string prefix)
{
    // Create service client for credentialed access to the Table service.
    CloudTableClient tableClient = new CloudTableClient(storageAccount.TableEndpoint.ToString(),
        storageAccount.Credentials);
    // List the tables in this storage account.
    foreach (string tableName in tableClient.ListTables(prefix))
    {
        Console.WriteLine(tableName);
    }
}

Remarks

The collection of table names is retrieved lazily.


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