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

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

Propriedades de recurso
Receptores de recurso
Referências de saída do projeto
Entradas de controle de segurança

Essas propriedades são exibidas no Propriedades janela.

Propriedades de recurso

Use o Propriedades de recurso propriedade para especificar os dados que o recurso usa.Dados de propriedades de recurso são um conjunto de valores (armazenados como pares chave/valor) que acompanha um recurso quando ele implementa para o SharePoint.Depois que o recurso for implantado, você pode acessar os valores de propriedade em seu código.

Quando você adiciona um valor de propriedade de recurso para um item de projeto, o valor é adicionado como um elemento no manifesto do recurso do item.Em um projeto de modelo de conectividade de dados de negócios (BDC), 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 é adicionado como um elemento de FeatureProperty no arquivo de .spdata do projeto.Para obter informações sobre como acessar as propriedades no SharePoint, consulte SPFeaturePropertyCollection classe.

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

Para adicionar propriedades de recurso diretamente para o arquivo de recurso (* .feature), chamar o Visual Studio método de modelo de objeto do SharePoint Add.Se você usar esse método, lembre-se de que a mesma regra sobre como adicionar valores de propriedade de recurso idêntico nas propriedades de recurso também se aplica a propriedades adicionadas diretamente ao arquivo de recurso.

Receptor de recurso

Receptores de recurso são o código que é executado quando ocorrem determinados eventos para um item de projeto que contém o recurso.Por exemplo, você pode definir os receptores de recurso que são executados quando o recurso é instalado, ativado ou atualizado.Uma maneira de adicionar um destinatário de recurso é para adicioná-lo diretamente a um recurso, conforme descrito em Passo a passo: Adicionar receptores de evento do recurso.Outra maneira é fazer referência a um nome de classe do receptor do recurso e o assembly a Recurso receptor propriedade.

Método direto

Quando você adiciona um destinatário de recurso a um recurso diretamente, um arquivo de código está sob o recurso nó no Solution Explorer.Quando você constrói sua solução do SharePoint, o código é compilado em um assembly e implanta no SharePoint.Por padrão, as propriedades de recurso Assembly do receptor e Classe receptora o nome da classe e o conjunto de referência.

Método de referência

Outra maneira de adicionar um destinatário de recurso está usando o O receptor de recurso propriedade de um item de projeto para fazer referência a um assembly do receptor de recurso.O valor da propriedade de receptor de recurso tem dois subpropriedades: Assembly e Nome da classe.O assembly deve usar a sua totalmente qualificado, o nome "forte" e o nome da classe devem ser o nome completo do tipo.Para obter mais informações, consulte Strong-Named Assemblies.Após implantar a solução para o SharePoint, o recurso usa o receptor referenciado para manipular eventos de recurso.

Em tempo de compilação da solução, os valores de propriedade do receptor do recurso em seus projetos e o recurso mesclam juntos para definir os atributos ReceiverAssembly e ReceiverClass do elemento Feature no manifesto do recurso do arquivo de solução (. wsp) do SharePoint.Portanto, se os valores de propriedade do Assembly e o nome da classe de um item de projeto e um recurso forem especificados, os valores de propriedade de item e o recurso de projeto devem corresponder.Se os valores não forem iguais, você receberá um erro de validação.Se desejar que um item de projeto para fazer referência a um assembly do receptor de recurso diferente do seu recurso usa, movê-lo para outro recurso.

Se você faz referência a um assembly do receptor de recurso que não ainda esteja no servidor, você também deve incluir o próprio arquivo de assembly no pacote. Visual Studionão adiciona-lo para você.Quando você implanta o recurso, o arquivo de assembly é copiado do sistema global assembly cache (GAC) ou a pasta Bin no diretório físico do SharePoint.Para obter mais informações, consulte como: Como: adicionar e remover Assemblies adicionais.

Para obter mais informações sobre os receptores de recurso, consulte Recurso de receptor de eventos e eventos de recurso.

Referências de saída do projeto

A propriedade de referências de saída do projeto Especifica uma dependência, como, por exemplo, um assembly, que precisa de seu item de projeto para executar.Por exemplo, suponha que a solução tiver um projeto do BDC e um projeto de classe.Se o projeto do BDC tem uma dependência no assembly cuja saída é feito pelo projeto de classe, você pode referenciar o assembly na propriedade de referências de saída do projeto do projeto BDC.Quando o projeto do BDC é compactado, o assembly dependente está incluído no pacote.

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

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

Entradas de controle de segurança

O SharePoint oferece um mecanismo de segurança, chamado de entradas de controle seguro, para limitar o acesso de usuários não confiáveis a certos controles.Por design, o SharePoint permite que os usuários não confiáveis carregar e criar páginas ASPX no servidor do SharePoint.Para evitar que esses usuários adicionando o código não seguro para páginas ASPX, o SharePoint limita seu acesso ao controles seguros.Controles seguros são controles ASPX e Web parts designados como seguro e que pode ser usada por qualquer usuário no seu site.Para obter mais informações, consulte etapa 4: adicionar a Web Part à lista de controles seguros.

Cada item de projeto do SharePoint no Visual Studio tem uma propriedade chamada Entradas de controle de segurança que tem dois subpropriedades booleanas: seguro e Seguro contra Script. A propriedade de segurança Especifica se os usuários não confiáveis podem acessar um controle.A propriedade seguro contra Script Especifica se os usuários não confiáveis podem exibir e alterar propriedades de um controle.

Entradas de controle seguro são referenciadas em uma base do assembly.Adicionar entradas de controle seguro para o assembly do projeto, inserindo-os no item de projeto Entradas de controle de segurança propriedade.No entanto, você também pode adicionar entradas de controle seguro para o assembly do projeto por meio do Advanced guia o Designer do pacote quando você adiciona um assembly adicional ao pacote.Para obter mais informações, consulte Como: controla o marca como seguros para execução de controles ou Registrando um conjunto de Web Parts como um controle seguro.

Entradas XML para controles seguros

Quando você adiciona uma entrada de controle seguro para um item de projeto ou para o assembly do projeto, uma referência é gravada para o 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>