ReportingService2010.CreateRole(String, String, String[]) Méthode

Référence

Définition

Espace de noms:: ReportService2010

Assembly:: ReportService2010.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un nouveau rôle à la base de données du serveur de rapports. Cette méthode ne s'applique qu'au mode natif.

public:
 void CreateRole(System::String ^ Name, System::String ^ Description, cli::array <System::String ^> ^ TaskIDs);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateRole", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public void CreateRole (string Name, string Description, string[] TaskIDs);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateRole", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.CreateRole : string * string * string[] -> unit

Public Sub CreateRole (Name As String, Description As String, TaskIDs As String())

Paramètres

Name: String

Nom du nouveau rôle. La valeur de ce paramètre doit comprendre entre 1 et 260 caractères.

Description: String

Description du nouveau rôle. La valeur de ce paramètre doit comprendre entre 1 et 512 caractères.

TaskIDs: String[]

Tableau d'ID de tâche qui représente les tâches à définir pour le rôle.

Attributs: SoapDocumentMethodAttribute SoapHeaderAttribute

Exemples

Pour compiler cet exemple de code, vous devez référencer le Reporting Services WSDL et importer certains espaces de noms. Pour plus d’informations, consultez Compilation et exécution d’exemples de code. L’exemple de code suivant utilise la CreateRole méthode pour créer un rôle d’utilisateur disposant des autorisations d’affichage des dossiers et des rapports :

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Try   
         Dim name As String = "Report Browser"   
         Dim desc As String = "View folders and reports."   

         Dim tasks As Task() = rs.ListTasks("All")    
         Dim taskIDs As New List(Of String)()    

         For Each t As Task In tasks    
            taskIDs.Add(t.TaskID)    
         Next   

         rs.CreateRole(name, desc, taskIDs.ToArray())  
      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  
   End Sub 'Main  
End Class 'Sample

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
     ReportingService2010 rs = new ReportingService2010();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      try  
      {  
         string name = "Report Browser";  
       string desc = "View folders and reports.";  

         Task[] tasks = rs.ListTasks("All");  
         List<string> taskIDs = new List<string>();  

         foreach (Task t in tasks)  
         {  
            taskIDs.Add(t.TaskID);  
         }  

         rs.CreateRole(name, desc, taskIDs.ToArray());  
      }  
      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.InnerXml.ToString());  
      }  
  }  
}

Remarques

Le tableau suivant présente les informations relatives aux en-têtes et aux autorisations sur cette opération.


Utilisation de l’en-tête SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Autorisations requises en mode natif	CreateRoles (Système)
Mode SharePoint Autorisations requises	Non prise en charge

Cette méthode lève une exception lorsqu’elle OperationNotSupportedSharePointMode est appelée en mode SharePont.

Les Name paramètres et Description sont obligatoires et ne doivent pas être définis sur null (Nothing en Visual Basic). La valeur de Name doit être unique.

Vous devez affecter au moins une tâche au rôle. Vous ne pouvez pas combiner les tâches au niveau du système et au niveau élément au sein d’un rôle unique. Pour plus d’informations sur les tâches, consultez Tâches et autorisations.

S’applique à

Partager via