ReportingService2010.CreateRole(String, String, String[]) Metodo

Definizione

Aggiunge un nuovo ruolo al database del server di report. Questo metodo si applica solo alla modalità nativa.

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())

Parametri

Name
String

Il nome del nuovo ruolo. Il valore di questo parametro deve essere lungo tra 1 e 260 caratteri.

Description
String

Una descrizione del nuovo ruolo. Il valore di questo parametro deve essere lungo tra 1 e 512 caratteri.

TaskIDs
String[]

Una serie di ID di compiti che rappresentano i compiti da impostare per il ruolo.

Attributi

Esempio

Per compilare questo esempio di codice, devi fare riferimento al WSDL di Reporting Services e importare determinati namespace. Per maggiori informazioni, vedi Compiling and Conducting Code Examples. Il seguente esempio di codice utilizza il CreateRole metodo per creare un ruolo utente che ha permessi per visualizzare cartelle e report:

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());  
      }  
  }  
}  

Commenti

La tabella sottostante mostra informazioni sull'intestazione e sui permessi di questa operazione.

Utilizzo dell'intestazione SOAP (Dentro) TrustedUserHeaderValue

(Fuori) ServerInfoHeaderValue
Permessi richiesti per la modalità nativa CreateRoles (Sistema)
Permessi richiesti in modalità SharePoint Non supportato

Questo metodo genera un'eccezione OperationNotSupportedSharePointMode quando viene invocato in modalità SharePont.

I Name parametri e Description sono necessari e non dovrebbero essere impostati su null (Nothing in Visual Basic). Il valore di Name deve essere unico.

Devi assegnare almeno un compito al ruolo. Non puoi combinare compiti a livello di sistema e a livello di oggetto in un unico ruolo. Per maggiori informazioni sui compiti, vedi Compiti e Permessi.

Si applica a