Compartilhar via

Fornecer informações de empacotamento e implantação em itens de projeto

  • Artigo

Todos os itens de projeto do SharePoint no Visual Studio têm propriedades que você pode usar para fornecer dados adicionais quando o projeto é implantado no SharePoint. Estas são as seguintes propriedades:

  • Propriedades de recurso

  • Receptores de recursos

  • Referências de saída do projeto

  • Entradas de controle seguro

    Essas propriedades são exibidas na janela Propriedades.

Propriedades de recursos

Use a propriedade Propriedades do Recurso para especificar os dados que o recurso usa. Propriedades de recurso são 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.

Quando você adiciona um valor de propriedade de recurso a um item de projeto, o valor é adicionado como um elemento no manifesto do recurso do item. Em um projeto de modelo BDC (Business Data Connectivity), por exemplo, a propriedade de recurso ModelFileName aparece como:

<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />

Depois de definir um valor de Propriedade de Recurso, ele será adicionado como um elemento FeatureProperty no arquivo .spdata do projeto. Para obter informações sobre como acessar as propriedades no SharePoint, consulte Classe SPFeaturePropertyCollection.

Valores de propriedade de recurso idênticos de todos os itens de projeto são mesclados no manifesto do recurso. No entanto, se dois itens de projeto diferentes especificarem a mesma chave de propriedade de recurso com valores não correspondentes, ocorrerá um erro de validação.

Para adicionar propriedades de recurso diretamente ao arquivo de recurso (.feature), chame o método Add de modelo de objeto do SharePoint do Visual Studio. Se você usar esse método, lembre-se de que a mesma regra sobre a adição de valores de propriedade de recurso idênticos em Propriedades do Recurso também se aplica às propriedades adicionadas diretamente ao arquivo de recurso.

Receptor de recursos

Receptores de recursos são códigos que é executado quando determinados eventos ocorrem no recurso que contém um item de projeto. Por exemplo, você pode definir receptores de recursos que são executados quando o recurso é instalado, ativado ou atualizado. Uma maneira de adicionar um receptor de recurso é adicioná-lo diretamente a um recurso, conforme descrito em Passo a passo: adicionar receptores de eventos de recurso. Outra maneira é referenciar um nome de classe receptor de recurso e um assembly na propriedade Receptor de Recursos.

Método direto

Quando você adiciona um receptor de recurso diretamente a um recurso, um arquivo de código é colocado sob o nó Recurso em Gerenciador de Soluções. Quando você cria sua solução do SharePoint, o código é compilado em um assembly e implantado no SharePoint. Por padrão, as propriedades de Recurso Assembly do Receptor e Classe de Receptor fazem referência ao nome da classe e ao assembly.

Método Reference

Outra maneira de adicionar um receptor de recurso é usando a propriedade Receptor de Recurso de um item de projeto para fazer referência a um assembly de receptor de recurso. O valor da propriedade Receptor de Recurso tem duas subpropriedades: Assembly e Nome da Classe. O assembly deve usar seu nome totalmente qualificado e "forte" e o nome da classe deve ser o nome de tipo completo. Para obter mais informações, consulte Assemblies com nome forte. Depois de implantar a solução no SharePoint, o recurso usa o receptor de recurso referenciado para manipular eventos de recurso.

No momento da compilação da solução, os valores da propriedade do receptor de recursos no recurso e seus projetos se mesclam para definir os atributos ReceiverAssembly e ReceiverClass do elemento Feature no manifesto do recurso do arquivo de solução do SharePoint (.wsp). Portanto, se os valores da propriedade Assembly e Class Name de um item de projeto e um recurso forem especificados, os valores de propriedade do item de projeto e do recurso deverão corresponder. Se os valores não corresponderem, você receberá um erro de validação. Se você quiser que um item de projeto faça referência a um assembly de receptor de recurso diferente do que seu recurso usa, mova-o para outro recurso.

Se você fizer referência a um assembly de receptor de recursos que ainda não está no servidor, também deverá incluir o próprio arquivo de assembly no pacote; O Visual Studio não o adiciona para você. Quando você implanta o recurso, o arquivo de assembly é copiado para o GAC (cache de assembly global) do sistema ou para a pasta Bin no diretório físico do SharePoint. Para obter mais informações, consulte Como adicionar e remover assemblies adicionais.

Para obter mais informações sobre receptores de recursos, consulte Receptor de eventos de recurso e eventos de recurso.

Referências de saída do projeto

A propriedade Referências de Saída do Projeto especifica uma dependência, como um assembly, que o item de projeto precisa executar. Por exemplo, suponha que sua solução tenha um projeto BDC e um projeto de classe. Se o projeto BDC tiver uma dependência no assembly que é saída pelo projeto de classe, você poderá referenciar o assembly na propriedade Referências de Saída de Projeto do projeto BDC. Quando o projeto BDC é empacotado, o assembly dependente é incluído no pacote.

As referências de saída do projeto geralmente são assemblies, mas em alguns casos (como projetos do Silverlight) podem ser outros tipos de arquivo.

Para obter mais informações, consulte Como adicionar uma referência de saída de projeto.

Entradas de controle seguro

O SharePoint fornece um mecanismo de segurança, chamado entradas de controle seguro, para limitar o acesso de usuários não confiáveis a determinados controles. Por design, o SharePoint permite que usuários não confiáveis carreguem e criem páginas ASPX no servidor do SharePoint. Para impedir que esses usuários adicionem código não seguro a páginas ASPX, o SharePoint limita seu acesso a controles seguros. Os controles seguros são controles ASPX e Web Parts designados como seguros e que podem ser usados por qualquer usuário em seu site. Para obter mais informações, consulte Etapa 4: Adicionar sua Web Part à Lista de Controles Seguros.

Cada item de projeto do SharePoint no Visual Studio tem uma propriedade chamada Entradas de Controle Seguro que tem duas subpropriedades boolianas: Safe e Safe Against Script. A propriedade Safe especifica se os usuários não confiáveis podem acessar um controle. A propriedade Safe Against Script especifica se os usuários não confiáveis podem exibir e alterar as propriedades de um controle.

As entradas de controle seguro são referenciadas em uma base de assembly. Adicione entradas de controle seguro ao assembly de um projeto inserindo-as na propriedade Entradas de Controle Seguro do item de projeto. No entanto, você também pode adicionar entradas de controle seguro ao assembly de um projeto por meio da guia Avançado no Designer de Pacotes ao adicionar um assembly adicional ao pacote. Para obter mais informações, consulte Como marcar controles como controles seguros ou Registrar um assembly de Web Part como um controle seguro.

Entradas XML para controles seguros

Quando você adiciona uma entrada de controle seguro a um item de projeto ou ao assembly do projeto, uma referência é gravada no manifesto do pacote no seguinte formato:

<Assemblies>
    <Assembly Location="<assembly name>.dll"
      DeploymentTarget="<'GlobalAssemblyCache' or 'WebApplication'">>
        <SafeControls>
            <SafeControl Assembly="<assembly name>.dll" Namespace=
              "<SharePoint project name>" Safe="<true/false>"
                TypeName="<control name>"
                SafeAgainstScript="<true/false>" />
        </SafeControls>
    </Assembly>
</Assemblies>

Conteúdo relacionado