SPGroupCollection.Add method

Adiciona um grupo à coleção de grupos em um conjunto de sites.

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

Syntax

'Declaração
Public Sub Add ( _
    name As String, _
    owner As SPMember, _
    defaultUser As SPUser, _
    description As String _
)
'Uso
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
)

Parâmetros

• name
  Type: System.String

  Uma seqüência de caracteres que representa o nome do novo grupo.

• owner
  Type: Microsoft.SharePoint.SPMember

  Um objeto de SPMember que especifica o proprietário.

• defaultUser
  Type: Microsoft.SharePoint.SPUser

  Um objeto de SPUser que especifica o usuário padrão para o grupo.

• description
  Type: System.String

  Uma seqüência de caracteres que contém uma descrição para o grupo.

Exceptions

Exception	Condition
ArgumentException	owner é null .
SPException	A coleção de grupo é somente leitura. - ou - O proprietário é um grupo de domínio ou função. - ou - O grupo não é um grupo de nível de site.

Examples

O exemplo de código a seguir cria um grupo no conjunto de sites atual.

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

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPGroupCollection class

SPGroupCollection members

Microsoft.SharePoint namespace