Classe DatabaseRole

Articolo
07/31/2013

The DatabaseRole object represents a SQL Server database security role.

Gerarchia di ereditarietà

System.Object
  Microsoft.SqlServer.Management.Smo.SmoObjectBase
    Microsoft.SqlServer.Management.Smo.SqlSmoObject
      Microsoft.SqlServer.Management.Smo.NamedSmoObject
        Microsoft.SqlServer.Management.Smo.ScriptNameObjectBase
          Microsoft.SqlServer.Management.Smo.DatabaseRole

Spazio dei nomi Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Sintassi

'Dichiarazione
<StateChangeEventAttribute("CREATE_ROLE", "ROLE")> _
<StateChangeEventAttribute("ALTER_ROLE", "ROLE")> _
<PhysicalFacetAttribute> _
<SfcElementTypeAttribute("Role")> _
<StateChangeEventAttribute("ALTER_AUTHORIZATION_DATABASE", "ROLE")> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.None Or AutomatedPolicyEvaluationMode.Enforce Or AutomatedPolicyEvaluationMode.CheckOnChanges Or AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class DatabaseRole _
    Inherits ScriptNameObjectBase _
    Implements ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable,  _
    IAlterable, IRenamable, IExtendedProperties, IScriptable
'Utilizzo
Dim instance As DatabaseRole

[StateChangeEventAttribute("CREATE_ROLE", "ROLE")]
[StateChangeEventAttribute("ALTER_ROLE", "ROLE")]
[PhysicalFacetAttribute]
[SfcElementTypeAttribute("Role")]
[StateChangeEventAttribute("ALTER_AUTHORIZATION_DATABASE", "ROLE")]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.None|AutomatedPolicyEvaluationMode.Enforce|AutomatedPolicyEvaluationMode.CheckOnChanges|AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class DatabaseRole : ScriptNameObjectBase, 
    ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable, IAlterable, 
    IRenamable, IExtendedProperties, IScriptable

[StateChangeEventAttribute(L"CREATE_ROLE", L"ROLE")]
[StateChangeEventAttribute(L"ALTER_ROLE", L"ROLE")]
[PhysicalFacetAttribute]
[SfcElementTypeAttribute(L"Role")]
[StateChangeEventAttribute(L"ALTER_AUTHORIZATION_DATABASE", L"ROLE")]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::None|AutomatedPolicyEvaluationMode::Enforce|AutomatedPolicyEvaluationMode::CheckOnChanges|AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class DatabaseRole sealed : public ScriptNameObjectBase, 
    ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable, IAlterable, 
    IRenamable, IExtendedProperties, IScriptable

