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.

• owner
  Tipo: Microsoft.SharePoint.SPMember

  Objeto SPMember que especifica el propietario.

• defaultUser
  Tipo: Microsoft.SharePoint.SPUser

  Un objeto SPUser que especifica el usuario predeterminado para el 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