Compartilhar via


Popular documentos usando dados de objetos

O acesso a dados em um objeto de dados funciona da mesma maneira em projetos de nível de documento para o Microsoft Office Word como em projetos do Windows Forms. Você usa as mesmas ferramentas e código para trazer os dados de um objeto para sua solução e você pode usar controles do Windows Forms para exibir os dados. Além disso, você pode exibir dados usando controles de host. Os controles de host são objetos nativos no Microsoft Office Word que foram aprimorados com eventos e recursos de vinculação de dados. Para obter mais informações, consulte Visão geral de controles de host e itens de host.

Aplica-se a: as informações neste tópico se aplicam a projetos em nível de documento e projetos de suplemento VSTO para Excel e Word. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Você deve concluir três etapas básicas para preencher o documento com dados de um objeto:

  • Adicione um controle ao documento que você pode vincular aos dados.

  • Adicione um objeto de dados ao documento.

  • Conecte o objeto de dados ao BindingSource.

Para adicionar um objeto de dados

Para adicionar um objeto de dados, abra a janela Fontes de Dados e crie uma fonte de dados a partir de um objeto. Para obter mais informações, consulte Adicionar novas fontes de dados.

Conectar o objeto de dados ao BindingSource

Em projetos de nível de documento, você adiciona controles ao documento e os vincula aos dados em tempo de design.

Em projetos de suplemento VSTO, você cria controles e os vincula em tempo de execução.

Projetos no nível de documento

Para conectar o objeto de dados ao BindingSource:

  1. Arraste o campo de dados desejado da janela Fontes de Dados para o documento. Isso cria automaticamente um controle.

  2. Em seu código, crie uma instância do tipo do objeto que você escolheu para a fonte de dados.

  3. Atribua a instância à propriedade DataSource do BindingSource.

Projetos no nível de aplicativo

Para conectar o objeto de dados ao BindingSource:

  1. Em seu código, crie uma instância do tipo do objeto associado à fonte de dados.

  2. Crie uma instância de uma BindingSource.

  3. Atribua a instância da fonte de dados à propriedade DataSource do BindingSource.

  4. Acrescente a fonte de dados como um databinding ao controle.