Procédure : ajouter des utilisateurs à un groupe

Article
09/24/2014

Dernière modification : mercredi 7 juillet 2010

S’applique à : SharePoint Foundation 2010

Pour ajouter plusieurs utilisateurs à un groupe dans Microsoft SharePoint Foundation, utilisez la méthode AddUserToGroup lorsque vous ajoutez des utilisateurs nouveaux ou existants, ou la méthode AddUserCollectionToGroup lorsque vous ajoutez une collection d’utilisateurs existants.

Procédures

Avant de commencer, créez une application Windows Forms dans Microsoft Visual Studio. Pour obtenir des informations sur la définition d’une référence Web vers un service Web SharePoint Foundation, voir Conseils d'utilisation des services Web.

Ajout de plusieurs utilisateurs à partir d'un site ou d'un sous-site

Utilisez la méthode GetUserCollectionFromSite ou GetUserCollectionFromWeb pour retourner tous les utilisateurs à partir d’un site Web. Ensuite, itérez la collection d’utilisateurs et ajoutez chacun d’eux à un groupe spécifié à l’aide de la méthode AddUserCollectionToGroup.

Pour ajouter des utilisateurs à un groupe à partir d'un site ou d'un sous-site

Après avoir créé un projet d’application Windows Forms et ajouté une référence Web, ouvrez Formulaire1 en mode Création, ouvrez la Boîte à outils, puis faites glisser un contrôle Button jusqu’au formulaire.

Double-cliquez sur le bouton pour afficher l’éditeur de code, puis ajoutez les lignes de code suivantes au gestionnaire d’événements Button1_Click :

'Declare and initialize a variable for the UserGroup Web service.
Dim userGroup As New Web_Reference.UserGroup()

'Authenticate the current user by passing their default 
'credentials to the Web service from the system credential cache and, 
'if adding users from a subsite, set the Url property for the 
'service.
userGroup.Credentials = System.Net.CredentialCache.DefaultCredentials
userGroup.Url = "http://Server_Name/Subsite_Name/_vti_bin/UserGroup.asmx"

'Declare an XmlNode object and initialize it with the XML response 
'from either the GetUserCollectionFromWeb method or the 
'GetUserCollectionFromSite method.
Dim usersSite As System.Xml.XmlNode = userGroup.GetUserCollectionFromWeb()

'Declare another XmlNode object and initialize it with the first 
'child node returned from the previous method.
Dim userNode As System.Xml.XmlNode = usersSite.FirstChild

'Pass the first child node and its contents as the XMLNode object 
'parameter for the method.
userGroup.AddUserCollectionToGroup("Group_Name", userNode)

/*Declare and initialize a variable for the UserGroup Web service.*/
Web_Reference.UserGroup userGroup = new Web_Reference.UserGroup();

/*Authenticate the current user by passing their default 
credentials to the Web service from the system credential cache and, 
if adding users from a subsite, set the Url property for the 
service.*/
userGroup.Credentials = 
   System.Net.CredentialCache.DefaultCredentials;
userGroup.Url = 
   "http://Server_Name/Subsite_Name/_vti_bin/UserGroup.asmx";

/*Declare an XmlNode object and initialize it with the XML response 
from either the GetUserCollectionFromWeb method or the 
GetUserCollectionFromSite method*/
System.Xml.XmlNode usersSite = userGroup.GetUserCollectionFromWeb();

/*Declare another XmlNode object and initialize it with the first 
child node returned from the previous method.*/
System.Xml.XmlNode userNode = usersSite.FirstChild;

/*Pass the first child node and its contents as the XmlNode object 
parameter for the method.*/
userGroup.AddUserCollectionToGroup
   ("Group_Name",userNode);

Dans le menu Débogage, cliquez sur Démarrer le débogage pour tester le formulaire. Cliquez sur le bouton dans le formulaire pour ajouter les utilisateurs au groupe spécifié.

Ajout d'un utilisateur unique

