ReportingService2005.CreateRole(String, String, Task[]) 方法

此頁面有所助益嗎？

還有其他意見反應嗎？

系統會將意見反應傳送給 Microsoft：按下 [提交] 按鈕，您的意見反應將用來改善 Microsoft 產品和服務。 隱私權原則。

定義

命名空間:

ReportService2005

組件:

ReportService2005.dll

將新角色加入至報表伺服器資料庫。

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

public void CreateRole (string Name, string Description, ReportService2005.Task[] Tasks);

member this.CreateRole : string * string * ReportService2005.Task[] -> unit

Public Sub CreateRole (Name As String, Description As String, Tasks As Task())

參數

Name

String

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

Description

String

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

Tasks

Task[]

Task 物件的陣列，表示要為角色設定的工作。 只提交 TaskID 物件的 Task 屬性以建立角色。

範例

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

Imports System  
Imports System.Web.Services.Protocols  

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

      Dim name As String = "Report Browser"  
      Dim desc As String = "View folders and reports."  
      Dim setTasks(2) As Task  
      setTasks(0) = New Task()  
      setTasks(1) = New Task()  
      setTasks(2) = New Task()  

      Try  
         Dim returnedTasks As Task() = rs.ListTasks()  

         Dim t As Task  
         For Each t In  returnedTasks  
            If t.Name = "View reports" Then  
               setTasks(0) = t  

            Else  
               If t.Name = "View folders" Then  
                  setTasks(1) = t  

               Else  
                  If t.Name = "View resources" Then  
                     setTasks(2) = t  
                  End If  
               End If  
            End If   
         Next t  
         rs.CreateRole(name, desc, setTasks)  

      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()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      string name = "Report Browser";  
      string desc = "View folders and reports.";  
      Task[] setTasks = new Task[3];  
      setTasks[0] = new Task();  
      setTasks[1] = new Task();  
      setTasks[2] = new Task();  

      try  
      {  
         Task[] returnedTasks = rs.ListTasks();  

         foreach( Task t in returnedTasks )  
         {  
            if ( t.Name == "View reports" )  
            {  
               setTasks[0] = t;  
            }  

            else if ( t.Name == "View folders" )  
            {  
               setTasks[1] = t;  
            }  

            else if ( t.Name == "View resources" )  
            {  
               setTasks[2] = t;  
            }  
         }  

         rs.CreateRole( name, desc, setTasks );  
      }  

      catch ( SoapException e )  
      {  
         Console.WriteLine( e.Detail.InnerXml.ToString() );  
      }  
   }  
}  

備註

下表顯示標頭以及有關這項作業的權限資訊。

SOAP 標頭	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
必要權限	CreateRoles (系統)

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

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