Verwenden von Auflistungen

Eine Auflistung ist eine Liste von Objekten, die aus derselben Objektklasse erstellt wurden und die dasselbe übergeordnete Objekt verwenden. Das Auflistungsobjekt enthält immer den Namen des Objekttyps mit dem Auflistungssuffix. Wenn Sie beispielsweise auf die Spalten in einer angegebenen Tabelle zugreifen möchten, verwenden Sie den ColumnCollection Objekttyp. Es enthält alle Column Objekte, die zum gleichen Table Objekt gehören.

Die Microsoft Visual Basic-Anweisung For...Each oder die Microsoft Visual C# foreach -Anweisung kann verwendet werden, um jedes Element der Auflistung zu durchlaufen.

Beispiele

Um ein codebeispiel zu verwenden, das bereitgestellt wird, müssen Sie die Programmierumgebung, die Programmiervorlage und die Programmiersprache auswählen, in der Ihre Anwendung erstellt werden soll. Weitere Informationen finden Sie unter "How to: Create a Visual Basic SMO Project in Visual Studio .NET" oder "How to: Create a Visual C# SMO Project in Visual Studio .NET" in SQL Server Books Online.

Verweisen auf ein Objekt mithilfe einer Auflistung in Visual Basic

In diesem Codebeispiel wird gezeigt, wie Sie eine Spalteneigenschaft mithilfe der ColumnsEigenschaften Tables, und Databases derEn Eigenschaften festlegen. Diese Eigenschaften stellen Auflistungen dar, die verwendet werden können, um ein bestimmtes Objekt zu identifizieren, wenn sie mit einem Parameter verwendet werden, der den Namen des Objekts angibt. Der Name und das Schema sind für die Tables Auflistungsobjekteigenschaft erforderlich.

Verweisen auf ein Objekt mithilfe einer Auflistung in Visual C#

In diesem Codebeispiel wird gezeigt, wie Sie eine Spalteneigenschaft mithilfe der ColumnsEigenschaften Tables, und Databases derEn Eigenschaften festlegen. Diese Eigenschaften stellen Auflistungen dar, die verwendet werden können, um ein bestimmtes Objekt zu identifizieren, wenn sie mit einem Parameter verwendet werden, der den Namen des Objekts angibt. Der Name und das Schema sind für die Tables Auflistungsobjekteigenschaft erforderlich.

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

Durchlaufen der Elemente einer Auflistung in Visual Basic

In diesem Codebeispiel wird die Auflistungseigenschaft Databases durchlaufen und alle Datenbankverbindungen mit der Instanz von SQL Server angezeigt.

Durchlaufen der Elemente einer Auflistung in Visual C#

In diesem Codebeispiel wird die Auflistungseigenschaft Databases durchlaufen und alle Datenbankverbindungen mit der Instanz von SQL Server angezeigt.

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