ReportingService2005.GetProperties Method
レポート サーバー データベースのアイテムの 1 つ以上のプロパティの値を返します。
名前空間: Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005
アセンブリ: ReportService2005 (reportingservice2005.dll 内)
構文
'宣言
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/GetProperties", RequestNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace:="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction:=SoapHeaderDirection.Out)> _
<SoapHeaderAttribute("ItemNamespaceHeaderValue")> _
Public Function GetProperties ( _
Item As String, _
Properties As Property() _
) As Property()
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/GetProperties", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out)]
[SoapHeaderAttribute("ItemNamespaceHeaderValue")]
public Property[] GetProperties (
string Item,
Property[] Properties
)
[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/GetProperties", RequestNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace=L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse::Literal, ParameterStyle=SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction=SoapHeaderDirection::Out)]
[SoapHeaderAttribute(L"ItemNamespaceHeaderValue")]
public:
array<Property^>^ GetProperties (
String^ Item,
array<Property^>^ Properties
)
/** @attribute SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/GetProperties", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped) */
/** @attribute SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out) */
/** @attribute SoapHeaderAttribute("ItemNamespaceHeaderValue") */
public Property[] GetProperties (
String Item,
Property[] Properties
)
SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/GetProperties", RequestNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", ResponseNamespace="https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)
SoapHeaderAttribute("ServerInfoHeaderValue", Direction=SoapHeaderDirection.Out)
SoapHeaderAttribute("ItemNamespaceHeaderValue")
public function GetProperties (
Item : String,
Properties : Property[]
) : Property[]
パラメータ
- Item
アイテムの完全なパス名または ID です。
- Properties
値を取得するプロパティを表す Property オブジェクトの配列です。
戻り値
指定したアイテムのプロパティを表す Property オブジェクトの配列です。
解説
この引数に渡す必要がある既定値は、完全なパス名です。ID を指定するには、ItemNamespaceHeader SOAP ヘッダーを設定する必要があります。詳細については、「GetProperties メソッドのアイテム名前空間の設定」を参照してください。
ユーザー定義プロパティと予約済みプロパティをすべて取得するには、GetProperties メソッドを使用します。予約済みプロパティの標準サブセットを取得するには、ListChildren メソッドを使用します。レポート サーバー データベース内のアイテムの予約済みプロパティの一覧については、「レポート サーバー アイテムのプロパティ」を参照してください。
Properties パラメータが NULL (Visual Basic では Nothing) の場合、指定したアイテムのすべてのプロパティが返されます。これには、アイテムに固有のユーザー定義のプロパティと組み込みのプロパティがすべて含まれます。
Item パラメータには、アイテムの完全なパス名か、アイテムの ID を渡すことができます。SOAP ヘッダーを使用してこれを行う方法の詳細については、「Reporting Services の SOAP ヘッダーの使用」を参照してください。
使用例
このコード例をコンパイルするには、Reporting Services の WSDL を参照し、特定の名前空間をインポートする必要があります。詳細については、「コード例のコンパイルと実行」を参照してください。次のコード例では、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() );
}
}
}
スレッド セーフ
この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォーム
開発プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
対象プラットフォーム
サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。
参照
関連項目
ReportingService2005 Class
ReportingService2005 Members
Microsoft.WSSUX.ReportingServicesWebService.RSManagementService2005 Namespace