ReportingService2005.FindItems 메서드

정의

보고서 서버 데이터베이스에서 검색 조건과 일치하는 항목을 반환합니다.

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

검색 조건에 연결하기 위해 적용되는 논리 연산자입니다. 가능한 값은 ANDOR입니다. 기본값은 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
필요한 권한 구성 요소 검색이 아닌 경우: ReadProperties

해당 ReadProperties 권한이 있는 항목만 반환됩니다.

매개 변수의 Folder 길이는 260자를 초과할 수 없습니다. 그렇지 않으면 오류 코드 rsItemLengthExceeded와 함께 SOAP 예외가 throw됩니다.

매개 변수는 Folder null이거나 비어 있거나 예약된 문자를 : ? ; @ & = + $ , \ * > < | . "포함할 수 없습니다. 슬래시 문자(/)를 사용하여 폴더의 전체 경로 이름에 있는 항목을 구분할 수 있지만 폴더 이름 끝에는 사용할 수 없습니다.

보고서 서버는 검색 조건 중간에 와일드카드 문자를 지원하지 않습니다. 와일드카드 문자에는 %, _, [, ], ^, -가 포함됩니다. 와일드카드 문자가 있는 경우 보고서 서버는 문자를 문자 그대로 처리합니다.

검색 조건 집합에서 속성 이름의 instance 하나만 제공할 수 있습니다.

FindItems 검색 기능은 대/소문자를 구분하지 않습니다.

일반적으로 사용하는 FindItems 애플리케이션은 특정 속성 및 속성 값에 대한 사용자 입력을 허용합니다. 검색 가능한 속성은 , , Description, , 및 입니다ModifiedDateName. ModifiedByCreationDateCreatedBy 반환되는 항목은 사용자에게 Read Properties 권한이 있는 항목입니다.

적용 대상