Freigeben über


SPGroupCollection.RemoveByID-Methode

Entfernt die Gruppe mit der angegebenen Element-ID aus der Auflistung.

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

Syntax

'Declaration
Public Sub RemoveByID ( _
    id As Integer _
)
'Usage
Dim instance As SPGroupCollection
Dim id As Integer

instance.RemoveByID(id)
public void RemoveByID(
    int id
)

Parameter

  • id
    Typ: System.Int32

    Eine 32-Bit-Ganzzahl, die angibt, die Element-ID der Gruppe entfernt werden soll.

Ausnahmen

Ausnahme Bedingung
SPException

Die Gruppenauflistung ist schreibgeschützt.

Hinweise

Der Wert des Parameters id entspricht der eindeutigen Element-ID für die Gruppe, die der ID -Eigenschaft der SPMember -Klasse entspricht. Verwenden Sie die Remove -Methode, um eine Gruppe an einem angegebenen Index in der Gruppenauflistung zu entfernen.

Beispiele

Im folgenden Codebeispiel werden alle Gruppen, die IDs von 50 bis 100 angegeben, aus der Websitesammlung mit entfernt.

Dim webSite As SPWeb = SPContext.Current.Site.RootWeb
Try
    Dim myGroups As SPGroupCollection = webSite.SiteGroups

    Dim i As Integer
    For i = 50 To 100
        myGroups.RemoveByID(i)
    Next i
Finally
    webSite.Dispose()
End Try
using (SPWeb oWebsiteRoot = SPContext.Current.Site.RootWeb)
{
    SPGroupCollection collGroups = oWebsiteRoot.SiteGroups;

    for (int intIndex=50; intIndex<101; intIndex++)
    {
        collGroups.RemoveByID(intIndex);
    }
}

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.

Siehe auch

Referenz

SPGroupCollection Klasse

SPGroupCollection-Member

Microsoft.SharePoint-Namespace