Gewusst wie: Erstellen von Mitgliedschaften

Letzte Änderung: Mittwoch, 27. Januar 2010

Gilt für: SharePoint Server 2010

In Microsoft SharePoint Server 2010 werden zwei Typen von Mitgliedschaften unterstützt: Verteilerlistenmitgliedschaften (Distribution List, DL) und Windows SharePoint Services-Websitemitgliedschaften. DL-Mitgliedschaftsinformationen werden vom Active Directory-Verzeichnisdienst abgerufen, während die Windows SharePoint Services-Websitemitgliedschaftsinformationen durch Abrufen der Mitgliedschaftsinformationen von der SharePoint-Website bezogen werden. Auf der öffentlichen Seite "Meine Website" eines Benutzers (Profilseite genannt) werden u. a. die Mitgliedschaften eines Benutzers sowie die Mitgliedschaften, die der Benutzer und der anzeigende Benutzer gemeinsam haben, angezeigt.

Durch das Benutzerprofile-Objektmodell werden Klassen und Methoden zur Unterstützung der neuen Mitgliedschaftsfunktionen hinzugefügt. Die folgenden Vorgänge werden von den neuen Klassen und Methoden im Benutzerprofile-Objektmodell unterstützt:

• Abrufen von Benutzermitgliedschaften

• Festlegen der Datenschutzeinstellungen für Benutzermitgliedschaften

• Abrufen der gemeinsamen Mitgliedschaften zweier Benutzer

• Aufzählen von Mitgliedergruppen

• Erweitern der neuen Mitgliedschaft und Hinzufügen neuer Mitgliedschaften über das Objektmodell

Membership ist ein Objekt erster Klasse im Benutzerprofile-Objektmodell. Sie können über das UserProfile-Objekt zu den Mitgliedschaften gelangen.

Das MemberGroup-Objekt definiert eine Verteilerliste oder eine Windows SharePoint Services-Website oder eine sonstige neue Mitgliedergruppe, die Sie mithilfe des Objektmodells erstellen. Es definiert eine URL-Eigenschaft, die im Falle einer Verteilerliste die Archivadresse (die mailto-Verknüpfung) oder im Falle des MemberGroup-Objekts eine Windows SharePoint Services-Website-URL darstellt. Die SourceReference-Eigenschaft gibt das DirectoryEntry-Objekt der Verteilerliste von Active Directory oder die Objekte SPWeb oder SPSite, abhängig vom MemberGroup-Objekt, zurück.

Mithilfe der UserProfileManager-Klasse werden Methoden zum Zurückgeben von Mitgliedergruppendefinitionen und zum Erstellen neuer Mitgliedschaftstypen hinzugefügt.

Im folgenden Beispiel wird eine neue Mitgliedergruppe erstellt und der neu erstellten Gruppe ein Mitglied hinzugefügt. Ersetzen Sie vor der Verwendung des Codebeispiels servername, domainname, username und sonstige Platzhalter durch tatsächliche Werte. Fügen Sie Ihrem Microsoft Visual Studio-Projekt zudem Verweise auf Folgendes hinzu:

• Microsoft.Office.Server

• Microsoft.Office.Server.UserProfiles

• Microsoft.SharePoint

• System.Web

Beispiel

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Office.Server;
using Microsoft.Office.Server.Administration;
using Microsoft.Office.Server.UserProfiles;
using Microsoft.SharePoint;
using System.Web;

namespace UserProfilesApp
{
    class Program
    {
        static void Main(string[] args)
        {

            using (SPSite site = new SPSite("https://servername"))
            {
                   SPServiceContext context = 
                       SPServiceContext.GetContext(site);
                  UserProfileManager profileManager = 
                      new UserProfileManager(context);
                
                //Create a member group
                 MemberGroup newGroup = 
                     profileManager.GetMemberGroups().
                     CreateMemberGroup(PrivacyPolicyIdConstants.
                     MembershipsFromDistributionLists, 
                     "Customer Connection Team","Customer Connection VTeam","Customer Connection","http://example","abcd");
               
                //Create a membership
                 string sAccount = "domainname\\username";
                UserProfile u = profileManager.GetUserProfile(sAccount);
                u.Memberships.Create(newGroup,
                    MembershipGroupType.UserSpecified, 
                    "Customer Connection Team", Privacy.Organization);
               }
            }

        }
    }

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Benutzerprofilen und Organisationsprofilen