Idioma

ReportingService2005.FindItems Método

Definição

Retorna itens de um banco de dados de servidor de relatórios que correspondem aos critérios de busca.

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()

Parâmetros

Folder
String

A URL totalmente qualificada da pasta para buscar. Para pesquisar todo o banco de dados do servidor de relatórios, especifique a pasta raiz (/).

BooleanOperator
BooleanOperatorEnum

O operador lógico aplicado para conectar as condições de busca. Os valores possíveis são: AND e OR. O valor padrão é AND.

Conditions
SearchCondition[]

Um array de SearchCondition objetos que define os nomes das propriedades e valores para a pesquisa.

Retornos

Um array de CatalogItem objetos no banco de dados do servidor de relatórios que correspondem aos critérios de busca especificados.

Exemplos

Para compilar esse exemplo de código, você deve consultar o Reporting Services WSDL e importar certos namespaces. Para mais informações, veja Exemplos de Código Compilando e Executando. O exemplo de código a seguir pesquisa no banco de dados do servidor de relatórios por todos os relatórios cujos nomes contêm a palavra "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() );   
      }  
   }  
}  

Comentários

A tabela abaixo mostra informações sobre cabeçalhos e permissões sobre esta operação.

Cabeçalhos SOAP (Fora) ServerInfoHeaderValue
Permissões necessárias Se não for uma busca por componentes: ReadProperties

Apenas os itens com a respectiva ReadProperties permissão são devolvidos.

O comprimento do Folder parâmetro não pode exceder 260 caracteres; caso contrário, uma exceção SOAP é lançada com o código de erro rsItemLengthExceeded.

O Folder parâmetro não pode ser nulo ou vazio ou conter os seguintes caracteres reservados: : ? ; @ & = + $ , \ * > < | . ". Você pode usar o caractere de barra para frente (/) para separar itens no nome completo do caminho da pasta, mas não pode usá-lo no final do nome da pasta.

O servidor de relatório não suporta caracteres coringa no meio da condição de busca. Caracteres coringa incluem %, _, [, ], ^ e -. Se um personagem coringa estiver presente, o servidor de relatórios trata o personagem literalmente.

Apenas uma instância de nome de propriedade pode ser fornecida no conjunto de condições de busca.

A funcionalidade de busca é FindItems insensível a maiúsculas minúsculas.

Aplicações que usam FindItems normalmente aceitam entrada do usuário para propriedades e valores específicos de propriedades. As propriedades pesquisáveis são Name, Description, CreatedBy, CreationDate, ModifiedBy, e ModifiedDate. Os itens que são devolvidos são apenas aqueles para os quais o usuário tem Read Properties permissão.

Aplica-se a