SPRoleAssignment class

發行項
05/05/2015

在目前的物件上定義的使用者或群組的角色指派。

Inheritance hierarchy

System.Object
Microsoft.SharePoint.SPRoleAssignment

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'宣告
Public NotInheritable Class SPRoleAssignment
'用途
Dim instance As SPRoleAssignment

public sealed class SPRoleAssignment

備註

若要授與使用者或群組權限，可設定保護的內容，您建立角色指派物件、設定使用者或群組的角色指派、新增適當的角色定義，及將物件加入至集合的安全物件的角色指派。

使用RoleAssignments屬性， ISecurableObject介面，或SPList、 SPListItem或SPWeb類別的傳回指定物件的角色指派的集合。

使用索引子來從集合傳回單一項目。例如，如果集合指派給一個名為collRoleAssignments變數中，使用在 C# 的collRoleAssignments[index]或 Visual Basic，其中index是集合中項目的索引編號，或是包含角色定義名稱的字串中的collRoleAssignments(index) 。

Examples

下列程式碼範例會建立新的角色指派的使用者、將新的角色定義加入至角色指派] 中，結合的角色定義，然後新增至 Web 站台的角色指派的集合的 [新增角色指派。

using(SPWeb oWebsite = SPContext.Current.Site.AllWebs["Subsite_Name"])
{
    SPRoleDefinitionCollection collRoleDefinitions = oWebsite.RoleDefinitions;
    SPRoleAssignmentCollection collRoleAssignments = oWebsite.RoleAssignments;

    SPRoleAssignment oRoleAssignment = new 
SPRoleAssignment("DOMAIN\\User_Alias","User_Alias@Somewhere.com","Displ
ay_Name","Notes");

    SPRoleDefinitionBindingCollection collRoleDefinitionBindings = oRoleAssignment.RoleDefinitionBindings;

    collRoleDefinitionBindings.Add(collRoleDefinitions["Role_Definition_Name"]);

    collRoleAssignments.Add(oRoleAssignment);
}

Using oWebsite As SPWeb = SPContext.Current.Site.AllWebs("Subsite_Name")
    Dim collRoleDefinitions As SPRoleDefinitionCollection = oWebsite.RoleDefinitions
    Dim collRoleAssignments As SPRoleAssignmentCollection = oWebsite.RoleAssignments

    Dim oRoleAssignment As New SPRoleAssignment("DOMAIN\User_Alias","User_Alias@Somewhere.com","Displ ay_Name","Notes")

    Dim collRoleDefinitionBindings As SPRoleDefinitionBindingCollection = oRoleAssignment.RoleDefinitionBindings

    collRoleDefinitionBindings.Add(collRoleDefinitions("Role_Definition_Name"))

    collRoleAssignments.Add(oRoleAssignment)
End Using

注意事項
某些物件實作IDisposable介面，並且您必須避免之後不再需要保留這些物件在記憶體中。良好的程式碼撰寫方式的相關資訊，請參閱Disposing Objects。