SPUser-Klasse
Stellt einen Benutzer in Microsoft SharePoint Foundation.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.SPMember
Microsoft.SharePoint.SPPrincipal
Microsoft.SharePoint.SPUser
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public NotInheritable Class SPUser _
Inherits SPPrincipal
'Usage
Dim instance As SPUser
public sealed class SPUser : SPPrincipal
Hinweise
Verwenden Sie die AllUsers -Eigenschaft der SPWeb -Klasse, um alle Benutzer einer Website zurückzugeben. Diese Benutzer Berechtigungen direkt enthält, erteilt Benutzern Berechtigungen über eine Gruppe, die Sie dann die Website besucht haben und für Benutzer, die in einem Feld Person, wie eine Aufgabe zugewiesen wird verwiesen wurde. Aufrufen von AllUsers[name] löst eine Ausnahme, wenn der Benutzer nicht vorhanden ist.
Verwenden Sie die SiteUsers -Eigenschaft der SPWeb -Klasse, um alle Benutzer in der Websitesammlung zurückzugeben.
Verwenden Sie die GetAllAuthenticatedUsers -Methode der SPUtility -Klasse, um alle authentifizierten Benutzer einer Website zurückzugeben.
Verwenden Sie die GetUniqueUsers -Methode der SPAlertCollection -Klasse, um eine Liste von Benutzern für eine Auflistung von Warnungen zurückzugeben.
Andernfalls wird die Users -Eigenschaft der SPGroup oder SPWeb -Klasse verwendet, die Benutzer in einer Gruppe oder Website zurückzugeben.
Verwenden Sie eine Indexerstellung zu einen einzelnen Benutzer aus der Auflistung zurückgegeben. Verwenden Sie beispielsweise, wenn die Auflistung einer Variablen mit dem Namen collUserszugewiesen ist, collUsers[index] in c# oder collUsers(index) in Visual Basic index entweder die Indexnummer des Benutzers in der Auflistung oder den Benutzernamen des Benutzers entspricht.
Jeder Benutzer verfügt über eine eindeutige Element-ID (ID -Eigenschaft), verfügt über die Berechtigungen, die Mitgliedschaft zugeordnet und kann durch ein SPMember -Objekt dargestellt werden. Das folgende Beispiel weist einem Benutzer SPMember Objekts anhand eine angegebene SharePoint-Website:
Dim oWebsite As SPWeb = SPContext.Current.Web
Dim oMember As SPMember = oWebsite.AllUsers("Domain\\User_Alias")
SPWeb oWebsite = SPContext.Current.Web;
SPMember oMember = oWebsite.AllUsers["Domain\\User_Alias"];
Allgemeine Informationen zu Benutzern und der Sicherheit finden Sie unter Security, Users, and Groups in Windows SharePoint Services.
Beispiele
Im folgenden Codebeispiel wird die e-Mail-Adresse, Anzeigename und Notizen für einen angegebenen Benutzer-Objekt geändert.
Dim siteCollection As SPSite = SPControl.GetContextSite(Context)
Dim site As SPWeb = siteCollection.AllWebs("Site_Name")
Dim user As SPUser = site.AllUsers("User_Name")
user.Email = "E-mail_Address"
user.Name = "Display_Name"
user.Notes = "User_Notes"
user.Update()
SPSite oSiteCollection = SPContext.Current.Site;
using (SPWeb oWebsite = oSiteCollection.AllWebs["Website_Name"])
{
SPUser oUser = oWebsite.AllUsers["User_Name"];
oUser.Email = " E-mail_Address";
oUser.Name = " Display_Name";
oUser.Notes = " User_Notes";
oUser.Update();
}
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.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.