ReportingService2005.FindItems メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
レポート サーバー データベースから、検索条件に一致するアイテムを返します。
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 オブジェクトの配列です。
例
このコード例をコンパイルするには、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 |
必要なアクセス許可 | コンポーネント検索ではない場合: ReadPropertiesReadProperties 権限のあるアイテムだけが返されます。 |
パラメーターの Folder
長さは 260 文字を超えることはできません。それ以外の場合は、エラー コード rsItemLengthExceeded で SOAP 例外がスローされます。
Folder
パラメーターを NULL または空の文字列にすることはできません。また、予約文字 : ? ; @ & = + $ , \ * > < | . "
を含めることもできません。 スラッシュ文字 (/) を使用して、フォルダーの完全なパス名内の項目を区切ることができますが、フォルダー名の末尾で使用することはできません。
検索条件の途中にはワイルドカード文字を使用することはできません。 ワイルドカード文字には、%、_、[、]、^、および - が含まれます。 ワイルドカード文字があっても、レポート サーバーはそれをワイルドカード文字としてではなくそのままの文字として扱います。
一連の検索条件の中で、同じプロパティ名は一度しか使用できません。
FindItems の検索機能では、大文字と小文字が区別されません。
一般に、FindItems を使用するアプリケーションでは、特定のプロパティやプロパティ値を指定できます。 検索可能なプロパティは、Name、Description、CreatedBy、CreationDate、ModifiedBy、および ModifiedDate です。 返されるのは、ユーザーがRead Properties
権限を持っているアイテムだけです。