Altera para o Design de projetos do Office que visam o.NET Framework 4

  • Artigo

Visual Studio 2010apresenta algumas alterações na estrutura de projetos do Office destinados a .NET Framework 4. Se você estiver familiarizado com os projetos do Office em versões anteriores do Visual Studio, você deve estar ciente dessas alterações antes de desenvolver projetos do Office destinados a .NET Framework 4. Se você tiver um projeto existente que você deseja atualizar para o destino do .NET Framework 4, há várias alterações mais recentes que você deve conhecer.

Noções básicas sobre o Design baseado em Interface das ferramentas de 2010 Visual Studio para Office Runtime

Ao desenvolver um projeto do Office que se destina a .NET Framework 4, a maioria dos tipos que você usar o Visual Studio 2010 Tools for Office Runtime são interfaces. Esta é uma grande mudança de versões anteriores do Visual Studio Tools for Office runtime, onde esses tipos são classes. Por exemplo, quando você direcionar o .NET Framework 4, o Worksheet e Document são de tipos de interfaces em vez de classes. For more information, see Visual Studio Tools for Office visão geral sobre o tempo de execução.

Para todos os tipos que você pode instanciar diretamente nas versões anteriores da Visual Studio Tools for Office runtime, agora que você usar métodos da Globals.Factory objeto de instâncias desses tipos. Por exemplo, para obter um objeto que implementa o SmartTag interface, use o Globals.Factory.CreateSmartTag método. For more information, see the following topics:

Novas Classes Base em projetos do Office

O novo design baseado em interface da Visual Studio 2010 Tools for Office Runtime afeta as classes geradas em projetos do Office, como ThisDocument, ThisWorkbook, e ThisAddIn. No escritório de projetos destinados a.NET Framework 3.5 e versões anteriores do framework, essas classes geradas derivar de classes de Visual Studio Tools for Office runtime como Microsoft.Office.Tools.Word.Document, Microsoft.Office.Tools.Excel.Worksheet, e Microsoft.Office.Tools.AddIn. Em projetos destinados a .NET Framework 4, eles Visual Studio Tools for Office runtime classes são interfaces agora. Portanto, classes geradas em projetos do Office não podem derivar sua implementação delas. Em vez disso, as classes geradas derivam novas classes base, como DocumentBase, WorksheetBase, e AddInBase. For more information, see Os suplementos de nível de aplicativo de programação. and Programação personalizações em nível de documento.

As classes base não são parte do Visual Studio Tools for Office runtime redistribuível. Em vez disso, eles são definidos em assemblies de utilitários incluídos no Visual Studio 2010. Esses assemblies são copiados para a pasta de saída quando você construir projetos do Office e deve ser implantados com sua solução. Para obter mais informações sobre os assemblies de utilitários, consulte Assemblies no Visual Studio Tools para Office Runtime.

Alterações significativas em projetos do Office são redirecionados para o.NET Framework 4

A tabela a seguir lista as alterações mais recentes principal podem ser encontrados em projetos do Office são redirecionados para o .NET Framework 4. Para obter mais detalhes, consulte Migrando soluções do Office para o.NET Framework 4.

Alteração significativa

Conseqüência

O SecurityTransparentAttribute não são mais usados ou suporte para projetos do Office.

Você deve remover esse atributo do arquivo AssemblyInfo código em projetos do Office que você atualizar a partir de Visual Studio de 2008. For more information, see Necessárias alterações executar projetos do Office que você migrar para o.NET Framework 4.

O ExcelLocale1033Attribute não são mais usados ou suportado em projetos do Excel.

Você deve remover esse atributo do arquivo AssemblyInfo código em projetos do Excel. For more information, see Atualização do Excel e projetos do Word que você migrar para o.NET Framework 4.

O modelo de programação de a faixa de opções (Visual Designer) itens de projeto foi alterado.

Você deve modificar o arquivo code-behind para todos os itens da faixa de opções em seu projeto. Você também deve modificar qualquer código que instancia controles da faixa de opções em tempo de execução, trata os eventos da faixa de opções ou define a posição de um componente de faixa de opções programaticamente. For more information, see Atualizando as personalizações da faixa de opções em projetos do Office que você migrar para o.NET Framework 4.

O modelo de programação de regiões de formulário do Outlook foi alterado.

Você deve modificar o arquivo code-behind para quaisquer regiões de formulário em seu projeto e qualquer código que instancia determinadas classes de região de formulário em tempo de execução. For more information, see Atualização de regiões de formulário em projetos do Outlook que você migrar para o.NET Framework 4.

O modelo de programação de marcas inteligentes em projetos do Excel e Word foi alterado. As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

Você deve modificar qualquer código que cria objetos de ação e de marca inteligente e o código que define um reconhecedor de marca inteligente personalizada. For more information, see Atualização do Excel e projetos do Word que você migrar para o.NET Framework 4.

A sintaxe a GetVstoObject e HasVstoObject métodos foi alterado.

Você deve passar a Globals.Factory esses métodos quando você acessá-los em objetos nativos de assemblies de interoperabilidade primários (PIAs) ou você pode acessar esses métodos no objeto retornado pelo objeto de Globals.Factory propriedade no seu projeto. For more information, see Atualização do Excel e projetos do Word que você migrar para o.NET Framework 4.

Os eventos de controles de conteúdo do Word estão associados a novos representantes.

Você deve modificar qualquer código que manipula eventos de controles de conteúdo do Word para especificar os novos representantes. For more information, see Atualização do Excel e projetos do Word que você migrar para o.NET Framework 4.

O OLEObject e OLEControl classes foram renomeados.

Você deve modificar qualquer código que usa instâncias dessas classes para usar Microsoft.Office.Tools.Excel.ControlSite ou Microsoft.Office.Tools.Word.ControlSite objetos em vez disso. For more information, see Atualização do Excel e projetos do Word que você migrar para o.NET Framework 4.

Classes de item de host (como ThisWorkbook, Sheetn, ThisDocument, e ThisAddIn) não mais fornecerá uma Dispose método que você pode substituir.

Você deve mover qualquer código na Dispose método de substituição para o Shutdown manipulador de eventos na classe de item de host (por exemplo, ThisAddIn_Shutdown) e remover o Dispose método substituir da sua turma. item de host

Consulte também

Conceitos

Migrando soluções do Office para o.NET Framework 4

O que há de novo no desenvolvimento do Office

Visual Studio Tools for Office visão geral sobre o tempo de execução

Histórico de alterações

Date

History

Motivo

Maio de 2010

Adicionadas informações sobre a remoção de Dispose método em projetos destinados a .NET Framework 4.

Aprimoramento de informações.