ApplicationEnumeration.GetEnumerator Method

Article
12/03/2008

Gets an IEnumerator interface that allows you to iterate through the collection of applications represented by the ApplicationEnumeration object.

Namespace: Microsoft.SqlServer.NotificationServices
Assembly: Microsoft.SqlServer.NotificationServices (in microsoft.sqlserver.notificationservices.dll)

Syntax

'Declaration
Public Function GetEnumerator As IEnumerator

public IEnumerator GetEnumerator ()

public:
virtual IEnumerator^ GetEnumerator () sealed

public final IEnumerator GetEnumerator ()

public final function GetEnumerator () : IEnumerator

Return Value

An IEnumerator interface for the ApplicationEnumeration object.

Remarks

Use this method to return an IEnumerator interface that allows you to iterate through the Notification Services applications in an ApplicationEnumeration object. An initialized ApplicationEnumeration object represents the collection of Notification Services applications in the specified Notification Services instance.

Example

The following examples show how to use an ApplicationEnumeration object to iterate through a set of Notification Services applications. The GetEnumerator method makes the For Each and foreach statements possible.

These examples use the Microsoft.SqlServer.NotificationServices namespace.

Dim instanceName As String = "MyInstanceName"

'Create an NSInstance object.
Dim myInstance As New NSInstance(instanceName)

'Create an ApplicationEnumeration object.
Dim myApplicationEnumeration As _
    New ApplicationEnumeration(myInstance)

'Iterate through the applications.
Dim application As NSApplication
For Each application In myApplicationEnumeration
    Console.WriteLine("Application Name: {0}, Version: {1}", _
    application.ApplicationName, application.Version)
Next application

string instanceName = "MyInstanceName";

//Create an NSInstance object.
NSInstance myInstance = new NSInstance(instanceName);

//Create an ApplicationEnumeration object.
ApplicationEnumeration myApplicationEnumeration = 
    new ApplicationEnumeration(myInstance);

//Iterate through the applications.
foreach (NSApplication application in myApplicationEnumeration)
{
    Console.WriteLine(
        "Application Name: {0}, Version: {1}", 
        application.ApplicationName, application.Version);
}

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms