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 para SharePoint. Essas propriedades são:
Propriedades de recurso
Receptores de recurso
Referências de saída do projeto
Entradas de controle de segurança
Essas propriedades aparecem 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 implanta o SharePoint. Depois que o recurso é implantado, você pode acessar os valores de propriedade em seu 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 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 A classe de SPFeaturePropertyCollection.
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 de projeto diferentes especificar a mesma chave de propriedade de recurso com valores não-correspondentes, 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 determinados eventos ocorrem em 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 receptor de recurso é para adicioná-lo diretamente a um recurso, conforme descrito em Demonstra Passo a passo: Adicionar os receptores de evento do recurso. Outra maneira é fazer referência a um nome de classe do receptor do recurso e o assembly de O receptor de recurso propriedade.
Método direto
Quando você adiciona um destinatário de recurso a um recurso diretamente, um arquivo de código é colocado sob o recurso o nó no Solution Explorer. Quando você constrói sua solução do SharePoint, o código é compilado em um assembly e implanta o 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 receptor de recurso é 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 recurso receptor possui dois subpropriedades: Assembly e nome da classe. O assembly deve usar seu totalmente qualificado, "forte" nome 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 recurso 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 para definir os atributos de ReceiverAssembly e ReceiverClass do elemento de recurso 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 corresponderem, 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ê referencia um assembly do receptor de recurso que não ainda esteja no servidor, você também deve incluir o arquivo de montagem no pacote. Visual Studionão adicioná-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 de física de 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, seu item de projeto precisa ser executado. 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 do assembly de saída é feito pelo projeto de classe, você pode referenciar o assembly na propriedade de referências de saída do projeto do projeto do BDC. Quando o projeto do BDC é compactado, o assembly dependente está incluído no pacote.
Referências de saída do projeto geralmente são assemblies, mas em alguns casos (como os projetos do Silverlight) podem ser outros tipos de arquivo.
Para obter mais informações, consulte Como: Adicione 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 dos 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 impedir 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 do ASPX e Web parts designados como seguro e que pode ser usado por qualquer usuário no seu site. Para obter mais informações, consulte etapa 4: Adiciona a Web Part para a 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: Safe e seguro contra o Script. A propriedade de segurança Especifica se os usuários não confiáveis podem acessar um controle. A propriedade de Script de segurança contra Especifica se os usuários não confiáveis podem exibir e alterar as propriedades do 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 Avançado guia o Designer do pacote quando você adiciona um assembly adicional para o pacote. Para obter mais informações, consulte Como: Controles de marca como controles seguros 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>
Consulte também
Conceitos
Usando os módulos para incluir os arquivos da solução