Partager via


UserGroup.GetRoleCollection - Méthode

Renvoie des informations sur la collection spécifiée de définitions de rôles pour le site Web en cours.

Espace de noms :  WebSvcUserGroup
Assembly :  STSSOAP (dans STSSOAP.dll)

Syntaxe

'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/directory/GetRoleCollection", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/directory/",  _
    ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/directory/",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function GetRoleCollection ( _
    roleNamesXml As XmlNode _
) As XmlNode
'Utilisation
Dim instance As UserGroup
Dim roleNamesXml As XmlNode
Dim returnValue As XmlNode

returnValue = instance.GetRoleCollection(roleNamesXml)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/directory/GetRoleCollection", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/directory/", 
    ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/directory/", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode GetRoleCollection(
    XmlNode roleNamesXml
)

Paramètres

  • roleNamesXml
    Type : System.Xml.XmlNode

    Un objet System.Xml.XmlNode qui spécifie un ou plusieurs noms de définition de rôle sous la forme suivante :

Valeur renvoyée

Type : System.Xml.XmlNode
Un fragment XML dans le formulaire suivant qui peut être assigné à un objet System.Xml.XmlNode .

<GetRoleCollection xmlns=
   "https://schemas.microsoft.com/sharepoint/soap/directory/">
   <Roles>
      <Role ID="1073741830" Name="Site_Group1" 
         Description="Description" Type="0" />
      <Role ID="1073741831" Name="Site_Group2" 
         Description="Description" Type="0" />
      .
      .
      .
   </Roles>
</GetRoleCollection>

Exemples

L'exemple de code suivant affiche des informations sur les définitions de rôle spécifié sur un site Web. L'exemple suppose l'existence d'un fichier XML local qui contient les noms des groupes, qui sont chargées dans un objet System.Xml.XmlDocument . Cet exemple suppose qu'un using (Visual C#) ou la directive Imports (Visual Basic) être inclus dans l'espace de noms System.Xml .

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 ndGroupNames As XmlNode = myDocument.DocumentElement

Dim ndGroups As System.Xml.XmlNode = usrgrpService.GetRoleCollection(ndGroupNames)

MessageBox.Show(ndGroups.OuterXml)
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 ndGroupNames = myDocument.DocumentElement;

System.Xml.XmlNode ndGroups = usrgrpService.GetRoleCollection(ndGroupNames);

MessageBox.Show(ndGroups.OuterXml);

Voir aussi

Référence

UserGroup classe

UserGroup - Membres

WebSvcUserGroup - Espace de noms