Criação de Web Parts para o SharePoint

Usando as partes Web, os usuários podem modificar diretamente o conteúdo, a aparência, e o comportamento de páginas do site da web do SharePoint usando um navegador.As partes da Web são os controles do servidor que executam em um tipo especial de página chamada uma página de partes Web: são os blocos de construção de páginas que se publicar em um site da web do SharePoint.Para obter mais informações sobre as partes da Web do SharePoint, consulte Bloco de construção: Web Parts.

Visual Studio fornece modelos que você pode usar para criar e depurar partes Web em um site da web do SharePoint.

Criando Web parts no Visual Studio

Crie uma parte Web adicionando um item de Web Part para qualquer projeto do SharePoint.Você pode usar um item de Web Part em uma solução na área restrita ou em uma solução de farm.

Se você deseja criar visualmente a parte Web usando um designer, para criar um projeto Visual Web parts ou para adicionar o item do Visual Web parts a qualquer projeto do SharePoint.Você pode usar um item do Visual Web parts em uma solução somente de farm.

Item de Web parts

Um item de Web Part fornece os arquivos que você pode usar para criar uma parte Web para um site da web do SharePoint.Quando você adiciona um item de Web Part , Visual Studio cria uma pasta no seu projeto e adicionar vários arquivos na pasta.A tabela a seguir descreve cada arquivo.

Arquivo	Descrição
Elements.xml	Contém informações que o arquivo de definição de recursos em seu projeto usar para implantar a parte da Web.
arquivo .webpart	Fornece informações que precisa do SharePoint exibir a parte Web em uma galeria da parte Web.
Code File	Contém os métodos que adicionam controles à parte Web e ao conteúdo personalizado na parte da Web.

Para obter mais informações, consulte Como: criar uma parte da Web do SharePoint.

Item visual Web parts

A parte Web do visual é uma parte Web que você cria usando o designer do Visual Web Developer no Visual Studio.Para obter mais informações sobre como usar este designer, consulte Visual Studio Beta de 11 para o mapa de conteúdo da Web.

Funcional, uma parte da Web do visual não é diferente de uma parte da Web.Um item do Visual Web parts inclui um item de Web Part .

Você pode criar a aparência da parte Web arrastando ou copiando controles do Visual Studio Caixa de Ferramentas para a superfície do controle de usuário.Para obter mais informações, consulte Como: criar uma parte da Web do SharePoint, usando um Designer..

Controles do SharePoint

Visual Studio fornece alguns controles para criar páginas do SharePoint, como páginas do aplicativo.Esses controles aparecem na caixa de ferramentas em Controles do SharePoint.A funcionalidade para esses controles deriva Microsoft.SharePoint.WebControls do namespace, que contém controles de servidor ASP.NET que são usados no site do SharePoint e nas páginas de lista.

Nome do controle	Descrição
AspMenu	Insere um menu do ASP.Para obter mais informações, consulte Visão geral do controle de menu.
CssLink	Insere um elemento de LINK na página .aspx e aplica uma ou mais folhas de estilos externas definido por CssRegistration.
DateTimeControl	Insere um controle de DateTime na página .aspx.
FormDigest	Insere uma validação de segurança na página .aspx
ListProperty	Retorna uma propriedade de uma lista especificada.
ProjectProperty	Retorna uma propriedade global do site atual.
RssLink	Insere um link para uma alimentação RSS na página .aspx.
ScriptLink	Fornece propriedades e métodos para registrar recursos, como, scripts em uma página de modo que eles possam ser aplicativos quando a página é processada.
Tema	Aplicar um tema à página .aspx.

Depurando Web parts

Você pode depurar um projeto do SharePoint que contém uma parte Web exatamente como você faria para depurar outros projetos do Visual Studio.Quando você inicia o depurador do Visual Studio, Visual Studio abrir o site do SharePoint.

Para começar a depurar seu código, adicione a parte Web a uma página de partes Web do SharePoint.

Para obter mais informações sobre como depurar projetos do SharePoint, consulte Solucionando problemas de soluções do SharePoint.

Restrições visuais de Web parts

Iniciando no Visual Studio, você pode adicionar soluções na área restrita visuais do SharePoint de partes Web e cultura soluções.No entanto, as partes Web visuais têm as seguintes restrições:

