Desenvolver soluções do SharePoint
Vários modelos de tipo de projeto do SharePoint estão disponíveis no Visual Studio para criar sites e elementos de site do SharePoint. Para obter uma lista dos tipos de projeto disponíveis, consulte Modelos de projeto e item de projeto do SharePoint. Consulte a seguir uma descrição dos elementos e propriedades de um projeto do SharePoint.
Para obter informações sobre suplementos do SharePoint, consulte Criar suplementos do SharePoint.
Elementos de um projeto do SharePoint.
Os nós em um projeto do SharePoint são conhecidos como itens do SharePoint. Os itens do SharePoint também podem conter um ou mais subfiles, conhecidos como arquivos de item do SharePoint, como arquivos de configuração XML, formulários .aspx e muito mais.
Em vez de criar projetos usando modelos de projeto que já estão preenchidos com arquivos de item de projeto, você pode usar o modelo Projeto Vazio para criar um projeto vazio do SharePoint e, em seguida, adicionar itens de projeto manualmente. Os projetos do SharePoint também podem, opcionalmente, conter um ou mais arquivos de recurso (para ativação no SharePoint) e um arquivo de pacote no qual distribuir o projeto.
Nós especiais
Cada projeto do SharePoint contém dois nós que não podem ser renomeados, excluídos, recortados, copiados ou arrastados do projeto. Esses nós são os seguintes:
Recursos
Pacote
Ambos os nós sempre aparecem em todos os projetos do SharePoint, mesmo que nenhum recurso ou pacote seja definido para o projeto.
Nó Recursos
O nó Recursos contém um ou mais recursos de projeto do SharePoint. Um recurso é um contêiner de extensões para o SharePoint. Depois que um recurso é implantado no servidor do SharePoint, ele pode ser incluído em definições de site ou ativado individualmente por administradores do SharePoint em sites do SharePoint. Para saber mais, consulte Trabalhando com Recursos.
Quando você adiciona um item, como um tipo de conteúdo ou uma instância de lista, a um projeto do SharePoint, ele é adicionado a um recurso no nó Recursos. O escopo do item determina se ele é adicionado a um recurso novo ou existente. Se o novo item tiver o mesmo escopo de um recurso existente, ele será adicionado a esse recurso. Caso contrário, o item será adicionado a um novo recurso.
Para adicionar manualmente um recurso, execute o comando Adicionar Recurso no menu de atalho do nó de recurso. Você pode exibir ou alterar o conteúdo de um recurso usando o Designer de Recursos. Para obter mais informações, consulte Como personalizar um recurso do SharePoint.
Quando um recurso é adicionado a um projeto do SharePoint, ele aparece em Gerenciador de Soluções como um nó com o nome padrão Featurex.feature, em que x é um número exclusivo. Depois que um recurso é implantado no SharePoint Server, um administrador do SharePoint pode ativá-lo, tornando-o disponível para usuários do site do SharePoint.
Nó do pacote
O nó Pacote contém um único arquivo que serve como o mecanismo de distribuição para o projeto do SharePoint. Esse arquivo, conhecido como pacote de solução, é baseado em .CAB com uma extensão .WSP. Um pacote de solução é um arquivo implantável e reutilizável que contém um conjunto de recursos, definições de site e assemblies que se aplicam a sites do SharePoint e que você pode habilitar ou desabilitar individualmente. O nó Pacote também sempre contém um arquivo chamado Package.wspdef, um arquivo de definição XML para o pacote. Depois que um pacote é implantado no servidor que está executando o SharePoint, o administrador do SharePoint pode instalá-lo e ativar seus recursos.
Você pode exibir ou alterar o conteúdo do pacote no Designer de Pacotes clicando duas vezes no nó do pacote ou abrindo seu menu de atalho e escolhendo Abrir. Para obter mais informações, consulte Criar pacotes de solução do SharePoint.
Propriedade de projeto e de item de projeto do SharePoint.
Projetos do SharePoint, assim como outros projetos do Visual Studio, exibem propriedades no janela Propriedades e na Página de Propriedades. As propriedades exibidas dependem do nó selecionado.
Quando um projeto do SharePoint, item de projeto ou nó de arquivo de item de projeto é selecionado em Gerenciador de Soluções, as seguintes propriedades aparecem no janela Propriedades ou na Página de Propriedades:
Propriedades do projeto
| Nome da propriedade | Descrição |
|---|---|
| Configuração da Implantação ativa | Especifica a série de etapas executadas durante a implantação. Para saber mais, confira Como editar uma configuração de implantação do SharePoint. |
| Destino de implantação de assembly | Determina onde os assemblies de aplicativos do SharePoint estão localizados. Os valores de local do assembly válidos são GlobalAssemblyCache (padrão) ou WebApplication. Se a propriedade Solução em Área Restrita estiver definida como true, essa propriedade será desabilitada. |
| Retrair automaticamente após a depuração | Especifica se a solução implantada será retirada automaticamente do SharePoint depois de executar o aplicativo no modo de depuração no Visual Studio. Quando selecionada, a solução é retraída quando o IDE volta ao modo de exibição de design após a depuração. Quando limpa, a solução não é retraída. Para saber mais, confira Retrair uma solução. |
| Editar configurações | Especifica a configuração de implantação a ser usada no projeto. Para obter mais informações, consulte Como editar uma configuração de implantação do SharePoint e Implantar, publicar e atualizar pacotes de solução do SharePoint. |
| Habilitar a depuração do Silverlight (em vez da depuração de script) | Quando selecionado, o depurador do Silverlight é anexado ao processo de depuração. Quando limpo, o depurador script é anexado ao processo de depuração. Para obter mais informações, consulte Visão geral de depuração do Silverlight. |
| Incluir assembly no pacote | Especifica se o assembly do projeto é empacotado no momento da compilação ou não. |
| Linha de comando de pós-implantação | Especifica os comandos a serem executados após a implantação da solução do SharePoint. Essa linha dá suporte a comandos em lote, bem como à resolução de variáveis do MSBuild. Para saber mais, confira Como definir comandos de implantação do SharePoint. |
| Linha de comando de pré-implantação | Especifica os comandos a serem executados antes da implantação da solução do SharePoint. Essa linha dá suporte a comandos em lote, bem como à resolução de variáveis do MSBuild. Para saber mais, confira Como definir comandos de implantação do SharePoint. |
| Arquivo de Projeto | O nome do arquivo que contém build, configuração e outras informações sobre o projeto. |
| Pasta de projeto | O local do arquivo de projeto no sistema. (Somente leitura.) |
| Solução em área restrita | Especifica se o projeto deve ser implantado como uma solução em área restrita, também conhecida como solução criada pelo usuário. As soluções em área restrita não são necessariamente confiáveis. Um valor true significa que o projeto é implantado como uma solução em área restrita, um valor false significa que o projeto é implantado como uma solução de farm. Para obter mais informações, consulte Considerações e diferenças da solução em área restrita e Diferenças entre soluções de área restrita e farm. |
| URL do site | Especifica a URL do site de destino para este projeto. |
| Item de inicialização | Especifica o primeiro item no projeto a ser executado. |
Quando você escolhe um arquivo de item do SharePoint (como um fluxo de trabalho ou um recurso no nó Recursos), as seguintes propriedades aparecem no janela Propriedades:
Propriedades do item de projeto
| Nome da propriedade | Descrição |
|---|---|
| Resolução do Conflito de Implantação | Especifica a ação a ser tomada ao implantar um item de projeto cujas propriedades são idênticas às de um item que já está no servidor. Para obter mais informações, consulte Solução de problemas de empacotamento e implantação do SharePoint. |
| Propriedades de recurso | Especifica um conjunto de valores (armazenados como pares chave/valor) que é incluído com um recurso quando ele é implantado no SharePoint. Depois que o recurso for implantado, você poderá acessar os valores da propriedade no código. Para obter mais informações, confira Fornecendo informações de empacotamento e implantação em itens de projeto. |
| Receptor de recursos | Fornece código que é executado quando determinados eventos ocorrem no recurso que contém um item de projeto. Para obter mais informações, confira Fornecendo informações de empacotamento e implantação em itens de projeto. |
| Nome da Pasta | O nome da pasta do item de projeto do SharePoint. |
| Referências de saída do projeto | Especifica uma dependência, como um assembly, que o item de projeto precisa executar. Para obter mais informações, confira Fornecendo informações de empacotamento e implantação em itens de projeto. |
| Entradas de controle seguro | Especifica os controles que são seguros para os usuários não confiáveis editarem. Para obter mais informações, confira Fornecendo informações de empacotamento e implantação em itens de projeto. |
Propriedades do arquivo de item do projeto
| Nome da propriedade | Descrição |
|---|---|
| Criar ação | Especifica como o arquivo se relaciona aos processos de criação e implantação. Para obter mais informações, consulte Propriedades do arquivo. |
| Copiar para o diretório de saída | Especifica se os arquivos de origem serão copiados para o diretório Saída. Pode ser um dos seguintes valores: - Não copiar - Sempre copiar - Copiar se for mais recente Para obter mais informações, consulte Propriedades do arquivo. |
| Ferramenta personalizada | Especifica o nome de uma ferramenta, se houver, que transforma o arquivo em tempo de design e coloca a saída da transformação em outro arquivo. Por exemplo, um arquivo de conjunto de dados (.XSD) tem uma ferramenta personalizada padrão. Para obter mais informações, consulte Propriedades do arquivo. |
| Namespace de ferramenta personalizada | O namespace no qual a saída da ferramenta personalizada é copiada. Para obter mais informações, consulte Propriedades do arquivo. |
| Local da implantação | O caminho totalmente qualificado do arquivo no servidor do SharePoint. Esse caminho é composto pelas subpropriedades Raiz da Implantação e Caminho de Implantação. |
| Caminho de implantação | O caminho relativo do arquivo no arquivo do SharePoint Server, como Workflow1\. O caminho totalmente qualificado para o arquivo é criado concatenando o valor do Caminho de Implantação até o final do valor raiz da implantação. Selecionar um valor de RootFile para a propriedade Tipo de Implantação altera a propriedade Raiz de Implantação para <SharePointRoot>\, resultando em um caminho totalmente qualificado de <SharePointRoot>\Workflow1\. Para obter mais informações, consulte Empacotamento e implantação de soluções do SharePoint. |
| Raiz de implantação | Cadeia de caracteres. A pasta raiz em que o arquivo é implantado no SharePoint Server. Por exemplo, <SharePointRoot>\Template\Features\<FeatureName>\. O valor da propriedade Raiz de Implantação é determinado pela configuração Tipo de Implantação. |
| Tipo de implantação | O tipo de implantação do arquivo, que determina seu valor raiz de implantação. Pode ser um dos seguintes valores: NoDeployment: <nenhum valor> ElementManifest: <SharePointRoot>\Template\Features\<FeatureName>\ ElementFile: <SharePointRoot>\Template\Features\<FeatureName>\ TemplateFile: <SharePointRoot>\Template\ RootFile: <SharePointRoot>\ GlobalResource: <SharePointRoot>\Resources\ ClassResource: <ClassResourcePath>\ Para obter mais informações, consulte DeploymentType. |
| Nome do Arquivo | O nome do arquivo ou pasta do arquivo de item. |
| Caminho completo | O local do arquivo para o item. (Somente leitura.) |
Tópicos relacionados
| Título | Descrição |
|---|---|
| SharePoint Modelos de projeto e de item de projeto | Descreve os modelos de projeto e de item de projeto do SharePoint disponíveis para você no Visual Studio. |
| Como adicionar itens a um Projeto do SharePoint | Descreve como adicionar itens novos ou existentes a um projeto do SharePoint do Visual Studio. |
| Instruções passo a passo: criar uma coluna de site, tipo de conteúdo e lista do SharePoint | Leva você passo a passo na criação de um campo de cliente, tipo de conteúdo, definição de lista e instância de lista. |
| Como criar um receptor de evento | Descreve como adicionar um receptor de evento para o projeto criado em Passo a passo: criar uma coluna de site, um tipo de conteúdo e uma lista para o SharePoint. |
| Criar soluções de fluxo de trabalho do SharePoint | Descreve como criar projetos de fluxo de trabalho que incluem formulários de associação de fluxo de trabalho e formulários de iniciação de fluxo de trabalho. |
| Criar páginas para o SharePoint | Descreve como você pode criar páginas como páginas de aplicativo, páginas do site, páginas mestras e layouts de página para o SharePoint. |
| Criar Web Parts para o SharePoint | Descreve como adicionar controles que permitem que os usuários modifiquem diretamente o conteúdo, a aparência e o comportamento das páginas de sites do SharePoint usando um navegador. |
| Criar controles reutilizáveis para Web Parts ou páginas de aplicativo | Descreve como criar controles de usuário que podem ser consumidos por páginas de aplicativo e Web Parts executados no SharePoint. |
| Integrar dados corporativos ao SharePoint | Descreve como integrar dados de serviços Web e aplicativos de servidor back-end em um aplicativo do SharePoint. |
| Criar definições de site para o SharePoint | Descreve como criar definições de site: modelos usados para criar sites do SharePoint. |
| Importando itens de um local do SharePoint existente | Descreve como importar itens como tipos de conteúdo e módulos de um site existente do SharePoint para um projeto do SharePoint do Visual Studio. |
| Usando módulos para incluir arquivos na solução | Descreve como usar módulos para implantar arquivos do seu projeto do Visual Studio no site do SharePoint. |
| Procurar conexões do SharePoint usando o Gerenciador de Servidores | Descreve como procurar sites locais do SharePoint usando o Gerenciador de Servidores. |
| Fornecer informações de empacotamento e implantação em itens de projeto | Descreve como usar propriedades de item de projeto para fornecer informações de empacotamento e implantação para projetos, como entradas de controle seguro, referências de saída de projeto e propriedades de recurso. |
| Como adicionar e remover pastas mapeadas | Descreve como as pastas mapeadas podem ser adicionadas ao seu projeto para facilitar o acesso aos recursos do SharePoint. |
| Considerações de solução em área restrita | Descreve os problemas associados a soluções em área restrita. |
| Segurança das soluções do SharePoint | Descreve as considerações de segurança para desenvolver soluções do SharePoint no Visual Studio. |
| Caixa de diálogo Seletor de URL (desenvolvimento do SharePoint no Visual Studio) | Descreve uma caixa de diálogo que você pode usar para adicionar referências de caminho a recursos em seu projeto ou no servidor local do SharePoint. |