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.XmlNodeUn 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);