SPGroupCollection class

發行項
05/05/2015

表示SPGroup物件的集合。

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.SPBaseCollection
      Microsoft.SharePoint.SPMemberCollection
        Microsoft.SharePoint.SPGroupCollection

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

Syntax

'宣告
Public Class SPGroupCollection _
    Inherits SPMemberCollection
'用途
Dim instance As SPGroupCollection

public class SPGroupCollection : SPMemberCollection

備註

您可以使用SPUser類別或SPWeb類別的Groups屬性，傳回使用者或網站群組的集合。否則，使用OwnedGroups SPUser類別屬性，傳回由使用者所擁有的群組或SPWeb類別的SiteGroups屬性，傳回所有群組網站集合中。

若要建立網站集合中的群組，請使用Add方法。

使用索引子，傳回單一群組從群組的集合。例如，假設集合指派給變數，名為collGroups ，使用在 C# 的collGroups[index]或Microsoft Visual Basic，在collGroups(index)index所在集合中群組的索引編號，或者是群組的名稱。

Examples

下列程式碼範例會逐一查看網站集合中的所有群組，並刪除指定使用者所擁有的所有群組。

Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Try
    Dim users As SPUserCollection = webSite.Users
    Dim user As SPUser = webSite.Users("User_Name")
 
    Dim webGroups As SPGroupCollection = webSite.SiteGroups
    Dim userGroups As SPGroupCollection = user.OwnedGroups
 
    Dim userGroup As SPGroup
    For Each userGroup In  userGroups
        webGroups.RemoveByID(userGroup.ID)
    Next userGroup
Finally
    webSite.Dispose()
End Try

using (SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb)
{
    SPUserCollection collUsers = oWebsiteRoot.Users;
    SPUser oUser = oWebsiteRoot.Users["User_Name"];

    SPGroupCollection collGroupsWebsite = oWebsiteRoot.SiteGroups;
    SPGroupCollection collGroupsUser = oUser.OwnedGroups;

    foreach (SPGroup oUserGroup in collGroupsUser)
    {
        collGroupsWebsite.RemoveByID(oUserGroup.ID);
    }
}

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