ReportingService2010.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 です。
- Properties
型: array<ReportService2010.Property[]
リンク アイテムに設定するプロパティの名前と値を定義する Property オブジェクトの配列です。
説明
次の表に、この操作に関連するヘッダーおよび権限の情報を示します。
SOAP ヘッダーの使用方法 |
(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());
}
}
}