Compartir a través de

Clase User

  • Artículo

The User object represents a SQL Server user.

Jerarquía de herencia

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.User

Espacio de nombres:  Microsoft.SqlServer.Management.Smo
Ensamblado:  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Sintaxis

'Declaración
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class User _
    Inherits ScriptNameObjectBase _
    Implements ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable,  _
    IAlterable, IRenamable, IExtendedProperties, IScriptable, IUserOptions,  _
    IDmfFacet
'Uso
Dim instance As User

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class User : ScriptNameObjectBase, ISfcSupportsDesignMode, 
    IObjectPermission, ICreatable, IDroppable, IAlterable, IRenamable, 
    IExtendedProperties, IScriptable, IUserOptions, IDmfFacet

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class User sealed : public ScriptNameObjectBase, 
    ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable, IAlterable, 
    IRenamable, IExtendedProperties, IScriptable, IUserOptions, IDmfFacet

[<SealedAttribute>]
[<PhysicalFacetAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type User =  
    class 
        inherit ScriptNameObjectBase 
        interface ISfcSupportsDesignMode 
        interface IObjectPermission 
        interface ICreatable 
        interface IDroppable 
        interface IAlterable 
        interface IRenamable 
        interface IExtendedProperties 
        interface IScriptable 
        interface IUserOptions 
        interface IDmfFacet 
    end

public final class User extends ScriptNameObjectBase implements ISfcSupportsDesignMode, IObjectPermission, ICreatable, IDroppable, IAlterable, IRenamable, IExtendedProperties, IScriptable, IUserOptions, IDmfFacet

El tipo User expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público User() Initializes a new instance of the User class.
Método público User(Database, String) Initializes a new instance of the User class on the specified database with the specified name.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública AsymmetricKey Gets or sets the asymmetric key for the user.
Propiedad pública AuthenticationType Gets a string value that describes the mechanism used to authenticate the user.
Propiedad pública Certificate Gets or sets the certificate for the user.
Propiedad pública CreateDate Gets the date and time when the database user was created.
Propiedad pública DateLastModified Gets the date and time when the database user was last modified.
Propiedad pública DefaultLanguage Gets or sets the default language for the user.
Propiedad pública DefaultSchema Gets the default schema for the database user.
Propiedad pública Events Gets the events that are associated with the database user.
Propiedad pública ExtendedProperties Gets the extended properties of the database user.
Propiedad pública HasDBAccess Gets the Boolean property that specifies whether the database user has access to the database.
Propiedad pública ID Gets the ID value that uniquely identifies the database user.
Propiedad pública IsSystemObject Gets the Boolean property that specifies whether the database user is a system object.
Propiedad pública Login Gets the login that is associated with the database user.
Propiedad pública LoginType Gets the type of login that is associated with the database user, such as whether it is a Windows group or a SQL Server standard login.
Propiedad pública Name Gets or sets a String value that specifies the name of the user. (Invalida NamedSmoObject.Name.)
Propiedad pública Parent Gets the Database object that is the parent of the User object.
Propiedad pública Properties Gets a collection of Property objects that represent the object properties. (Se hereda de SqlSmoObject.)
Propiedad pública Sid Gets the security identification number (SID) value of the database user.
Propiedad pública State Gets the state of the referenced object. (Se hereda de SmoObjectBase.)
Propiedad pública Urn Gets the Uniform Resource Name (URN) address value that uniquely identifies the object. (Se hereda de SqlSmoObject.)
Propiedad pública UserData Gets or sets user-defined data associated with the referenced object. (Se hereda de SmoObjectBase.)
Propiedad pública UserType Gets or sets the type of user.

Arriba

Métodos

  Nombre Descripción
Método público AddToRole Adds the database user to the specified role.
Método público Alter Updates any User object property changes on the instance of Microsoft SQL Server. 
Método público ChangePassword(SecureString) Changes the user password.
Método público ChangePassword(String) Changes the user password.
Método público ChangePassword(SecureString, SecureString) Changes the user password.
Método público ChangePassword(String, String) Changes the user password.
Método público Create() Creates a database user on the instance of SQL Server as defined by the User object.
Método público Create(SecureString) Creates a database user on the instance of SQL Server as defined by the User object with specified password using a secure string.
Método público Create(String) Creates a database user on the instance of SQL Server as defined by the User object with specified password.
Método público Deny(ObjectPermissionSet, String) Denies access to the specified permission for the specified grantee on the database user.
Método público Deny(ObjectPermissionSet, array<String[]) Denies access to the specified permission for the specified grantees on the database user.
Método público Deny(ObjectPermissionSet, String, Boolean) Denies access to the specified permission for the specified grantee and other users whom the grantee granted access on the database user.
Método público Deny(ObjectPermissionSet, array<String[], Boolean) Denies access to the specified permission for the specified grantees on the database user.
Método público Discover Discovers a list of type Object. (Se hereda de SqlSmoObject.)
Método público Drop Removes the user from the database.
Método público EnumObjectPermissions() Enumerates a list of object permissions for the database user.
Método público EnumObjectPermissions(String) Enumerates a list of object permissions for a specified grantee on the database user.
Método público EnumObjectPermissions(ObjectPermissionSet) Enumerates a list of object permissions for a specified permission on the database user.
Método público EnumObjectPermissions(String, ObjectPermissionSet) Enumerates a list of object permissions for a specified grantee and a specified permission on the database user.
Método público EnumOwnedObjects Enumerates a list of object that the database user owns.
Método público EnumRoles Enumerates a list of roles of which the database user is a member.
Método público Equals (Se hereda de Object.)
Método protegido FormatSqlVariant Formats an object as SqlVariant type. (Se hereda de SqlSmoObject.)
Método protegido GetContextDB Gets the context database that is associated with this object. (Se hereda de SqlSmoObject.)
Método protegido GetDBName Gets the database name that is associated with the object. (Se hereda de SqlSmoObject.)
Método público GetHashCode (Se hereda de Object.)
Método protegido GetPropValue Gets a property value of the SqlSmoObject object. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptional Gets a property value of the SqlSmoObject object. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptionalAllowNull Gets a property value of the SqlSmoObject object. (Se hereda de SqlSmoObject.)
Método protegido GetServerObject Gets the server of the SqlSmoObject object. (Se hereda de SqlSmoObject.)
Método público GetType (Se hereda de Object.)
Método público Grant(ObjectPermissionSet, String) Grants access to the specified permission for the specified grantee on the database user.
Método público Grant(ObjectPermissionSet, array<String[]) Grants access to the specified permission for the specified grantees on the database user.
Método público Grant(ObjectPermissionSet, String, Boolean) Grants access to the specified permission and the ability to grant access to other users for the specified grantee on the database user.
Método público Grant(ObjectPermissionSet, array<String[], Boolean) Grants access to the specified permission and the ability to grant access to other users for the specified grantees on the database user.
Método público Grant(ObjectPermissionSet, String, Boolean, String) Grants access to the specified permission and the ability to grant access to other users for the specified grantee on the database user.
Método público Grant(ObjectPermissionSet, array<String[], Boolean, String) Grants access to the specified permission and the ability to grant access to other users for the specified grantee on the database user under an assumed role.
Método público Initialize() Initializes the object and forces the properties be loaded. (Se hereda de SqlSmoObject.)
Método público Initialize(Boolean) Initializes the object and forces the properties be loaded. (Se hereda de SqlSmoObject.)
Método público IsMember Verifies whether the database user is a member of the specified role.
Método protegido IsObjectInitialized Verifies whether the object has been initialized. (Se hereda de SqlSmoObject.)
Método protegido IsObjectInSpace Verifies whether the object is isolated or connected to the instance of SQL Server. (Se hereda de SqlSmoObject.)
Método público MakeContained Converts a login mapped user to a contained user with password using the sys.sp_copy_password_to_user stored procedure.
Método público Refresh Refreshes the script name. (Se hereda de ScriptNameObjectBase.)
Método público Rename Renames the database user.
Método público Revoke(ObjectPermissionSet, String) Revokes previously granted permissions from a grantee on the database user.
Método público Revoke(ObjectPermissionSet, array<String[]) Revokes previously granted permissions from a list of grantees on the database user.
Método público Revoke(ObjectPermissionSet, String, Boolean, Boolean) Revokes previously granted permissions from a grantee on the database user and any other users to whom the grantee has granted access. The grantee is also given the ability to revoke other users' access.
Método público Revoke(ObjectPermissionSet, array<String[], Boolean, Boolean) Revokes previously granted permissions from the grantees on the database user and any other users to whom the grantees have granted access. The grantees are also given the ability to revoke other users' access.
Método público Revoke(ObjectPermissionSet, String, Boolean, Boolean, String) Revokes previously granted permissions from a grantee on the database user and any other users to whom the grantee has granted access. The grantee is also given the ability to revoke other users' access under an assumed role.
Método público Revoke(ObjectPermissionSet, array<String[], Boolean, Boolean, String) Revokes previously granted permissions from grantees on the database user and any other users to whom the grantees have granted access. The grantees are also given the ability to revoke other users' access under an assumed role.
Método público Script() Generates a Transact-SQL script that can be used to re-create the database user.
Método público Script(ScriptingOptions) Generates a Transact-SQL script that can be used to re-create the database user as specified by the script options.
Método protegido SetParentImpl Sets the parent of the SqlSmoObject to the newParent parameter. (Se hereda de SqlSmoObject.)
Método público ToString Returns a String that represents the referenced object. (Se hereda de SqlSmoObject.)
Método público Validate Validates the state of an object. (Se hereda de SmoObjectBase.)

Arriba

Eventos

  Nombre Descripción
Evento público PropertyChanged Represents the event that occurs when a property is changed. (Se hereda de SqlSmoObject.)
Evento público PropertyMetadataChanged Represents the event that occurs when property metadata changes. (Se hereda de SqlSmoObject.)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado IAlienObject.Discover Discovers any dependencies. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.GetDomainRoot Returns the root of the domain. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.GetParent Gets the parent of this object. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.GetPropertyType Gets the type of the specified property. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.GetPropertyValue Gets the value of the specified property. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.GetUrn Gets the Unified Resource Name (URN) of the object. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.Resolve Gets the instance that contains the information about the object from the Unified Resource Name (URN) of the object. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.SetObjectState Sets the object state to the specified SfcObjectState value. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject.SetPropertyValue Sets the property value. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado ISfcPropertyProvider.GetPropertySet Gets the interface reference to the set of properties of this object. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasPropiedad privada ISfcSupportsDesignMode.IsDesignMode Gets a Boolean value that specifies whether the user supports design mode.

Arriba

Comentarios

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

To set User object properties, uses must have ALTER ANY USER permission on the database or be a member of the db_owner fixed database role.

To change the default schema, users must have ALTER permission on the specified user or be the owner of the user.

To create or drop a user, users must have ALTER ANY USER permission on the fixed server role or be a member of the db_owner fixed database role.

To grant, deny, or revoke permission on the specified user to other users, users must have CONTROL permission on the specified user.

Thread Safety

Todos los miembros estáticos (compartidos en Microsoft Visual Basic) públicos de este tipo son seguros para operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Ejemplos

Administrar usuarios, roles e inicios de sesión

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

Espacio de nombres Microsoft.SqlServer.Management.Smo

Otros recursos

CREATE USER (Transact-SQL)