Alterações no design dos projetos do Office destinados ao .NET Framework 4 ou ao .NET Framework 4.5
Iniciando em Visual Studio 2010, o Visual Studio introduziu algumas alterações ao design do Office projetos que destinam-se .NET Framework 4 ou .NET Framework 4.5.Se você estiver familiarizado com o Office se projetos em versões anteriores do Visual Studio, você está ciente dessas alterações antes que você desenvolver projetos do Office que usam essas versões do.NET Framework.Por padrão, todos os projetos que você cria usando o destino de Visual Studio 2012 essas versões.
As seções a seguir descrevem essas alterações de design de projeto do Office.
Entendendo o design Interface- base do Visual Studio 2010 Tools for Office Runtime
Quando você desenvolver um projeto do Office que tem como alvo .NET Framework 4 ou .NET Framework 4.5, a maioria dos tipos que você usa no 2010 Visual Studio Tools for Office Runtime são interfaces.Esta é uma mudança importante de versões anteriores de Visual Studio Tools for Office Runtime, onde esses tipos são classes.Por exemplo, quando você seleciona .NET Framework 4 ou .NET Framework 4.5, os tipos de Worksheet e de Document são interfaces em vez de classes.Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.
Para quaisquer tipos que você pode criar uma instância diretamente nas versões anteriores de Visual Studio Tools for Office Runtime, você agora usa métodos de objeto de Globals.Factory para obter instâncias desses tipos.Por exemplo, para obter um objeto que implementa a interface de SmartTag , use o método de Globals.Factory.CreateSmartTag .Para obter mais informações, consulte os seguintes tópicos:
.gif "Ee712588.collapse_all(pt-br,VS.110).gif")
Novas classes base em projetos do Office
O novo interface- design baseado no Visual Studio 2010 Tools for Office Runtime afeta as classes gerados em projetos do Office, como ThisDocument, ThisWorkbook, e ThisAddIn.No Office projetos que direcionam o.NET Framework 3.5 e versões anteriores estrutura, essas classes gerados derivam de classes em Visual Studio Tools for Office Runtime como Microsoft.Office.Tools.Word.Document, Microsoft.Office.Tools.Excel.Worksheet, e Microsoft.Office.Tools.AddIn.Em projetos que destinam-se .NET Framework 4 ou .NET Framework 4.5, essas classes de Visual Studio Tools for Office Runtime agora são interfaces.Portanto as classes gerados em projetos do Office podem não derivar sua implementação de eles.Em vez disso, as classes gerados derivam das novas classes base como DocumentBase, WorksheetBase, e AddInBase.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação. e Programação personalizações em nível de documento.
As classes base não são parte de Visual Studio Tools for Office Runtime redistribuível.Em vez disso, são definidos em assemblies de utilitários que são incluídos com Visual Studio 2012.Esses assemblies são copiados para a pasta de saída quando você compila projetos do Office e deve ser implantado com sua solução.Para obter mais informações sobre assemblies de utilitários, consulte Módulos (assemblies) no Visual Studio Tools para Office Runtime.
Alterações significativas em projetos do Office que Retargeted o .NET Framework 4
A tabela a seguir lista as alterações significativas chave que você pode encontrar em projetos do Office que retargeted a .NET Framework 4 ou a .NET Framework 4.5.Para obter mais detalhes, consulte Migrando soluções do Office para o .NET Framework 4 ou o .NET Framework 4.5.
Última alteração |
Resultado |
|---|---|
SecurityTransparentAttribute não é usado ou suporte em projetos do Office. |
Você deve remover esse atributo do arquivo AssemblyInfo de código que no Office se projetos que você atualiza do Visual Studio 2008.Para obter mais informações, consulte Alterações necessárias para executar projetos do Office migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
ExcelLocale1033Attribute não é usado ou suporte em projetos do excel. |
Você deve remover esse atributo de arquivo de código AssemblyInfo em projetos do excel.Para obter mais informações, consulte Atualizando projetos do Excel e do Word migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
O modelo de programação de itens de projeto de Faixa de Opções (Visual Designer) foi alterado. |
Você deve modificar o arquivo code-behind para todos os itens de fita em seu projeto.Você também deve alterar qualquer código que criar uma instância de controles fita em tempo de execução, manipular eventos de fita, ou definir a posição de um componente de fita programaticamente.Para obter mais informações, consulte Atualizando personalizações da Faixa de Opções nos projetos do Office migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
O modelo de programação de regiões do Outlook foi alterado. |
Você deve modificar o arquivo code-behind para todas as regiões de formulário no seu projeto e em qualquer código que criar uma instância determinadas classes de região de formulário em tempo de execução.Para obter mais informações, consulte Atualizando as regiões do formulário em projetos do Office migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
O modelo de programação para marcas inteligentes em projetos do excel e do Word foi alterado.Marcas inteligentes são substituídas em Excel 2010 e em Word 2010. |
Se sua solução usa marcas inteligentes, ocorrerão erros quando você criar o projeto.Como as marcas inteligentes são substituídas em Excel 2010 e em Word 2010, você deve remover as marcas antes que você possa testar e depurar a solução em Visual Studio 2012. |
A sintaxe dos métodos de GetVstoObject e de HasVstoObject mudou |
Você deve passar o objeto de Globals.Factory a esses métodos quando você acessa nos objetos nativos dos assemblies de interoperabilidade primários (PIAs), ou você pode acessar esses métodos no objeto que é retornado pela propriedade de Globals.Factory em seu projeto.Para obter mais informações, consulte Atualizando projetos do Excel e do Word migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
Os eventos de controles de conteúdo do Word são associados com os novos representantes. |
Você deve alterar qualquer código que manipular eventos de controles de conteúdo do Word para especificar novos representantes.Para obter mais informações, consulte Atualizando projetos do Excel e do Word migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
As classes de OLEObject e de OLEControl foram renomeados. |
Você deve alterar qualquer código que usar as instâncias dessas classes para usar Microsoft.Office.Tools.Excel.ControlSite ou Microsoft.Office.Tools.Word.ControlSite objetos em vez disso.Para obter mais informações, consulte Atualizando projetos do Excel e do Word migrados para o .NET Framework 4 ou o .NET Framework 4.5. |
Hospedar classes de item, como ThisWorkbook, Sheetem, ThisDocument, e ThisAddIn, não fornece um método de Dispose que você possa substituir. |
Você deve mover todo o código na substituição do método de Dispose ao manipulador de eventos Shutdown na classe de item host, por exemplo, ThisAddIn_Shutdown, e remove a substituição do método de Dispose de sua classe de item host. |
Consulte também
Conceitos
Migrando soluções do Office para o .NET Framework 4 ou o .NET Framework 4.5
Visual Studio Tools for Office visão geral sobre o tempo de execução