Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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. Essas propriedades são as seguintes:
Propriedades da Funcionalidade
Recetores de Funcionalidades
Referências de resultados do projeto
Entradas de controle seguras
Essas propriedades aparecem na janela Propriedades .
Propriedades da característica
Use a propriedade Propriedades do recurso para especificar os dados que o recurso usa. Os dados de propriedades do 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 de propriedade em seu código.
Quando adiciona um valor de uma propriedade de uma funcionalidade a um item de projeto, o valor é adicionado como um elemento no manifeste da funcionalidade do item. Em um projeto de modelo BDC (Conectividade de Dados Corporativos), por exemplo, a propriedade do recurso ModelFileName aparece como:
<Property Key="ModelFileName" Value="BdcModel1\BdcModel1.bdcm" />
Depois de definir um valor Feature Property, ele é adicionado como um elemento FeatureProperty no arquivo .spdata do projeto. Para obter informações sobre como acessar as propriedades no SharePoint, consulte SPFeaturePropertyCollection Class.
Valores de propriedade de funcionalidade idênticos de todos os itens de projeto são integrados no manifesto da funcionalidade. 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 Addde 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.
Recetor de funcionalidades
Receptores de funcionalidades são códigos que são executados quando determinados eventos ocorrem numa funcionalidade que contém um item de projeto. Por exemplo, você pode definir recetores de recursos que são executados quando o recurso é instalado, ativado ou atualizado. Uma maneira de adicionar um recetor de recurso é adicioná-lo diretamente a um recurso, conforme descrito em Passo a passo: Adicionar recetores de eventos de recurso. Outra maneira é fazer referência ao nome de uma classe de receptor de funcionalidade e ao assembly na propriedade Feature Receiver.
Método direto
Quando adiciona um receptor de funcionalidade a uma funcionalidade diretamente, um arquivo de código é colocado sob o nó Feature no 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 Receiver Assembly e Receiver Class fazem referência ao nome da classe e ao assembly.
Método de referência
Outra maneira de adicionar um recetor de recurso é usando a propriedade Feature Receiver de um item de projeto para fazer referência a um conjunto de recetor de recurso. O valor da propriedade Feature Receiver tem duas subpropriedades: Assembly e Class Name. A assemblagem deve usar o seu nome "forte" totalmente qualificado 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 recetor de recurso referenciado para manipular eventos de recurso.
No momento da compilação da solução, os valores da propriedade do recetor de recurso no recurso e seus projetos se fundem 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 das propriedades Assembly e Nome da Classe de um item do projeto e de uma funcionalidade forem ambos especificados, os valores das propriedades do item do projeto e da funcionalidade devem 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 conjunto de recetor de recurso diferente daquele que seu recurso usa, mova-o para outro recurso.
Se você fizer referência a um assembly de recetor de recurso que ainda não esteja no servidor, também deverá incluir o próprio arquivo de assembly no pacote; Visual Studio não o adiciona para você. Quando você implanta o recurso, o arquivo de assembly é copiado para o cache de assembly global (GAC) do sistema ou para 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 recetores de recursos, consulte Feature Event Receiver e Feature Events.
Referências de resultados do projeto
A propriedade Project Output References especifica uma dependência, como um assembly, que seu 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 do assembly que é gerado pelo projeto de classe, você poderá fazer referência ao assembly na propriedade Project Output References do projeto BDC. Quando o projeto BDC é empacotado, a assemblagem dependente é incluída 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 controlo seguras
O SharePoint fornece um mecanismo de segurança, chamado entradas de controle seguras, 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 evitar que esses usuários adicionem código não seguro a páginas ASPX, o SharePoint limita seu acesso a controles seguros. 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 Safe Control Entries que tem duas subpropriedades booleanas: Safe e Safe Against Script. A propriedade Safe especifica se usuários não confiáveis podem acessar um controle. A propriedade Safe Against Script especifica se usuários não confiáveis podem exibir e alterar as propriedades de um controle.
As entradas de controlo seguras são referenciadas a nível de montagem. Você adiciona entradas de controle seguras ao assembly de um projeto inserindo-as na propriedade Safe Control Entries do item de projeto. No entanto, também é possível adicionar entradas de controlo seguras ao assembly de um projeto através do separador Avançado no Editor de Pacotes ao adicionar um assembly adicional ao pacote. Para obter mais informações, consulte Como marcar controlos como controlos seguros ou Registar uma montagem de Web Part como um controlo seguro.
Entradas XML para controles seguros
Quando você adiciona uma entrada de controle segura 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>