Guia de Introdução com Web Parts de Pesquisa da empresa personalizado

Este tópico aborda os pré-requisitos para o desenvolvimento personalizado Pesquisar da empresa osssearchshort Web Parts.

Desenvolvendo Web Parts

Web Parts em Windows SharePoint Services 3.0 aprimoram as versões anteriores do Web Parts tecnologias. Você pode usar Windows SharePoint Services 3.0 Web Parts bem como Web Parts Microsoft ASP.NET 2.0.

Dica

O classe base usar quando você criar um Windows SharePoint Services Web Part é o Microsoft.SharePoint.WebPartPages.WebPart Microsoft.SharePoint.WebPartPages.WebPart classe.É o classe base usar quando você criar um ASP.NET Web Part oSystem.Web.UI.WebControls.WebPart classe.

O classe base fornece propriedades básicas que são comum para todos os Web Parts, such as Title, Description e assim por diante. Você pode adicionar personalizado são apresentadas propriedades para o classe derivada e, em tempo de execução, os dois conjuntos de propriedades e executar como um único conjunto de propriedades.

Em essência, uma Web Part é um assembly .NET controle personalizado da Web que usa um arquivo descrição Web Part no formato de Windows SharePoint Services (.dwp) ou o formato ASP.NET 2.0 (.WebPart). O arquivo descrição Web Part pode ser armazenado em e relacionado de qualquer computador e contém metadados XML que descrevem uma instância da Web Part. O assembly Web Part.NET é um DLL que deve ser instalado e registrado em cada computador Windows SharePoint Services que usa a Web Part.

Escolhendo entre ASP.NET e Web Parts SharePoint

WebPartclasse. Web Parts ASP.NET ter nomes arquivo descrição que usam a extensão .WebPart. Web Parts ASP.NET fornecer a maior flexibilidade e compatibilidade com Web sites que não são bastante flexíveis com Windows SharePoint Services. Em geral, você deve design novo Web Parts que herdam a ASP.NET 2.0

Windows SharePoint Services 3.0 Web Parts fornecem compatibilidade com versões anteriores com Windows SharePoint Services 2.0. Web Parts SharePoint ter nomes arquivo descrição que usam a extensão DWP. Web Parts SharePoint funcionalidade adicional incluem mas pode ser usado apenas em um site do SharePoint. A seguir é uma lista dos recursos adicionados do SharePoint Web Parts.

• Cruz-página Conexões em sites SharePoint

• As conexões entre Web Parts que são outside of uma zona Web Part

• Conexões de cliente usando o componente dos serviços da Web Part da página

• Web Part armazenamento de dados no cache

• Processamento assíncrono usando itens trabalho Web Part

Para obter mais informações sobre o desenvolvimento e conectando Web Parts, importando uma ASP.NET Web Part para um site Windows SharePoint Services e modelo de objeto SharePoint Web Part, consulte o Microsoft Windows SharePoint Services 3.0 SDK.

Usando o modelo de objeto de consulta

Pesquisar da empresa fornece um modelo objeto que você pode usar para executar pesquisa consultas programaticamente contra o componente pesquisa. O espaço para nome Microsoft.Office.Server.Search.Query N:Microsoft.Office.Server.Search.Query inclui duas classes que fornecem essa funcionalidade:

• FullTextSqlQuery: usar esta classe para consultas pesquisa Referência de sintaxe SQL de pesquisa da empresa texto completo sintaxe.

• KeywordQuery: usar esta classe para consultas pesquisa Empresa de pesquisa de palavras-chave sintaxe referência palavra-chave sintaxe.

Para obter mais informações sobre como usar o modelo de objeto Enterprise Search Query, consulte Getting Started with the Enterprise Search Query Object Model.

Configurando o ambiente de desenvolvimento

O com suporte abordagem para configuração até seu ambiente de desenvolvimento Web Part é desenvolver localmente em um servidor O Office SharePoint Server 2007 ossossshort.

