User-Klasse
Stellt einen Benutzer in Microsoft SharePoint Foundation an.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Client.ClientObject
Microsoft.SharePoint.Client.Principal
Microsoft.SharePoint.Client.User
Namespace: Microsoft.SharePoint.Client
Assemblys: Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (in Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)
Syntax
'Declaration
Public NotInheritable Class User _
Inherits Principal
'Usage
Dim instance As User
public sealed class User : Principal
Hinweise
Verwenden Sie die Eigenschaft AllUsers der Klasse Web , um alle Benutzer einer Website zurückzugeben. Umfasst Benutzern Berechtigungen direkt erteilt Benutzern Berechtigungen über eine Gruppe aus, klicken Sie dann auf die Site besucht haben, und Benutzer, die in einem Feld Person, wie etwa eine Aufgabe zugewiesen wird verwiesen wurde. Aufrufen der AllUsers[name] löst eine Ausnahme, wenn der Benutzer nicht vorhanden ist.
Verwenden Sie die Eigenschaft SiteUsers der Klasse Web , um alle Benutzer in der Websitesammlung zurückzugeben.
Verwenden Sie die GetAllAuthenticatedUsers -Methode der Klasse Utility , um alle authentifizierten Benutzer einer Website zurückzukehren.
Verwenden Sie die GetUniqueUsers Methode der SPAlertCollection -Klasse, um eine Liste von Benutzern für eine Auflistung von Benachrichtigungen zurückzukehren.
Verwenden Sie andernfalls die Eigenschaft Users der Klasse Group oder Web , um die Benutzer in einer Gruppe oder Website zurückzugeben.
Verwenden Sie einen Indexer, um einen einzelnen Benutzer aus der Auflistung zurückzugeben. Beispielsweise die Sammlung einer Variablen namens collUserszugewiesen ist, verwenden Sie collUsers[index] in c#, oder collUsers(index) in Visual Basic index Wo finde ich die Anzahl Index des Benutzers in der Auflistung oder der Benutzername des Benutzers.
Jeder Benutzer verfügt über eine eindeutige Element-ID (ID -Eigenschaft), verfügt über die Berechtigungen, die die Mitgliedschaft zugeordnet und von einem Objekt SPMember dargestellt werden kann. Im 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 Sicherheit finden Sie unter Security, Users, and Groups in Windows SharePoint Services.
Beispiele
In diesem Codebeispiel addiert den aktuellen Benutzer zur Gruppe Besucher der aktuellen Website an.
using System;
using Microsoft.SharePoint.Client;
namespace Microsoft.SDK.SharePointFoundation.Samples
{
class UserExample
{
static void Main()
{
string siteUrl = "http://MyServer/sites/MySiteCollection";
ClientContext clientContext = new ClientContext(siteUrl);
Web site = clientContext.Web;
GroupCollection collGroup = site.SiteGroups;
// Get the visitors group, assuming its ID is 4.
Group visitorsGroup = collGroup.GetById(4);
User currentUser = site.CurrentUser;
UserCollection collUser = visitorsGroup.Users;
collUser.AddUser(currentUser);
clientContext.Load(currentUser);
clientContext.Load(visitorsGroup);
clientContext.ExecuteQuery();
Console.WriteLine(currentUser.Title + " added to group " + visitorsGroup.Title);
}
}
}
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.