ReportingService2005.GetProperties メソッド
レポート サーバー データベースのアイテムの 1 つ以上のプロパティの値を返します。
名前空間: ReportService2005
アセンブリ: ReportService2005 (ReportService2005.dll)
構文
'宣言
Public Function GetProperties ( _
Item As String, _
Properties As Property() _
) As Property()
'使用
Dim instance As ReportingService2005
Dim Item As String
Dim Properties As Property()
Dim returnValue As Property()
returnValue = instance.GetProperties(Item, _
Properties)
public Property[] GetProperties(
string Item,
Property[] Properties
)
public:
array<Property^>^ GetProperties(
String^ Item,
array<Property^>^ Properties
)
member GetProperties :
Item:string *
Properties:Property[] -> Property[]
public function GetProperties(
Item : String,
Properties : Property[]
) : Property[]
パラメーター
- Item
型: System.String
アイテムの完全なパス名または ID です。
- Properties
型: array<ReportService2005.Property[]
値を取得するプロパティを表す Property オブジェクトの配列です。
戻り値
型: array<ReportService2005.Property[]
指定したアイテムのプロパティを表す Property オブジェクトの配列です。
説明
次の表に、この操作に関連するヘッダーおよび権限の情報を示します。
SOAP ヘッダー |
(Out) ServerInfoHeaderValue |
必要な権限 |
アイテムの種類によって異なります。
|
この引数に渡す必要がある既定値は、完全なパス名です。 ID を指定するには、ItemNamespaceHeader SOAP ヘッダーを設定する必要があります。 詳細については、「GetProperties メソッドのアイテム名前空間の設定」を参照してください。
ユーザー定義プロパティと予約済みプロパティをすべて取得するには、GetProperties メソッドを使用します。 予約済みプロパティの標準サブセットを取得するには、ListChildren メソッドを使用します。 レポート サーバー データベース内のアイテムの予約済みプロパティの一覧については、「レポート サーバー アイテムのプロパティ」を参照してください。
Properties パラメーターが nullNULL 参照 (Visual Basic では Nothing) (Visual Basic では Nothing) の場合、指定したアイテムのすべてのプロパティが返されます。 これには、アイテムに固有のユーザー定義のプロパティと組み込みのプロパティがすべて含まれます。
Item パラメーターには、アイテムの完全なパス名か、アイテムの ID を渡すことができます。 SOAP ヘッダーを使用してこれを行う方法の詳細については、「Reporting Services の SOAP ヘッダーの使用」を参照してください。
使用例
このコード例をコンパイルするには、Reporting Services の WSDL を参照し、特定の名前空間をインポートする必要があります。 詳細については、「Compiling and Running Code Examples」を参照してください。 次のコード例では、GetProperties メソッドを使用して、Company Sales レポートに関連付けられた説明を取得します。
Imports System
Imports System.Web.Services.Protocols
Class Sample
Public Shared Sub Main()
Dim rs As New ReportingService2005()
rs.Credentials = System.Net.CredentialCache.DefaultCredentials
' Create the property to retrieve.
Dim retrieveProp As New [Property]()
retrieveProp.Name = "Description"
Dim props(0) As [Property]
props(0) = retrieveProp
Try
Dim properties As [Property]() = rs.GetProperties("/SampleReports/Company Sales", props)
Dim prop As [Property]
For Each prop In properties
' Writes the description to the console.
Console.WriteLine(prop.Value)
Next prop
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;
// Create the property to retrieve.
Property retrieveProp = new Property();
retrieveProp.Name = "Description";
Property[] props = new Property[1];
props[0] = retrieveProp;
try
{
Property[] properties = rs.GetProperties("/SampleReports/Company Sales", props);
foreach (Property prop in properties)
{
// Writes the description to the console.
Console.WriteLine(prop.Value);
}
}
catch ( SoapException e )
{
Console.WriteLine( e.Detail.InnerXml.ToString() );
}
}
}