次の方法で共有


CreateLinkedItem メソッド

新しいリンク アイテムをレポート サーバー データベースに追加します。

名前空間:  ReportService2010
アセンブリ:  ReportService2010 (ReportService2010.dll)

構文

'宣言
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", RequestNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("TrustedUserHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Sub CreateLinkedItem ( _
    ItemPath As String, _
    Parent As String, _
    Link As String, _
    Properties As Property() _
)
'使用
Dim instance As ReportingService2010
Dim ItemPath As String
Dim Parent As String
Dim Link As String
Dim Properties As Property()

instance.CreateLinkedItem(ItemPath, Parent, _
    Link, Properties)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("TrustedUserHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public void CreateLinkedItem(
    string ItemPath,
    string Parent,
    string Link,
    Property[] Properties
)
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"TrustedUserHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
void CreateLinkedItem(
    String^ ItemPath, 
    String^ Parent, 
    String^ Link, 
    array<Property^>^ Properties
)
[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/CreateLinkedItem", RequestNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("TrustedUserHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member CreateLinkedItem : 
        ItemPath:string * 
        Parent:string * 
        Link:string * 
        Properties:Property[] -> unit 
public function CreateLinkedItem(
    ItemPath : String, 
    Parent : String, 
    Link : String, 
    Properties : Property[]
)

パラメーター

  • ItemPath
    型: System. . :: . .String
    ディレクトリ パスを含む、新しいリンク アイテムのファイル名です。
  • Parent
    型: System. . :: . .String
    新しいアイテムを追加する親フォルダーの完全修飾 URL です。
  • Link
    型: System. . :: . .String
    アイテム定義に使用されるアイテムの完全修飾 URL です。

説明

次の表に、この操作に関連するヘッダーおよび権限の情報を示します。

SOAP ヘッダーの使用方法

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue

ネイティブ モードで必要な権限

Parent に対する CreateReport、および ItemPath に対する ReadProperties

SharePoint モードで必要な権限

サポートされていません。

Parent パラメーターと Link パラメーターの長さは、260 文字以下でなければなりません。これを超えると、エラー コード rsItemLengthExceeded の SOAP 例外がスローされます。

Parent パラメーターと Link パラメーターを NULL または空の文字列にすることはできません。また、予約文字 : ?; @ & = + $ , \ * > < | ." を含めることもできません。スラッシュ (/) は、フォルダーの完全なパス名内の各項目を区切るために使用することはできますが、フォルダー名の末尾には使用できません。

リンク アイテムには、標準カタログ アイテムと同じプロパティがありますが、リンク アイテム独自のアイテム定義はありません。リンク アイテムは、別のリンク アイテムを参照することはできません。

リンク アイテムを作成するには、リンク アイテムが参照するアイテムの定義を読み取るための権限を持っている必要があります。ただし、リンク アイテムの実行には、この権限レベルは必要ありません。

CreateLinkedItem メソッドを使用すると、親フォルダーの ModifiedBy プロパティと ModifiedDate プロパティが変更されます。

使用例

このコード例をコンパイルするには、Reporting Services の WSDL を参照し、特定の名前空間をインポートする必要があります。詳細については、「Compiling and Running Code Examples」を参照してください。次のコード例では、リンク レポートを作成します。

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