ReportingService2010.CreateRole(String, String, String[]) 方法

  • 參考

定義

命名空間:
ReportService2010
組件:
ReportService2010.dll

將新角色加入至報表伺服器資料庫。 這個方法只適用於原生模式。

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

參數

Name
String

新角色的名稱。 此參數值的長度必須介於 1 到 260 個字元之間。

Description
String

新角色的描述。 這個參數的值長度必須介於 1 到 512 個字元之間。

TaskIDs
String[]

工作識別碼的陣列，表示要為角色設定的工作。

屬性
SoapDocumentMethodAttribute SoapHeaderAttribute

範例

若要編譯這個程式碼範例，您必須參考 Reporting Services WSDL 並匯入特定命名空間。 如需詳細資訊，請參閱 編譯和執行程式碼範例。 下列程式碼範例會使用 CreateRole 方法來建立有權查看資料夾和報表的使用者角色：

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

備註

下表顯示標頭以及有關這項作業的權限資訊。
SOAP 標頭使用方式 (In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
原生模式所需的許可權 CreateRoles (系統)
SharePoint 模式的必要許可權 不支援

在 SharePont 模式中叫用時，這個方法會擲回 OperationNotSupportedSharePointMode 例外狀況。

Name和 Description 參數是必要的，而且不應該設定為 null Nothing Visual Basic) 中的 (。 的值 Name 必須是唯一的。

您至少必須將一個工作指派給該角色。 您無法在單一角色內結合系統層級和專案層級的工作。 如需工作的詳細資訊，請參閱工作 和許可權。

適用於