SP. User-Objekt (sp.js)

Stellt einen Benutzer in spfnvlongMicrosoft SharePoint Foundation dar.

**Letzte Änderung:**Montag, 9. März 2015

**Gilt für:**apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

var object = new SP.User()

Elemente

Das User -Objekt verfügt über die folgenden Elemente.

• Konstruktor

• Methoden

• Eigenschaften

Konstruktor

Das User -Objekt hat den folgenden Konstruktor.

Konstruktor	Beschreibung
Benutzer	Ruft einen Wert ab, der den Anzeigenamen der Datei angibt.

Methoden

Das User -Objekt hat die folgenden Methoden.

Methode	Beschreibung
initPropertiesFromJson
Aktualisieren	Aktualisiert den Benutzer mit Änderungen, die für die Benutzereigenschaften vorgenommen wurden.

Eigenschaften

Das User -Objekt hat die folgenden Eigenschaften.

Eigenschaft	Beschreibung
E-Mail	Dient zum Abrufen oder Festlegen der E-Mail-Adresse des Benutzers.
Gruppen	Ruft die Auflistung von Gruppen ab, deren Mitglied der Benutzer ist.
isSiteAdmin	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Benutzer ein Websitesammlungsadministrator ist.
userId	Ruft die Informationen des Benutzers ab, der den Namensbezeichner des Benutzers und den Aussteller des Namensbezeichners des Benutzers enthält.

Beispiel

Das folgende Beispiel erstellt eine Schaltfläche input auf einer Anwendungsseite, die den aktuellen Benutzer der Gruppe Besucher auf der aktuellen Website hinzufügt.

<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">

var user;
var visitorsGroup;

function runCode() {

     var clientContext = new SP.ClientContext();
     var groupCollection = clientContext.get_web().get_siteGroups();
     // Get the visitors group, assuming its ID is 4.
     visitorsGroup = groupCollection.getById(4);
     user = clientContext.get_web().get_currentUser();
     var userCollection = visitorsGroup.get_users();
     userCollection.addUser(user);

     clientContext.load(user);
     clientContext.load(visitorsGroup);
     clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));

}

function onQuerySucceeded() {
    alert(user.get_title() + " added to group " + visitorsGroup.get_title());
}

function onQueryFailed(sender, args) {
    alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
}

</script>

    <input id="Button1" type="button" value="Run Code" onclick="runCode()" />

</asp:Content>

REST-Ressourcenendpunkt

Weitere Informationen finden Sie unter User-Ressource .

Endpunkt-URI-Struktur

http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

HTTP-Anforderungen

Diese Ressource unterstützt die folgenden HTTP-Befehle:

• Delete

DELETE-Syntax

DELETE http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

MERGE-Syntax

MERGE http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

POST-Syntax

POST http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)

PUT-Syntax

PUT http://<sitecollection>/<site>/_api/web/sitegroups(groupid)/users(loginname)