Verwenden von AuflistungenUsing Collections

DIESES THEMA GILT FÜR: jaSQL Server jaAzure SQL-DatenbankjaAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL ServeryesAzure SQL DatabaseyesAzure SQL Data Warehouse noParallel Data Warehouse

Eine Auflistung ist eine Liste von Objekten, die aus der gleichen Objektklasse gebildet wurden und über dasselbe übergeordnete Objekt verfügen.A collection is a list of objects that have been constructed from the same object class and that share the same parent object. Das Auflistungsobjekt enthält immer den Namen des Objekttyps mit dem Suffix „Collection“.The collection object always contains the name of the object type with the Collection suffix. Um beispielsweise auf die Spalten einer gegebenen Tabelle zuzugreifen, verwenden Sie den ColumnCollection-Objekttyp.For example, to access the columns in a specified table, use the ColumnCollection object type. Er enthält alle Column-Objekte, die zum gleichen Table-Objekt gehören.It contains all the Column objects that belong to the same Table object.

Die MicrosoftMicrosoft Visual BasicVisual Basic für... Jede Anweisung oder der MicrosoftMicrosoft Visual C#Visual C# Foreach Anweisung kann verwendet werden, um jedes Element der Auflistung zu durchlaufen.The MicrosoftMicrosoft Visual BasicVisual Basic For...Each statement or the MicrosoftMicrosoft Visual C#Visual C# foreach statement can be used to iterate through each member of the collection.

BeispieleExamples

Zum Verwenden eines angegebenen Codebeispiels müssen Sie die Programmierumgebung, Programmiervorlage und die zu verwendende Programmiersprache auswählen, um Ihre Anwendung zu erstellen.To use any code example that is provided, you will have to choose the programming environment, the programming template, and the programming language in which to create your application. Weitere Informationen finden Sie unter Erstellen eines Visual C# SMO-Projekts in Visual Studio .NET.For more information, see Create a Visual C# SMO Project in Visual Studio .NET.

Verweisen auf ein Objekt mithilfe einer Auflistung in Visual BasicReferencing an Object by Using a Collection in Visual Basic

In diesem Codebeispiel wird veranschaulicht, wie eine Spalteneigenschaft festlegen, indem die Columns, Tables, und Databases Eigenschaften.This code example shows how to set a column property by using the Columns, Tables, and Databases properties. Diese Eigenschaften repräsentieren Auflistungen, mit denen ein bestimmtes Objekt identifiziert werden kann, wenn sie mit einem Parameter verwendet werden, der den Namen des Objekts angibt.These properties represent collections, which can be used to identify a particular object when they are used with a parameter that specifies the name of the object. Der Name und das Schema sind erforderlich, damit die Tables auflistungsobjekteigenschaft.The name and the schema are required for the Tables collection object property.

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Modify a property using the Databases, Tables, and Columns collections to reference a column.
srv.Databases("AdventureWorks2012").Tables("Person", "Person").Columns("ModifiedDate").Nullable = True
'Call the Alter method to make the change on the instance of SQL Server.
srv.Databases("AdventureWorks2012").Tables("Person", "Person").Columns("ModifiedDate").Alter()

Verweisen auf ein Objekt mithilfe einer Auflistung in Visual C#Referencing an Object by Using a Collection in Visual C#

In diesem Codebeispiel wird veranschaulicht, wie eine Spalteneigenschaft festlegen, indem die Columns, Tables, und Databases Eigenschaften.This code example shows how to set a column property by using the Columns, Tables, and Databases properties. Diese Eigenschaften repräsentieren Auflistungen, mit denen ein bestimmtes Objekt identifiziert werden kann, wenn sie mit einem Parameter verwendet werden, der den Namen des Objekts angibt.These properties represent collections, which can be used to identify a particular object when they are used with a parameter that specifies the name of the object. Der Name und das Schema sind erforderlich, damit die Tables auflistungsobjekteigenschaft.The name and the schema are required for the Tables collection object property.

{   
//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 BasicIterating Through the Members of a Collection in Visual Basic

Dieses Codebeispiel durchläuft die Databases Auflistungseigenschaft und zeigt alle mit der Instanz von Datenbankverbindungen SQL ServerSQL Server.This code example iterates through the Databases collection property and displays all database connections to the instance of SQL ServerSQL Server.

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
Dim count As Integer
Dim total As Integer
'Iterate through the databases and call the GetActiveDBConnectionCount method.
Dim db As Database
For Each 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)
Next
'Display the total number of connections on the instance of SQL Server.
Console.WriteLine("Total connections =" & total)

Durchlaufen der Elemente einer Auflistung in Visual C#Iterating Through the Members of a Collection in Visual C#

Dieses Codebeispiel durchläuft die Databases Auflistungseigenschaft und zeigt alle mit der Instanz von Datenbankverbindungen SQL ServerSQL Server.This code example iterates through the Databases collection property and displays all database connections to the instance of SQL ServerSQL 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);   
}