• As partes visuais da Web não suportam parâmetros substituíveis.Para obter mais informações, consulte Parâmetros substituíveis.

• Controles de usuário ou partes visuais da Web não podem ser arrastados e solto ou copiado para visual Web partes.Esta ação causa um erro de compilação.

• As partes visuais da Web não suportam diretamente tokens de servidor do SharePoint como $SPUrl.Para obter mais informações, consulte “restrições simbólicas em na área restrita Web Parts visual” no tópico Solucionando problemas de soluções do SharePoint.

• Visuais de partes Web em uma solução na área restrita obtém o erro “ocasionalmente, a solicitação na área restrita de execução de código foi recusada porque o serviço de hospedagem de código em área restrita de era muito ocupado tratando a solicitação.” Para obter mais informações sobre este erro, consulte a postagem Blog da equipe do desenvolvedor do SharePointno.

• a depuração Javascript do lado do não tem suporte no Visual Studio, mas a depuração do lado do cliente Javascript é suportada.

  Embora você possa adicionar o Javascript embutido em um arquivo de marcação do lado, depuração não há suporte para os pontos de interrupção adicionados à marcação.Para depurar o Javascript, fazer referência a um arquivo externo Javascript no arquivo de marcação em seguida, definir pontos de interrupção no arquivo de Javascript.

• A depuração de código em linha de ASP.NET deve ser feita no arquivo de código gerado em vez de no arquivo de marcação.

• As partes visuais da Web não oferecem suporte ao uso da diretiva de <@ Assembly Src= .

• Os controles Web do SharePoint e alguns controles de ASP.NET não são suportados no ambiente na área restrita o SharePoint.Se os controles sem suporte são usados em uma parte visual Web em uma solução na área restrita, o erro “, “o tema” do tipo ou o nome do namespace não existem no namespace “Microsoft.SharePoint.WebControls”” aparece.

Para obter mais informações sobre as soluções na área restrita, consulte Diferenças entre no modo seguro e soluções de Farm.

Criar um estilo mais antigo com base SharePoint- Web Parts

Você pode usar modelos no Visual Studio para criar partes personalizados de ASP.NET 2.0 Web do SharePoint.as partes deASP.NET 2.0 Web são compiladas sobre a infraestrutura de parte de ASP.NET Web e são o tipo recomendado para novos projetos.

Muito em alguns casos, você pode ter que criar uma parte Web usando a parte SharePoint- base da Web de um estilo mais antigo.Você pode usar Visual Studio para criar esses tipos de partes Web, mas o Visual Studio não fornece os modelos que são projetados especificamente para ajudá-lo a criar.

Para obter mais informações sobre quando você queira criar uma parte SharePoint- base da Web de um estilo mais antigos, consulte Infraestrutura de Web parts no Windows SharePoint Services.Para obter mais informações sobre como criar uma parte Web usando a parte SharePoint- base da Web de um estilo mais antigos, consulte Passo a passo que cria o SharePoint básico de Web parts.

Tópicos relacionados

Nome	Descrição
Como: criar uma parte da Web do SharePoint	Mostra como criar partes Web para páginas do SharePoint.
Como: criar uma parte da Web do SharePoint, usando um Designer.	Mostra como criar partes da Web do SharePoint usando uma superfície de design visual.
Como: criar um controle de usuário para uma página de aplicativo do SharePoint ou a Web Part	Mostra como criar um personalizado, os controles reutilizáveis que podem ser consumidos pela páginas do aplicativo e a partes da Web que executam no SharePoint.
Passo a passo: Criando uma Web Part do SharePoint	Descreve como criar uma parte da Web do SharePoint.
Passo a passo: Criando uma Web Part do SharePoint usando um Designer	Descreve como criar uma parte da Web do SharePoint arrastando os controles a uma superfície de design visual.
Passo a passo: Criando um web part do Silverlight que exiba OData para o SharePoint	Descreve como criar uma parte da Web do SharePoint que hospeda um aplicativo do Silverlight e exibe dados de listas do SharePoint.
Trabalhando com o Visual Web Developer	Descreve como usar o designer que aparece quando você abre um página da Web em seu projeto.