UserGroup.RemoveUserCollectionFromRole Method

Removes the users with the specified user names from the specified role definition.

Namespace:  [UserGroup Web service]
Web service reference: http://Site/_vti_bin/UserGroup.asmx

Syntax

'Declaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/directory/RemoveUserCollectionFromRole", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/directory/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/directory/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Sub RemoveUserCollectionFromRole ( _
    roleName As String, _
    userLoginNamesXml As XmlNode _
)
'Usage
Dim instance As UserGroup
Dim roleName As String
Dim userLoginNamesXml As XmlNode

instance.RemoveUserCollectionFromRole(roleName, _
    userLoginNamesXml)

[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/directory/RemoveUserCollectionFromRole", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/directory/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/directory/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public void RemoveUserCollectionFromRole(
    string roleName,
    XmlNode userLoginNamesXml
)

Parameters

• roleName
  Type: System.String

  A string that contains the name of the role definition.

• userLoginNamesXml
  Type: System.Xml.XmlNode

  A System.Xml.XmlNode object that contains the user names (DOMAIN\User_Alias) of the users in the following form:

  <Users>
     <User LoginName=
       "Domain\User1_Alias"/>
     <User LoginName=
       "Domain\User2_Alias"/>
     .
     .
     .
  </Users>
  

Examples

The following code example removes a collection of users from a role definition. The example assumes the existence of a local XML file that contains the names of the users, which are loaded into a System.Xml.XmlDocument object. This example requires that a using (Visual C#) or Imports (Visual Basic) directive be included for the System.Xml namespace.

Dim usrgrpService As New Web_Reference_Folder_Name.UserGroup()
usrgrpService.Credentials = System.Net.CredentialCache.DefaultCredentials

Dim myDocument As New XmlDocument()
myDocument.Load("C:\File_Name.xml")

Dim ndUsers As XmlNode = myDocument.DocumentElement

usrgrpService.RemoveUserCollectionFromRole("Group_Name", ndUsers)

Web_Reference_Folder_Name.UserGroup usrgrpService = new Web_Reference_Folder_Name.UserGroup();
usrgrpService.Credentials= System.Net.CredentialCache.DefaultCredentials;

XmlDocument myDocument = new XmlDocument();
myDocument.Load("C:\\File_Name.xml");

XmlNode ndUsers = myDocument.DocumentElement;

usrgrpService.RemoveUserCollectionFromRole("Group_Name", ndUsers);

See Also

Reference

UserGroup Class

UserGroup Members

UserGroup Web Service