Utilisez la méthode AddUserToGroup pour ajouter un utilisateur nouveau ou existant à un groupe, et utilisez la méthode GetUserCollectionFromGroup pour retourner des informations sur tous les utilisateurs d’un groupe.

Pour ajouter un utilisateur unique à un groupe et afficher les membres du groupe

Créez une application Windows Forms, ajoutez une référence Web et ajoutez cinq contrôles TextBox, un contrôle Label et un contrôle Button au formulaire.

Double-cliquez sur le bouton pour afficher l’éditeur de code, puis ajoutez les lignes de code suivantes au gestionnaire d’événements Button1_Click :

'Declare and initialize a variable for the UserGroup Web service, 
'and authenticate the current user by passing their default 
'credentials to the Web service from the system credential cache.
Dim userGroup As New Web_Reference.UserGroup()
userGroup.Credentials = System.Net.CredentialCache.DefaultCredentials

'Gather data from the text boxes.
Dim groupName As String = textBox1.Text
Dim userName As String = textBox2.Text
Dim userLoginName As String = textBox3.Text
Dim userEmail As String = textBox4.Text
Dim userNotes As String = textBox5.Text

'Add the specified user to the group. 
userGroup.AddUserToGroup(groupName, userName, userLoginName, userEmail, userNotes)

'Declare an XmlNode object and initialize it with the 
'XML response from the GetUserCollectionFromGroup method, 
'declare a second XmlNode object and initialize it with 
'the first child of the first node returned, and then 
'declare and initialize an XmlNodeList object with the 
'child nodes of the second node.
Dim usersNode1 As System.Xml.XmlNode = userGroup.GetUserCollectionFromGroup(groupName)
Dim usersNode2 As System.Xml.XmlNode = usersNode1.FirstChild
Dim userNodes As System.Xml.XmlNodeList = usersNode2.ChildNodes

'Iterate through the collection of user nodes and 
'parse out the Name, LoginName, Email, and Notes 
'attribute values for each item and 
'then display the values returned.
Dim user As System.Xml.XmlNode
For Each user In  userNodes
   Dim name As String = user.Attributes("Name").Value
   Dim loginName As String = user.Attributes("LoginName").Value
   Dim email As String = user.Attributes("Email").Value
   Dim notes As String = user.Attributes("Notes").Value

   label1.Text += ControlChars.Lf + ControlChars.Lf + name + " : " 
      + loginName + " : " + email + " : " + notes
Next user

/*Declare and initialize a variable for the UserGroup Web service, 
and authenticate the current user by passing their default 
credentials to the Web service from the system credential cache*/
Web_Reference.UserGroup userGroup = new Web_Reference.UserGroup();
userGroup.Credentials = 
   System.Net.CredentialCache.DefaultCredentials;

/*Gather data from the text boxes.*/
string groupName = textBox1.Text;
string userName = textBox2.Text;
string userLoginName = textBox3.Text;
string userEmail = textBox4.Text;
string userNotes = textBox5.Text;

/*Add the specified user to the group. */
userGroup.AddUserToGroup(groupName, userName, userLoginName, 
   userEmail, userNotes);

/*Declare an XmlNode object and initialize it with the XML response 
from the GetUserCollectionFromGroup method, declare a second XmlNode 
object and initialize it with the first child of the first node 
returned, and then declare and initialize an XmlNodeList object with 
the child nodes of the second node.*/
System.Xml.XmlNode usersNode1 = 
   userGroup.GetUserCollectionFromGroup(groupName);
System.Xml.XmlNode usersNode2 = usersNode1.FirstChild;
System.Xml.XmlNodeList userNodes = usersNode2.ChildNodes;

/*Iterate through the collection of user nodes and parse out the 
Name, LoginName, Email, and Notes attribute values for each item and 
then display the values returned.*/
foreach (System.Xml.XmlNode user in userNodes)
{
    string name = user.Attributes["Name"].Value;
    string loginName = user.Attributes["LoginName"].Value;
    string email = user.Attributes["Email"].Value;
    string notes = user.Attributes["Notes"].Value;

    label1.Text += "\n\n" + name + " : " + loginName + " : " + email 
        + " : " + notes;
}

