SPGroupCollection.Add-Methode
Fügt der Sammlung von Gruppen in der Websitesammlung eine Gruppe hinzu.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Sub Add ( _
name As String, _
owner As SPMember, _
defaultUser As SPUser, _
description As String _
)
'Usage
Dim instance As SPGroupCollection
Dim name As String
Dim owner As SPMember
Dim defaultUser As SPUser
Dim description As String
instance.Add(name, owner, defaultUser, _
description)
public void Add(
string name,
SPMember owner,
SPUser defaultUser,
string description
)
Parameter
name
Typ: System.StringEine Zeichenfolge, die den neuen Namen darstellt.
owner
Typ: Microsoft.SharePoint.SPMemberEin SPMember -Objekt, das den Besitzer angibt.
defaultUser
Typ: Microsoft.SharePoint.SPUserEin SPUser -Objekt, das den Standardbenutzer für die Gruppe angibt.
description
Typ: System.StringEine Zeichenfolge, die eine Beschreibung für die Gruppe enthält.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | owner ist Null . |
| SPException | Die Gruppenauflistung ist schreibgeschützt. -ODER- Der Besitzer ist eine Rolle oder Domäne. -ODER- Die Gruppe ist keine Gruppe auf Standortebene. |
Beispiele
Das folgende Codebeispiel erstellt eine Gruppe in der aktuellen Websitesammlung.
Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Try
Dim groups As SPGroupCollection = webSite.SiteGroups
Dim user As SPUser = webSite.Users("User_Name")
Dim member As SPMember = webSite.Users("User_Name")
groups.Add("Group_Name", member, user, "Description")
Finally
webSite.Dispose()
End Try
using (SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb)
{
SPGroupCollection collGroups = oWebsiteRoot.SiteGroups;
SPUser oUser = oWebsiteRoot.Users["User_Name"];
SPMember oMember = oWebsiteRoot.Users["User_Name"];
collGroups.Add("Group_Name", oMember, oUser, "Description");
}
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.