SPGroupCollection.Add method

將群組新增至網站集合中的群組集合。

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

Syntax

'宣告
Public Sub Add ( _
    name As String, _
    owner As SPMember, _
    defaultUser As SPUser, _
    description As String _
)
'用途
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
)

參數

• name
  Type: System.String

  字串，表示新的群組名稱。

• owner
  Type: Microsoft.SharePoint.SPMember

  指定擁有者的SPMember物件。

• defaultUser
  Type: Microsoft.SharePoint.SPUser

  指定預設的使用者群組的SPUser物件。

• description
  Type: System.String

  字串，包含群組的描述。

Exceptions

Exception	Condition
ArgumentException	owner是 null 。
SPException	群組集合是唯讀的。 -或- 擁有者為角色或網域群組。 -或- 群組不是站台層級群組。

Examples

下列程式碼範例會建立群組，在目前的網站集合。

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

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

請參閱

參照

SPGroupCollection class

SPGroupCollection members

Microsoft.SharePoint namespace