ReportingService2005.CreateLinkedReport Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет новый связанный отчет в базу данных сервера отчетов.
public:
void CreateLinkedReport(System::String ^ Report, System::String ^ Parent, System::String ^ Link, cli::array <ReportService2005::Property ^> ^ Properties);
public void CreateLinkedReport (string Report, string Parent, string Link, ReportService2005.Property[] Properties);
member this.CreateLinkedReport : string * string * string * ReportService2005.Property[] -> unit
Public Sub CreateLinkedReport (Report As String, Parent As String, Link As String, Properties As Property())
Параметры
- Report
- String
Имя нового связанного отчета.
- Parent
- String
Полный URL-адрес родительской папки, в которую добавляется новый отчет.
- Link
- String
Полный URL-адрес отчета, который будет использоваться для определения отчета.
- Properties
- Property[]
Массив объектов Property, который определяет имена и значения свойств, задаваемых для связанного отчета.
Примеры
Для компиляции этого примера кода необходимо ссылаться на Reporting Services WSDL и импортировать определенные пространства имен. Дополнительные сведения см. в разделе Примеры компиляции и выполнения кода. В следующем примере кода создается связанный отчет:
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 prop As New [Property]()
prop.Name = "Description"
prop.Value = "A new linked report"
Dim props(0) As [Property]
props(0) = prop
Try
rs.CreateLinkedReport("Employee Sales Report2", "/SampleReports", "/SampleReports/Employee Sales Summary", props)
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;
Property prop = new Property();
prop.Name = "Description";
prop.Value = "A new linked report";
Property[] props = new Property[1];
props[0] = prop;
try
{
rs.CreateLinkedReport("Employee Sales Report2", "/SampleReports",
"/SampleReports/Employee Sales Summary", props);
}
catch (SoapException e)
{
Console.WriteLine(e.Detail.InnerXml.ToString());
}
}
}
Комментарии
В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.
Заголовки SOAP | (In) BatchHeaderValue (Out) ServerInfoHeaderValue |
Необходимые разрешения | CreateReport on Parent AND ReadProperties on Report |
Длина Parent
параметров и Link
не может превышать 260 символов. В противном случае создается исключение SOAP с кодом ошибки rsItemLengthExceededed.
Параметры Parent
и Link
не могут быть пустыми или пустыми или содержать следующие зарезервированные символы: : ? ; @ & = + $ , \ * > < | . "
. Символ косой черты (/) можно использовать для разделения элементов в полном пути к папке, но его нельзя использовать в конце имени папки.
Связанный отчет имеет те же свойства, что и стандартный отчет, но не содержит собственного определения отчета. Связанный отчет не может ссылаться на другой связанный отчет.
Создатель связанного отчета должен иметь разрешение на чтение определения отчета, на который ссылается связанный отчет; однако этот уровень разрешений не требуется для запуска связанного отчета.
CreateLinkedReport С помощью метода изменяются ModifiedBy свойства и ModifiedDate родительской папки.