Usar colecciones

Una colección es una lista de objetos que se han construido a partir de la misma clase de objeto y que comparten el mismo objeto primario. El objeto de colección siempre contiene el nombre del tipo de objeto con el sufijo Collection. Por ejemplo, para tener acceso a las columnas de una tabla especificada, use el tipo de ColumnCollection objeto . Contiene todos los Column objetos que pertenecen al mismo Table objeto.

La instrucción Microsoft Visual Basic For...Each o la instrucción de Microsoft Visual C# foreach se pueden usar para recorrer en iteración cada miembro de la colección.

Ejemplos

Para usar cualquier ejemplo de código que se proporcione, tendrá que elegir el entorno de programación, la plantilla de programación y el lenguaje de programación en el que se va a crear la aplicación. Para obtener más información, vea "How to: Create a Visual Basic SMO Project in Visual Studio .NET" o "How to: Create a Visual C# SMO Project in Visual Studio .NET" in SQL Server Books Online.

Hacer referencia a un objeto mediante un uso de una colección en Visual Basic

En este ejemplo de código se muestra cómo establecer una propiedad de columna mediante las Columnspropiedades , Tablesy Databases . Estas propiedades representan colecciones, que se pueden usar para identificar un objeto determinado cuando se usan con un parámetro que especifica el nombre del objeto. El nombre y el esquema son necesarios para la propiedad del objeto de Tables colección.

Hacer referencia a un objeto mediante un uso de una colección en Visual C#

En este ejemplo de código se muestra cómo establecer una propiedad de columna mediante las Columnspropiedades , Tablesy Databases . Estas propiedades representan colecciones, que se pueden usar para identificar un objeto determinado cuando se usan con un parámetro que especifica el nombre del objeto. El nombre y el esquema son necesarios para la propiedad del objeto de Tables colección.

{   
//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();   
}  

Iteración a través de los miembros de una colección en Visual Basic

Este ejemplo de código recorre en iteración la propiedad de colección Databases y muestra todas las conexiones de base de datos a la instancia de SQL Server.

Iteración a través de los miembros de una colección en Visual C#

Este ejemplo de código recorre en iteración la propiedad de colección Databases y muestra todas las conexiones de base de datos a la instancia de 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);   
}