Compartir a través de


del método SPGroupCollection.Add

Agrega un grupo a la colección de grupos de una colección de sitios.

Espacio de nombres:  Microsoft.SharePoint
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
    Tipo: System.String

    Una cadena que representa el nombre del nuevo grupo.

  • description
    Tipo: System.String

    Una cadena que contiene una descripción para el grupo.

Excepciones

Excepción Condición
ArgumentException

owner es nulo .

SPException

La colección de grupos es de sólo lectura.

o

El propietario es un grupo de roles o dominio.

o

El grupo no es un grupo de nivel de sitio.

Ejemplos

En el ejemplo de código siguiente se crea un grupo en la colección de sitios actual.

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

Nota

Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.

Vea también

Referencia

clase SPGroupCollection

Miembros SPGroupCollection

Espacio de nombres Microsoft.SharePoint