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.