ReportingService2005.CreateRole(String, String, Task[]) ReportingService2005.CreateRole(String, String, Task[]) ReportingService2005.CreateRole(String, String, Task[]) Method


보고서 서버 데이터베이스에 새 역할을 추가합니다. Adds a new role to the report server database.

 void CreateRole(System::String ^ Name, System::String ^ Description, cli::array <ReportService2005::Task ^> ^ Tasks);
public void CreateRole (string Name, string Description, ReportService2005.Task[] Tasks);
Public Sub CreateRole (Name As String, Description As String, Tasks As Task())
매개 변수
String String String

새 역할의 이름입니다. The name of the new role. 이 매개 변수의 값은 1자에서 260자 사이여야 합니다. The value of this parameter must be between 1 and 260 characters long.

String String String

새 역할의 설명입니다. A description of the new role. 이 매개 변수의 값은 1자에서 512자 사이여야 합니다. The value of this parameter must be between 1 and 512 characters long.


역할에 대해 설정할 태스크를 나타내는 Task 개체의 배열입니다. An array of Task objects that represents the tasks to set for the role. TaskID 개체의 Task 속성만 역할을 만들기 위해 전송됩니다. Only the TaskID property of the Task object is submitted to create a role.


이 코드 예제를 컴파일하려면 Reporting Services WSDL 참조 하 고 특정 네임 스페이스를 가져올 해야 합니다.To compile this code example, you must reference the Reporting Services WSDL and import certain namespaces. 자세한 내용은 참조 컴파일 및 코드 예제를 실행합니다.For more information, see Compiling and Running Code Examples. 다음 코드 예제에서는 CreateRole 폴더 및 보고서를 볼 수 있는 권한이 있는 사용자 역할을 만드는 메서드:The following code example uses the CreateRole method to create a user role that has permissions to view folders and reports:

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

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

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

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

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

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


다음 표에서는 이 작업에 대한 헤더 및 사용 권한 정보를 보여 줍니다.The table below shows header and permissions information on this operation.

SOAP 헤더SOAP Headers (In) BatchHeaderValue(In) BatchHeaderValue

(Out) ServerInfoHeaderValue(Out) ServerInfoHeaderValue
필요한 권한Required Permissions CreateRoles (시스템)CreateRoles (System)

NameDescription 매개 변수가 필요 하며로 설정 되지 않아야 null (Nothing Visual basic에서).The Name and Description parameters are required and should not be set to null (Nothing in Visual Basic). 에 대 한 값 Name 고유 해야 합니다.The value for Name must be unique.

역할에 작업이 하나 이상 할당 해야 합니다.You must assign at least one task to the role. 시스템 수준과 항목 수준 태스크는 단일 역할 내에서 결합할 수 없습니다.You cannot combine system-level and item-level tasks within a single role. 작업에 대 한 자세한 내용은 참조 태스크 및 사용 권한합니다.For more information about tasks, see Tasks and Permissions.

적용 대상