GetProperties メソッド

レポート サーバー データベースのアイテムの 1 つ以上のプロパティの値を返します。

名前空間:  ReportService2005
アセンブリ:  ReportService2005 (ReportService2005.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("ItemNamespaceHeaderValue")> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
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)
[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("ItemNamespaceHeaderValue")]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
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"ItemNamespaceHeaderValue")]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
array<Property^>^ GetProperties(
    String^ Item, 
    array<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("ItemNamespaceHeaderValue")>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member GetProperties : 
        Item:string * 
        Properties:Property[] -> Property[] 
public function GetProperties(
    Item : String, 
    Properties : Property[]
) : Property[]

パラメーター

戻り値

型: array<ReportService2005. . :: . .Property> [] () [] []
指定したアイテムのプロパティを表す Property オブジェクトの配列です。

説明

この引数に渡す必要がある既定値は、完全なパス名です。ID を指定するには、ItemNamespaceHeader SOAP ヘッダーを設定する必要があります。詳細については、「GetProperties メソッドのアイテム名前空間の設定」を参照してください。

ユーザー定義プロパティと予約済みプロパティをすべて取得するには、GetProperties メソッドを使用します。予約済みプロパティの標準サブセットを取得するには、ListChildren メソッドを使用します。レポート サーバー データベース内のアイテムの予約済みプロパティの一覧については、「レポート サーバー アイテムのプロパティ」を参照してください。

Properties パラメーターが NULL (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() );
      }
   }
}