[<SealedAttribute>]
[<StateChangeEventAttribute("CREATE_ROLE", "ROLE")>]
[<StateChangeEventAttribute("ALTER_ROLE", "ROLE")>]
[<PhysicalFacetAttribute>]
[<SfcElementTypeAttribute("Role")>]
[<StateChangeEventAttribute("ALTER_AUTHORIZATION_DATABASE", "ROLE")>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.None|AutomatedPolicyEvaluationMode.Enforce|AutomatedPolicyEvaluationMode.CheckOnChanges|AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type DatabaseRole =  
    class 
        inherit ScriptNameObjectBase 
        interface ISfcSupportsDesignMode 
        interface IObjectPermission 
        interface ICreatable 
        interface IDroppable 
        interface IAlterable 
        interface IRenamable 
        interface IExtendedProperties 
        interface IScriptable 
    end

public final class DatabaseRole extends ScriptNameObjectBase implements ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable, IAlterable, IRenamable, IExtendedProperties, IScriptable

Nel tipo DatabaseRole sono esposti i membri seguenti.

Costruttori

	Nome	Descrizione
	DatabaseRole()	Initializes a new instance of the DatabaseRole class.
	DatabaseRole(Database, String)	Initializes a new instance of the DatabaseRole class.

In alto

Proprietà

	Nome	Descrizione
	CreateDate	Gets the date and time when the database role was created.
	DateLastModified	Gets the date and time when the database role was last modified.
	ExtendedProperties	Gets the extended properties of the database role.
	ID	Gets the ID value that uniquely identifies the database role.
	IsFixedRole	Gets the Boolean property value that specifies whether the database role is a fixed role or a user-defined role.
	Name	Gets or sets a String value that specifies the name of the database role. Esegue l'override di NamedSmoObject.Name.
	Owner	Gets or sets the owner of the database role.
	Parent	Gets or sets the Database object that is the parent of the DatabaseRole object.
	Properties	Gets a collection of Property objects that represent the object properties. Ereditato da SqlSmoObject.
	State	Gets the state of the referenced object. Ereditato da SmoObjectBase.
	Urn	Gets the Uniform Resource Name (URN) address value that uniquely identifies the object. Ereditato da SqlSmoObject.
	UserData	Gets or sets user-defined data associated with the referenced object. Ereditato da SmoObjectBase.

In alto

Metodi

	Nome	Descrizione
	AddMember	Adds an existing database user or database role to the database role.
	Alter	Updates any DatabaseRole object property changes on the instance of Microsoft SQL Server.
	Create	Creates a database role on the instance of Microsoft SQL Server as defined by the DatabaseRole object.
	Deny(ObjectPermissionSet, String)	Denies the specified set of permissions for the specified grantee on the database role.
	Deny(ObjectPermissionSet, array<String[])	Denies the specified set of permissions for the specified grantees on the database role.
	Deny(ObjectPermissionSet, String, Boolean)	Denies the specified set of permissions for the specified grantee and other users that the grantee granted the specified set of permissions on the database role.
	Deny(ObjectPermissionSet, array<String[], Boolean)	Denies the specified set of permissions for the specified grantees and other users that the grantee granted the specified set of permissions on the database role.
	Discover	Discovers a list of type Object. Ereditato da SqlSmoObject.
	Drop	Drops the database role.
	DropMember	Removes the specified database user or role from the referenced database role.
	EnumAgentProxyAccounts	Returns a list of agent proxy accounts that are assigned to the database role.
	EnumMembers	Returns a list of database users that are members of the database role.
	EnumObjectPermissions()	Returns a list of object permissions assigned to the referenced database role.
	EnumObjectPermissions(String)	Returns a list of object permissions assigned to the referenced database role for the specified member of the role.
	EnumObjectPermissions(ObjectPermissionSet)	Returns a list of object permissions assigned to the referenced database role for the specified set of object permissions.
	EnumObjectPermissions(String, ObjectPermissionSet)	Returns a list of object permissions assigned to the referenced database role for the specified member of the role and for the specified set of permissions.
	EnumRoles	Returns a list of the roles that the referenced database role is a member of.
	Equals	Ereditato da Object.
	FormatSqlVariant	Formats an object as SqlVariant type. Ereditato da SqlSmoObject.
	GetContextDB	Gets the context database that is associated with this object. Ereditato da SqlSmoObject.
	GetDBName	Gets the database name that is associated with the object. Ereditato da SqlSmoObject.
	GetHashCode	Ereditato da Object.
	GetPropValue	Gets a property value of the SqlSmoObject object. Ereditato da SqlSmoObject.
	GetPropValueOptional	Gets a property value of the SqlSmoObject object. Ereditato da SqlSmoObject.
	GetPropValueOptionalAllowNull	Gets a property value of the SqlSmoObject object. Ereditato da SqlSmoObject.
	GetServerObject	Gets the server of the SqlSmoObject object. Ereditato da SqlSmoObject.
	GetType	Ereditato da Object.
	Grant(ObjectPermissionSet, String)	Grants the specified set of permissions to the specified grantee on the database role.
	Grant(ObjectPermissionSet, array<String[])	Grants the specified set of permissions to the specified grantees on the database role.
	Grant(ObjectPermissionSet, String, Boolean)	Grants access to the specified permission to the grantee and the ability to grant access to other users on the database role.
	Grant(ObjectPermissionSet, array<String[], Boolean)	Grants access to the specified permission to the grantees and the ability to grant access to other users on the database role.
	Grant(ObjectPermissionSet, String, Boolean, String)	Grants the specified set of permissions to the grantees and the ability to grant the set of permissions to other users on the database role under an assumed role.
	Grant(ObjectPermissionSet, array<String[], Boolean, String)	Grants the specified set of permissions to the grantees and the ability to grant the set of permissions to other users on the database role under an assumed role.
	Initialize()	Initializes the object and forces the properties be loaded. Ereditato da SqlSmoObject.
	Initialize(Boolean)	Initializes the object and forces the properties be loaded. Ereditato da SqlSmoObject.
	IsObjectInitialized	Verifies whether the object has been initialized. Ereditato da SqlSmoObject.
	IsObjectInSpace	Verifies whether the object is isolated or connected to the instance of SQL Server. Ereditato da SqlSmoObject.
	Refresh	Refreshes the script name. Ereditato da ScriptNameObjectBase.
	Rename	Renames the database role.
	Revoke(ObjectPermissionSet, String)	Revokes a previously granted set of permissions from a grantee on the database role.
	Revoke(ObjectPermissionSet, array<String[])	Revokes a previously granted set of permissions from a list of grantees on the database role.
	Revoke(ObjectPermissionSet, String, Boolean, Boolean)	Revokes previously granted permissions from a grantee on the database role and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.
	Revoke(ObjectPermissionSet, array<String[], Boolean, Boolean)	Revokes previously granted permissions from grantees on the database role and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.
	Revoke(ObjectPermissionSet, String, Boolean, Boolean, String)	Revokes previously granted permissions from a grantee on the database role and any other users to whom the grantee has granted the specified set of permissions. The grantee is also given the ability to revoke the specified set of permissions from other users under an assumed role.
	Revoke(ObjectPermissionSet, array<String[], Boolean, Boolean, String)	Revokes previously granted permissions from grantees on the database role and any other users to whom the grantees have granted the specified set of permissions. The grantees are also given the ability to revoke the specified set of permissions from other users under an assumed role.
	Script()	Generates a Transact-SQL script that can be used to re-create the Microsoft SQL Server database role.
	Script(ScriptingOptions)	Generates a Transact-SQL script that can be used to re-create the Microsoft SQL Server database role as specified by the scripting options.
	SetParentImpl	Sets the parent of the SqlSmoObject to the newParent parameter. Ereditato da SqlSmoObject.
	ToString	Returns a String that represents the referenced object. Ereditato da SqlSmoObject.
	Validate	Validates the state of an object. Ereditato da SmoObjectBase.

In alto

Eventi

	Nome	Descrizione
	PropertyChanged	Represents the event that occurs when a property is changed. Ereditato da SqlSmoObject.
	PropertyMetadataChanged	Represents the event that occurs when property metadata changes. Ereditato da SqlSmoObject.

In alto

Implementazioni esplicite dell'interfaccia

	Nome	Descrizione
	IAlienObject.Discover	Discovers any dependencies. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
	IAlienObject.GetDomainRoot	Returns the root of the domain. Ereditato da SqlSmoObject.
	IAlienObject.GetParent	Gets the parent of this object. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
	IAlienObject.GetPropertyType	Gets the type of the specified property. Ereditato da SqlSmoObject.
	IAlienObject.GetPropertyValue	Gets the value of the specified property. Ereditato da SqlSmoObject.
	IAlienObject.GetUrn	Gets the Unified Resource Name (URN) of the object. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
	IAlienObject.Resolve	Gets the instance that contains the information about the object from the Unified Resource Name (URN) of the object. Ereditato da SqlSmoObject.
	IAlienObject.SetObjectState	Sets the object state to the specified SfcObjectState value. Ereditato da SqlSmoObject.
	IAlienObject.SetPropertyValue	Sets the property value. Ereditato da SqlSmoObject.
	ISfcPropertyProvider.GetPropertySet	Gets the interface reference to the set of properties of this object. Ereditato da SqlSmoObject.
	ISfcSupportsDesignMode.IsDesignMode	Gets a Boolean value that specifies whether the database role supports design mode.

In alto

Osservazioni

To get DatabaseRole object properties, users can be a member of the public fixed server role.

To set DatabaseRole object properties, users must have ALTER permission on the database role.

To create a database role, users must have CREATE ROLE permission on the parent database.

To drop a database role, users must have ALTER ANY ROLE permission on the parent database.

To add or remove members from the database role, users must be members of the db_owner or db_security admin fixed database role.

To grant, deny, or revoke permission on the database for other users, users must have CONTROL permission on the database role.

Thread Safety

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono sicuri per le operazioni a thread multipli. Non è invece garantita la sicurezza dei membri dell'istanza.