ReportingService2010.CreateLinkedItem Метод

Определение

Пространство имен:

ReportService2010

Сборка:

ReportService2010.dll

Добавляет новый связанный элемент в базу данных сервера отчетов.

public:
 void CreateLinkedItem(System::String ^ ItemPath, System::String ^ Parent, System::String ^ Link, cli::array <ReportService2010::Property ^> ^ Properties);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", 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("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public void CreateLinkedItem (string ItemPath, string Parent, string Link, ReportService2010.Property[] Properties);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", 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("TrustedUserHeaderValue")>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
member this.CreateLinkedItem : string * string * string * ReportService2010.Property[] -> unit

Public Sub CreateLinkedItem (ItemPath As String, Parent As String, Link As String, Properties As Property())

Параметры

ItemPath

String

Имя нового связанного элемента, включающее имя файла.

Parent

String

Полный URL-адрес родительской папки, в которую добавляется новый элемент.

Link

String

Полный URL-адрес элемента, который будет использоваться для определения элемента.

Properties

Property[]

Массив объектов Property, который определяет имена и значения свойств, задаваемых для связанного элемента.

Атрибуты

SoapDocumentMethodAttribute SoapHeaderAttribute

Примеры

Чтобы скомпилировать этот пример кода, необходимо сослаться на Reporting Services WSDL и импортировать определенные пространства имен. Дополнительные сведения см. в разделе Примеры компиляции и выполнения кода. В следующем примере кода создается связанный отчет:

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2010()  
      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.CreateLinkedItem("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()  
   {  
      ReportingService2010 rs = new ReportingService2010();  
      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.CreateLinkedItem("Employee Sales Report2", "/SampleReports",  
            "/SampleReports/Employee Sales Summary", props);  
      }  

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

Комментарии

В следующей таблице показаны сведения о заголовках и разрешениях для этой операции.

Использование заголовка SOAP	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Необходимые разрешения в собственном режиме	CreateReport on Parent AND ReadProperties on ItemPath
Необходимые разрешения в режиме Интеграции с SharePoint	Не поддерживается

Длина Parent параметров и Link не может превышать 260 символов. В противном случае создается исключение SOAP с кодом ошибки rsItemLengthExceeded.

Параметры Parent и Link не могут быть пустыми или пустыми или содержать следующие зарезервированные символы: : ? ; @ & = + $ , \ * > < | . ". Вы можете использовать символ косой черты (/) для разделения элементов в полном пути к папке, но его нельзя использовать в конце имени папки.

Связанный элемент имеет те же свойства, что и стандартный элемент каталога, но не содержит собственного определения элемента. Связанный элемент не может ссылаться на другой связанный элемент.

Создатель связанного элемента должен иметь разрешение на чтение определения элемента, на который ссылается связанный элемент; однако этот уровень разрешений не требуется для запуска связанного элемента.

CreateLinkedItem С помощью метода изменяются ModifiedBy свойства и ModifiedDate родительской папки.