ReportingService2005.FindItems メソッド

定義

名前空間:

ReportService2005

アセンブリ:

ReportService2005.dll

レポート サーバー データベースから、検索条件に一致するアイテムを返します。

public:
 cli::array <ReportService2005::CatalogItem ^> ^ FindItems(System::String ^ Folder, ReportService2005::BooleanOperatorEnum BooleanOperator, cli::array <ReportService2005::SearchCondition ^> ^ Conditions);

public ReportService2005.CatalogItem[] FindItems (string Folder, ReportService2005.BooleanOperatorEnum BooleanOperator, ReportService2005.SearchCondition[] Conditions);

member this.FindItems : string * ReportService2005.BooleanOperatorEnum * ReportService2005.SearchCondition[] -> ReportService2005.CatalogItem[]

Public Function FindItems (Folder As String, BooleanOperator As BooleanOperatorEnum, Conditions As SearchCondition()) As CatalogItem()

パラメーター

Folder

String

検索するフォルダーの完全修飾 URL です。 レポート サーバー データベース全体を検索するには、ルート フォルダー (/) を指定します。

BooleanOperator

BooleanOperatorEnum

検索条件を結合するために適用する論理演算子です。 設定可能な値は AND および OR です。 既定値は AND です。

Conditions

SearchCondition[]

検索するプロパティの名前と値を定義する SearchCondition オブジェクトの配列です。

戻り値

CatalogItem[]

指定した検索条件に対応する、レポート サーバー データベース内の CatalogItem オブジェクトの配列です。

例

このコード例をコンパイルするには、Reporting Services の WSDL を参照し、特定の名前空間をインポートする必要があります。 詳細については、「 コード例のコンパイルと実行」を参照してください。 次のコード例では、レポート サーバー データベースで、名前に「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  

      Dim items As CatalogItem() = Nothing  
      Dim condition As New SearchCondition()  
      condition.Condition = ConditionEnum.Contains  
      condition.ConditionSpecified = True  
      condition.Name = "Name"  
      condition.Value = "Sales"  

      Dim conditions(0) As SearchCondition  
      conditions(0) = condition  

      Try  
         items = rs.FindItems("/", BooleanOperatorEnum.Or, conditions)  

         If Not (items Is Nothing) Then  
            Dim ci As CatalogItem  
            For Each ci In  items  
               Console.WriteLine("Item {0} found at {1}", ci.Name, ci.Path)  
            Next ci  
         End If  

      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;  

      CatalogItem[] items = null;  
      SearchCondition condition = new SearchCondition();  
      condition.Condition = ConditionEnum.Contains;  
      condition.ConditionSpecified = true;  
      condition.Name = "Name";  
      condition.Value = "Sales";  

      SearchCondition[] conditions = new SearchCondition[1];  
      conditions[0] = condition;  

      try  
      {  
         items = rs.FindItems( "/", BooleanOperatorEnum.Or, conditions );  

         if ( items != null )  
         {  
            foreach ( CatalogItem ci in items)  
            {  
               Console.WriteLine( "Item {0} found at {1}", ci.Name, ci.Path );  
            }  
         }  
      }  

      catch ( SoapException e )  
      {  
         Console.WriteLine( e.Detail.InnerXml.ToString() );   
      }  
   }  
}  

注釈

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

SOAP ヘッダー	(Out) ServerInfoHeaderValue
必要なアクセス許可	コンポーネント検索ではない場合: ReadProperties ReadProperties 権限のあるアイテムだけが返されます。

パラメーターの Folder 長さは 260 文字を超えることはできません。それ以外の場合は、エラー コード rsItemLengthExceeded で SOAP 例外がスローされます。

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

検索条件の途中にはワイルドカード文字を使用することはできません。 ワイルドカード文字には、%、_、[、]、^、および - が含まれます。 ワイルドカード文字があっても、レポート サーバーはそれをワイルドカード文字としてではなくそのままの文字として扱います。

一連の検索条件の中で、同じプロパティ名は一度しか使用できません。

FindItems の検索機能では、大文字と小文字が区別されません。

一般に、FindItems を使用するアプリケーションでは、特定のプロパティやプロパティ値を指定できます。 検索可能なプロパティは、Name、Description、CreatedBy、CreationDate、ModifiedBy、および ModifiedDate です。 返されるのは、ユーザーがRead Properties権限を持っているアイテムだけです。