Share via

  • Article

Table.Grant Method (ObjectPermissionSet, String, Boolean)

Grants access to the specified permission and the ability to grant access to other uses for the specified grantee on the table.

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

Syntax

'Declaration
Public Sub Grant ( _
    permission As ObjectPermissionSet, _
    granteeName As String, _
    grantGrant As Boolean _
)
'Usage
Dim instance As Table
Dim permission As ObjectPermissionSet
Dim granteeName As String
Dim grantGrant As Boolean

instance.Grant(permission, granteeName, _
    grantGrant)

public void Grant(
    ObjectPermissionSet permission,
    string granteeName,
    bool grantGrant
)

public:
virtual void Grant(
    ObjectPermissionSet^ permission, 
    String^ granteeName, 
    bool grantGrant
) sealed

abstract Grant : 
        permission:ObjectPermissionSet * 
        granteeName:string * 
        grantGrant:bool -> unit 
override Grant : 
        permission:ObjectPermissionSet * 
        granteeName:string * 
        grantGrant:bool -> unit 

public final function Grant(
    permission : ObjectPermissionSet, 
    granteeName : String, 
    grantGrant : boolean
)

Parameters

  • granteeName
    Type: System.String
    A String value that specifies the grantee to be denied specified set of permissions.
  • grantGrant
    Type: System.Boolean
    A Boolean property that specifies whether the grantee is given the ability to grant the set of permissions to other users on the table.
    If True, the grantee is given the ability to grant the specified set of permissions to other users on the table. Otherwise, False.

Implements

IObjectPermission.Grant(ObjectPermissionSet, String, Boolean)

Examples

The following code example shows how to grant a grantee account permission to select table elements. The grantee account is a placeholder for any defined user accounts.

The following database schema is used for this snippet.

//CREATE DATABASE MYTESTDB;
//GO

//USE MYTESTDB;
//GO

//CREATE TABLE TABLE1(
//    id int,
//    name varchar(32)
//);
//GO

C#

Server srv = new Server("(local)");
Database db = srv.Databases["MYTESTDB"];

Table tb = db.Tables[0];

ObjectPermissionSet objPermissionSet = new ObjectPermissionSet(ObjectPermission.Select);
objPermissionSet.Select = true;
tb.Grant(objPermissionSet, grantee, true);

Powershell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("MYTESTDB")
$tb = $db.Tables[0]

$objPermissionSet = new-object Microsoft.SqlServer.Management.Smo.ObjectPermissionSet([Microsoft.SqlServer.Management.Smo.ObjectPermission]::Select)
$objPermissionSet.Select = $TRUE
$tb.Grant($objPermissionSet, grantee, $TRUE)