Você pode usar Microsoft Office SharePoint Designer 2007 para importação Web Parts para Web pages, mas não para criar novo Web Parts. Para desenvolver um assembly Web Part personalizado, você precisará usar um ferramenta de desenvolvimento such as Microsoft Visual Studio 2005. Com Visual Studio 2005, você beneficiar de um valioso ambiente de desenvolvimento e depuração recursos. Para obter mais informações sobre como usar Visual Studio 2005 para a criação Web Parts, consulte o seguinte:

• Por que É o que É ele System do projeto da Web Visual Studio 2005 Microsoft: e IT?

• Web Parts ASP.NET no Visual Studio

Criando o projeto da Web Part

Você pode usar o modelo Web Control Library para criar o projeto Visual Studio 2005 para a Web Part. Este modelo está localizado na caixa de diálogo New Project , no nó de **** Windows Para C# e Visual Basic.

Referências do projeto

O projeto criado a partir de modelo Web Control Library inclui referências para os conjuntos de módulos (assemblies) exigido para um ASP.NET Web Part. No entanto, porque você usará o modelo de objeto Enterprise Search Query para acessar o componente pesquisa, você deve adicionar referências ao seu projeto para determinados conjuntos de módulos (assemblies).

Porque você está usando o modelo de objeto Enterprise Search Query, você deve incluir uma referência para o Microsoft.Office.Server.Search.dll. Outras referências assembly na seguinte lista são opcional, mas na maioria das situações quando você estiver trabalhando com o modelo objeto Enterprise Search Query você precisarão-los também.

Adicione o seguinte referências ao seu projeto:

• Microsoft.SharePoint.dll

  Este assembly é exigido caso sua classe Web Part personalizado está herdando a partir de Microsoft.SharePoint.WebPartPages.WebPart Microsoft.SharePoint.WebPartPages.WebPart classe. Ele também pode ser exigido se você precisar usar o objeto SPFarm SPFarm para programaticamente recuperar informações sobre o servidor que hospeda o Web Part.

• Microsoft.Office.Server.dll

  Este assembly pode ser exigido se você precisar usar o modelo de objeto Office Server Administration para programaticamente recuperar informações sobre o Shared Services Provider para o componente pesquisa.

• System.Data.dll

• System.XML.dll

Criando a classe Parte da Web

Para criar a classe Web Part, modificando a classe usar como padrão que é criado a partir de modelo Web Control Library. As modificações você tornar dependem se você estiver criando uma Web Part ASP.NET ou uma Web Part SharePoint. Essas modificações são explicadas no seguinte seções.

Você também precisará adicionar o using para Microsoft.Office.Server.Search.Query para as classes para ambos os tipos de Web Parts. Veja a seguir a sintaxe usar:

using Microsoft.Office.Server.Search.Query;

As modificações para uma parte da Web ASP.NET

Em adição para o Query espaço para nome, você deve também adicionar a diretiva de espaço para nome para a classe ASP.NET Web Part. Veja a seguir a sintaxe usar:

using System.Web.UI.WebControls.WebParts;

Modificações para uma Web Part SharePoint

Em adição para o Query espaço para nome, você deve também adicionar a diretiva de espaço para nome para a classe SharePoint Web Part. Veja a seguir a sintaxe usar:

using Microsoft.SharePoint.WebPartPages;

Dica

Para garantir que sua classe Web Part deriva da classe desejada, não inclua ambas essas diretivas espaço para nome na mesma classe.

Se você estiver criando uma Web Part SharePoint, você também precisará especificar o espaço para nome XML Root para o Web Part. Veja a seguir a sintaxe usar:

