ReportingService2005.FindItems Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.