ReportingService2010.CreateRole(String, String, String[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет новую роль в базу данных сервера отчетов. Этот метод применим только в собственном режиме.
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[]
Массив идентификаторов задач, представляющих задачи, которые следует задать для роли.
- Атрибуты
Примеры
Чтобы скомпилировать этот пример кода, необходимо сослаться на 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 | Не поддерживается |
Этот метод создает OperationNotSupportedSharePointMode
исключение при вызове в режиме SharePont.
Параметры Name
и Description
являются обязательными и не должны иметь значение null
(Nothing
в Visual Basic). Значение для Name
должно быть уникальным.
Роль должна быть назначена по крайней мере одна задача. Задачи системного уровня и уровня элементов нельзя сочетать в одной роли. Дополнительные сведения о задачах см. в разделе Задачи и разрешения.