Database.ApplicationRoles Property

Gets a collection of ApplicationRole objects. Each ApplicationRole object represents an application role defined on the database.

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
<SfcObjectAttribute(SfcContainerRelationship.ObjectContainer, SfcContainerCardinality.ZeroToAny,  _
    GetType(ApplicationRole))> _
Public ReadOnly Property ApplicationRoles As ApplicationRoleCollection 
    Get
'Usage
Dim instance As Database 
Dim value As ApplicationRoleCollection 

value = instance.ApplicationRoles
[SfcObjectAttribute(SfcContainerRelationship.ObjectContainer, SfcContainerCardinality.ZeroToAny, 
    typeof(ApplicationRole))]
public ApplicationRoleCollection ApplicationRoles { get; }
[SfcObjectAttribute(SfcContainerRelationship::ObjectContainer, SfcContainerCardinality::ZeroToAny, 
    typeof(ApplicationRole))]
public:
property ApplicationRoleCollection^ ApplicationRoles {
    ApplicationRoleCollection^ get ();
}
[<SfcObjectAttribute(SfcContainerRelationship.ObjectContainer, SfcContainerCardinality.ZeroToAny, 
    typeof(ApplicationRole))>]
member ApplicationRoles : ApplicationRoleCollection
function get ApplicationRoles () : ApplicationRoleCollection

Property Value

Type: Microsoft.SqlServer.Management.Smo.ApplicationRoleCollection
An ApplicationRoleCollection object that represents all the application roles defined on the database.

Remarks

Specific application roles can be referenced by using this collection by specifying the name of the application role. To add a new application role to the collection, call the application role constructor ApplicationRole.

Examples

VB

'Connect to the local, default instance of SQL Server.
Dim srv As Server
        srv = New Server

'Reference the AdventureWorks2012 database.
Dim db As Database
db = srv.Databases("AdventureWorks2012")

'Display all the application roles on the database.
Dim ar As ApplicationRole
For Each ar In db.ApplicationRoles
   Console.WriteLine(ar.Name)
Next

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")
Foreach ($ar in $db.ApplicationRoles)
{
   Write-Host $ar.Name
}

See Also

Reference

Database Class

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Working with Database Objects

Application Roles

Creating, Altering, and Removing Databases

CREATE DATABASE (Transact-SQL)