Dans le menu Débogage, cliquez sur Démarrer le débogage pour tester le formulaire. Cliquez sur le bouton dans le formulaire pour ajouter l’utilisateur au groupe spécifié et afficher les membres du groupe.

Ajout d'utilisateurs à partir des informations contenues dans un fichier XML

Chargez la collection de données utilisateur dans un objet DataSet, puis utilisez la méthode AddUserToGroup pour itérer la collection et ajouter chaque utilisateur au groupe.

Pour ajouter des utilisateurs à un groupe à partir des informations contenues dans un fichier XML

Créez une application Windows Forms, ajoutez une référence Web et ajoutez un contrôle TextBox et un contrôle Button au formulaire.

Double-cliquez sur le bouton pour afficher l’éditeur de code, puis ajoutez les lignes de code suivantes au gestionnaire d’événements Button1_Click :

'Declare and initialize a variable for the UserGroup Web service, 
'and authenticate the current user by passing their default 
'credentials to the Web service from the system credential cache.
Dim userGroup As New Web_Reference.UserGroup()
userGroup.Credentials = System.Net.CredentialCache.DefaultCredentials

'Instantiate a DataSet control, declare and initialize a string 
'specifying the full path to the XML file to use as a source.
Dim dataSet As New DataSet()
Dim xmlPath As String = "Full_Path_To_XML_File"

'Read the data from the XML file into the dataset object.
dataSet.ReadXml(xmlPath)

'Declare a variable for the group name typed in the text box.
Dim groupName As String = textBox1.Text

'Iterate through each row in the DataSet object, assign their 
'values to variables for each parameter, and add each user to the 
'specified group.
Dim row As DataRow
For Each row In  dataSet.Tables(0).Rows
   Dim userName As String = row("name").ToString()
   Dim userLoginName As String = row("loginname").ToString()
   Dim userEmail As String = row("email").ToString()
   Dim userNotes As String = row("notes").ToString()

   userGroup.AddUserToGroup(groupName, userName, userLoginName, userEmail, userNotes)
Next row

/*Declare and initialize a variable for the UserGroup Web service, 
and authenticate the current user by passing their default 
credentials to the Web service from the system credential cache.*/
Web_Reference.UserGroup userGroup = new Web_Reference.UserGroup();
userGroup.Credentials = 
    System.Net.CredentialCache.DefaultCredentials;

/*Instantiate a DataSet control, declare and initialize a string 
specifying the full path to the XML file to use as a source.*/
DataSet dataSet = new DataSet();
string xmlPath = "Full_Path_To_XML_File";

/*Read the data from the XML file into the DataSet object.*/
dataSet.ReadXml(xmlPath);

/*Declare a variable for the group name typed in the text box.*/
string groupName = textBox1.Text;

/*Iterate through each row in the DataSet object, assign their 
values to variables for each parameter, and add each user to the 
specified group.*/
foreach (DataRow row in dataSet.Tables[0].Rows)
{
    string userName = row["name"].ToString();
    string userLoginName = row["loginname"].ToString();
    string userEmail = row["email"].ToString();
    string userNotes = row["notes"].ToString();

    userGroup.AddUserToGroup(groupName, userName, userLoginName, userEmail, userNotes);
}

Dans le menu Débogage, cliquez sur Démarrer le débogage pour tester le formulaire. Cliquez sur le bouton dans le formulaire pour ajouter l’utilisateur au groupe spécifié et afficher les membres du groupe.

Partager via

Procédure : ajouter des utilisateurs à un groupe

Procédures

Ajout de plusieurs utilisateurs à partir d'un site ou d'un sous-site

Pour ajouter des utilisateurs à un groupe à partir d'un site ou d'un sous-site

Ajout d'un utilisateur unique

Pour ajouter un utilisateur unique à un groupe et afficher les membres du groupe

Ajout d'utilisateurs à partir des informations contenues dans un fichier XML

Pour ajouter des utilisateurs à un groupe à partir des informations contenues dans un fichier XML

Ressources supplémentaires