...
using Microsoft.SharePoint.WebPartPages:
namespace CustomSearchWebPart
{
    [XmlRoot(Namespace = "CustomSearchWebPart")]
    public class customSearchQuery : WebPart
...

Implantando a Web Part

Quando você compilação seu projeto, você tem a opção de nomeação de alta segurança assembly do seu Web Part. Se você estiver implantando a Web Part para o cache global de assemblies, você deverá nome forte o assembly. Se você não estiver implantando-lo para o cache global de assemblies e é, em vez disso, implantá-lo o Diretório _app_bin _app_bin para o site Office SharePoint Server 2007, de alta segurança nomear o assembly é opcional.

Gerenciando Web Parts em servidores virtuais Para obter mais informações sobre conjuntos Web Part de nomeação de alta segurança e implantação locais, consulte .

Depois de compilação sua Parte da Web, você pode criar os arquivos necessários para implantá-lo. Para SharePoint Web Parts, você criar um arquivo .dwp; para ASP.NET Web Parts, você criar um arquivo .WebPart.

Criando um arquivo .dwp

Você pode criar e editar um arquivo .dwp simples usando um editor de texto such as Bloco de Notas. O seguinte exemplo de código mostra o sintaxe XML para uma simples SharePoint Web Part, sem um nome forte:

<?xml version="1.0"?>
<WebPart xmlns="https://schemas.microsoft.com/WebPart/v2">
   <Assembly>CustomWebPart, Version=1.0.0.0, Culture=Neutral, PublicKeyToken=null</Assembly>
   <TypeName>CustomWebPart.customSearchQuery</TypeName>
   <Title>Custom Search Web Part</Title>
</WebPart>

Para obter mais informações sobre como criar esses arquivos, consulte o seguinte:

• Criando um básica da Web Part

• Introdução de um desenvolvedor a Web Parts

• Compactação e implantação Web Parts para serviços SharePoint Microsoft Windows

Criando um arquivo .WebPart

Você pode manualmente criar e editar um arquivo .WebPart simples usando um editor de texto such as Bloco de Notas. O seguinte exemplo de código mostra o sintaxe XML para Web Part um simples, sem um nome forte:

<?xml version="1.0" encoding="utf-8"?>
<webParts>
  <webPart xmlns="https://schemas.microsoft.com/WebPart/v3">
    <metaData>
     <type name="CustomASPNETWebPart.customSearchQuery, CustomASPNETWebPart, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      <importErrorMessage>Cannot import this Web Part.</importErrorMessage>
    </metaData>
    <data>
      <properties>
        <property name="Title" type="string">Custom Search Query</property>
      </properties>
    </data>
  </webPart>
</webParts>

Você pode também dinamicamente gerar o arquivo .WebPart exportando a Web Part de uma página ASP.NET.

Registrando e importar A Web Part como um SafeControl

Antes de poder usar sua Parte da Web no seu site, você deve registrá-lo na lista SafeControl e, em seguida, importação-lo em seu site.

Para registrar a sua Web Part na lista de SafeControl

1. Abra o arquivo web.config localizado na pasta raiz para seu site.

2. Localize o SafeControls SafeControls marca.

3. Adicione uma marca para sua Web Part.

O seguinte exemplo de código mostra a sintaxe marca para uma Web Part simples, instalado no Diretório Bin, sem um nome forte:

<SafeControl Assembly="CustomSearchWebPart, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"
 Namespace="CustomSearchWebPart" Typename="*" Safe="True" />

A etapa final implantação é a importação de Web Part no seu site.

A importação um sua Parte da Web em um site

1. No seu navegador, aberto a página desejar para adicionar a Web Part para, clique o menu Site Actions e, em seguida, clique Editar Página .

2. Após a página no modo Editar, clique adicionar uma Web Part para a zona Web Part você desejar, direito ou esquerdo.

3. A Add Web Parts diálogo caixa, clique no link Advanced Web Part galeria e opções.

4. Clique em Procurar e, em seguida, clique importar .

5. Clique em Procurar , navegar para a localidade onde você salvou o arquivo .dwp ou .WebPart, selecione-lo e, em seguida, clique abrir .

A Web Part agora devem ser listada na caixa de diálogo. Você pode arrastar a Web Part de caixa de diálogo até a página.

Consulte também

Outros recursos

Criando Web Parts de Pesquisa da empresa personalizado
Walkthrough: criando uma Web Part de pesquisa da empresa personalizado
Walkthrough: Criando uma Parte da Web ASP.NET para o exemplo de aplicativos de dados AdventureWorks Business