Usando coleções

Uma coleção é uma lista de objetos que foram construídos da mesma classe de objeto e que compartilham o mesmo objeto pai. O objeto de coleção sempre contém o nome do tipo de objeto com o sufixo Collection. Por exemplo, para acessar as colunas em uma tabela especificada, use o ColumnCollection tipo de objeto. Ele contém todos os Column objetos que pertencem ao mesmo Table objeto.

A instrução Microsoft Visual Basic For...Each ou a instrução Microsoft Visual C# foreach podem ser usadas para iterar por meio de cada membro da coleção.

Exemplos

Para usar qualquer exemplo de código fornecido, você precisará escolher o ambiente de programação, o modelo de programação e a linguagem de programação na qual criar seu aplicativo. Para obter mais informações, consulte "Como criar um projeto SMO do Visual Basic no Visual Studio .NET" ou "Como criar um projeto SMO do Visual C# no Visual Studio .NET" nos Manuais Online do SQL Server.

Referenciando um objeto usando uma coleção no Visual Basic

Este exemplo de código mostra como definir uma propriedade de coluna usando as propriedades e Databases as ColumnsTablespropriedades. Essas propriedades representam coleções, que podem ser usadas para identificar um objeto específico quando são usadas com um parâmetro que especifica o nome do objeto. O nome e o esquema são necessários para a propriedade do objeto de Tables coleção.

Referenciando um objeto usando uma coleção no Visual C#

Este exemplo de código mostra como definir uma propriedade de coluna usando as propriedades e Databases as ColumnsTablespropriedades. Essas propriedades representam coleções, que podem ser usadas para identificar um objeto específico quando são usadas com um parâmetro que especifica o nome do objeto. O nome e o esquema são necessários para a propriedade do objeto de Tables coleção.

{   
//Connect to the local, default instance of SQL Server.   
Server srv;   
srv = new Server();   
//Modify a property using the Databases, Tables, and Columns collections to reference a column.   
srv.Databases("AdventureWorks2012").Tables("Person", "Person").Columns("LastName").Nullable = true;   
//Call the Alter method to make the change on the instance of SQL Server.   
srv.Databases("AdventureWorks2012").Tables("Person", "Person").Columns("LastName").Alter();   
}  

Iterando por meio dos membros de uma coleção no Visual Basic

Este exemplo de código itera por meio da propriedade de Databases coleção e exibe todas as conexões de banco de dados com a instância do SQL Server.

Iterando por meio dos membros de uma coleção no Visual C#

Este exemplo de código itera por meio da propriedade de Databases coleção e exibe todas as conexões de banco de dados com a instância do SQL Server.

//Connect to the local, default instance of SQL Server.   
{   
Server srv = default(Server);   
srv = new Server();   
int count = 0;   
int total = 0;   
//Iterate through the databases and call the GetActiveDBConnectionCount method.   
Database db = default(Database);   
foreach ( db in srv.Databases) {   
  count = srv.GetActiveDBConnectionCount(db.Name);   
  total = total + count;   
  //Display the number of connections for each database.   
  Console.WriteLine(count + " connections on " + db.Name);   
}   
//Display the total number of connections on the instance of SQL Server.   
Console.WriteLine("Total connections =" + total);   
}