ReportingService2005.CreateRole(String, String, Task[]) メソッド

定義

名前空間:

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 (Visual Basic では Nothing) を設定することはできません。 Name の値は一意である必要があります。

ロール内で少なくとも 1 つのタスクを割り当てる必要があります。 単一ロール内でシステムレベルのタスクとアイテムレベルのタスクを組み合わせることはできません。 タスクの詳細については、「 タスクとアクセス許可」を参照してください。