Filtrar Visão geral sobre Web Parts

Web Parts de filtro pode ser muito útil em dados-valioso empresa inteligência sites. Eles fornecem uma interface usuário (normalmente e pode ser ocultos) que permite que o usuário para fornecer pesquisa ou filtro critérios para uma consulta em dados such as um tabela de banco de dados ou uma lista. Quando você conectar um filtro Web Part para um ou mais Web Parts na página que possuem filtragem funcionalidade, eles exibir filtrados resultados de consulta.

Benefícios de Web Parts de filtro

Web Parts de filtros oferecem vantagens para os usuários e desenvolvedores. Usando filtros, os usuários pode localizar novas e significativo maneiras para exibição seus dados. Suponha que você compilar um aplicativo no qual um Web Part contata um serviço da Web, retorna registros históricos de médio temperaturas diariamente para todos os estados nos Estados Unidos e lista os dados na forma tabular. Se um usuário desejar a flexibilidade para exibição de dados com base em um conjunto de estados ou apenas um determinado estado, ele ou ela pode conectar o Web Part para um filtro Web Part que pode habilitar o usuário a escolher diferentes estados em tempo de execução e ver resultados diferentes.

Usando filtros, os desenvolvedores podem descobrir novas oportunidades para codificar reutilização e combinar a funcionalidade do Web Parts isolado. Suponha que um desenvolvedor cria uma Web Part que salva informações endereço para o usuário, incluindo um codificar postal e torna esse informações sempre disponível para preencher na forma a endereço de envio quando o usuário pedidos algo. Em seguida, o desenvolvedor adiciona outros Web Parts que dependem um codificar postal específico, such as Web Parts para exibir informações meteorologia e manchetes de notícias na área do usuário, bem como uma Web Part que pesquise as empresas por categoria em um determinado codificar postal. Rather than design foi o desenvolvedor cada nova Web Part com o mesmo recurso de salvar um codificar postal, design de cada Web Part para exigir a entrada de um codificar postal. Em seguida, o desenvolvedor pode simplesmente conectar o Web Part que já fornece a codificar postal para o clima, notícias e listagem empresa Web Parts que levam um codificar postal como uma entrada. Cada conexão estende a utilidade do original de Web Parts e elimina a redundância na codificar de Web Parts o novo.

A implementação e consumindo filtro Web Parts

Windows SharePoint Services 3.0 usa a estrutura conexão ASP.NET Web Part para transmitir os critérios filtro de uma Web Part para outra Web Parts antes que a consulta seja executar. As conexões entre Web Parts ASP.NET são baseadas na noção de provedores e consumidores. Um provedor Web Part fornece informações para um ou mais consumidor Web Parts por um programático interface. O provedor expõe alguns dados por uma interface bem definido, que o consumidor sabe como usar. Uma Web Part de filtro é apenas um provedor especial que fornece valores filtro que outros Web Parts pode usar para dados filtro.

ASP.NET fornece um integrado conjunto de componentes conexão, de forma que com um número mínimo de etapas, linhas de código a few e não precisam identificador todos o subjacente complexidade e sincronização de dados, você pode instale nos Web Parts existente para conexões forma. Windows SharePoint Services faz usar de estrutura de conexão e fornece interfaces adicional chamado IFilterValues e IItransformableFilterValues para tornar mais fácil até mesmo criar conexões entre Web Parts para filtragem cenários.

Com Filter Web Parts, você pode criar dinâmico, programático conexões entre Web Parts em tempo de execução, bem como Conexões estáticas, predefinidas declarado na marcação de um página da Web. Windows SharePoint Services também fornece aos usuários com uma interface usuário (interface do usuário) que permite aos usuários conectar ou desconectar Web Parts em tempo de execução.

Conexões Web Parts baseiam-se em um modelo "receber" de conectividade, onde o consumidor Web Part obtém dados do provedor Web Part. Para criar uma conexão, uma Web Part que atua como um provedor de dados define um contrato de comunicação que indica os dados-pode fornecer. Outra Web Part, atuando como o consumidor e com conhecimento do contrato de comunicação, recupera que dados.

O mecanismo para estabelecer uma conexão é um método callback especial: um o consumidor e outra no provedor. No entanto, o classe base Web Part trata todos os o callback e detalhes de comunicação, para que o exigido etapas dos desenvolvedores sejam mínimos. Como um desenvolvedor, se você desejar usar a abordagem mais simples para criar filtro provedores, tudo o que você precisa fazer é selecionar um método no provedor para usar como o método callback e marca em codificar a origem com um atributo ConnectionProvider ConnectionProvider. Dentro desse método, certifique-se que ele não leva qualquer entrada Parâmetros e retorna a instância interface ITransformableFilterValues ITransformableFilterValues que contém os dados filtro para transmitir para o consumidor. A instância interface pode ser simples (por exemplo, uma única propriedade que contém um valor da seqüência de caracteres such as um codificar postal).

A interface ITransformableFilterValues ITransformableFilterValues fornece um meio de especificar filtro recursos como múltipla e suporte para todos ou valores nulos. Essa interface também permite que Windows SharePoint Services 3.0 internamente usar transformadores interface que permitem tipos interface diferente para se comunicar entre si.

Método callback do consumidor recupera a instância da interface IFilterValues IFilterValues do provedor. Novamente, tudo o que é exigido de um desenvolvedor é identificar qual método no consumidor (usando um atributo ConnectionConsumer ConnectionConsumer) irá recuperar a instância interface e atribui-lo para alguns variável interna para processamento e processamento. Observe que os dados a partir de provedor são passados durante a fase da página e ciclo Web Part prerendering, portanto, você deve planeja processo de dados e atualização qualquer lógica no consumidor após prerendering está completo.

Além disso, pois nomes parâmetro precisam nem sempre mapa (n.); mapear (v.) para si na provedor e consumidor, Windows SharePoint Services fornece uma interface ConsumerParameters que o consumidor deve fornecer com nomes de parâmetro para o provedor.

O que acontece no tempo de execução

Em tempo de execução, as conexões entre Web Parts são gerenciado pelo WebPartManager, como segue:

1. Para cada provedor registrado, a WebPartManager chama o método ponto de conexão provedor.

2. A parte provedor retorna uma instância de interface de comunicação.

3. Para cada consumidor registrado para esse provedor, a WebPartManager chama o método ponto de conexão consumidor, passando uma instância da interface.

4. A parte consumidor chamadas propriedades e métodos na instância interface.

Out-of-the-Box Web Parts de filtro

O Office SharePoint Server 2007 fornece o seguinte filtros na Galeria de Web Parts, Por padrão:

• Filtro de serviços de análise

• Filtro de lista criados

• Filtro Catálogo de dados comerciais

• Filtro de usuário atual

• Filtro de data

• Filtro do campo de página

• Filtro de consulta seqüência de caracteres (URL)

• Filtro de lista SharePoint

• Filtro de texto

• Filtro USERPROFILE

Você pode consumir qualquer um desses filtros em seu personalizado Web Parts. Para obter mais informações, consulte Walkthrough: Writing a Simple Filter Consumer Web Part.

Consulte também

Outros recursos

Walkthrough: texto de exemplo de Web Parts consumidor um filtro simples
Como a: gravar uma Web Part Multi-Select filtro CheckBox
Como a: Consume a Web Part Multi-Select filtro CheckBox