Freigeben über


SPGroupCollection-Klasse

Stellt eine Auflistung von SPGroup -Objekten dar.

Vererbungshierarchie

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

'Declaration
Public Class SPGroupCollection _
    Inherits SPMemberCollection
'Usage
Dim instance As SPGroupCollection
public class SPGroupCollection : SPMemberCollection

Hinweise

Verwenden Sie die Groups -Eigenschaft der SPUser -Klasse oder die SPWeb -Klasse, um die Auflistung der Gruppen für den Benutzer oder einer Website zurückzugeben. Verwenden Sie andernfalls die OwnedGroups -Eigenschaft der SPUser -Klasse, um den Besitz eines Benutzers Gruppen zurückzugeben, oder die SiteGroups -Eigenschaft der SPWeb -Klasse, um alle Gruppen in der Websitesammlung zurückzugeben.

Verwenden Sie die Add -Methode, um eine Gruppe in der Websitesammlung zu erstellen.

Verwenden Sie eine Indexerstellung, um eine einzelne Gruppe aus der Auflistung der Gruppen zurückzugeben. Beispielsweise vorausgesetzt, dass die Auflistung einer Variablen mit dem Namen collGroups zugewiesen wird, verwenden Sie collGroups[index] in c# oder collGroups(index) in Microsoft Visual Basic, wobei index ist, entweder die Indexnummer der Gruppe in der Auflistung oder der Name der Gruppe.

Beispiele

Im folgenden Codebeispiel wird durchlaufen und alle Gruppen in einer Websitesammlung und löscht alle Gruppen, die den angegebenen Benutzer gehören.

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);
    }
}

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, wenn sie nicht mehr benötigt werden. Informationen zu bewährten Codierung finden Sie unter Disposing Objects.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

SPGroupCollection-Member

Microsoft.SharePoint-Namespace