Como: Atualizar uma Origem de dados com dados de um Controlarar de host

Você pode Ligar um host de Controlarar para uma Origem de dados e atualizar a Origem de dados com as alterações que são feitas aos dados no Controlarar.

Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), você pode Ligar controles de host a dados em projetos de nível de aplicativo.Se você não tiver SP1 instalado, você pode usar controles de host apenas em projetos de nível de documento.

Há duas etapas principais nesse processo:

1. Atualizar a Origem de dados na memória com os dados modificados no Controlarar.Normalmente, a Origem de dados na memória é um DataSet, um DataTable ou algum outro objeto de dados.

2. Atualizar banco de dados com os dados alterados na Origem de dados na memória.Isso é aplicável somente se a Origem de dados estiver conectada a um banco de dados de Voltar-end, como um SQL Servidor ou banco de dados do Microsoft Office Acessar.

Para obter mais informações sobre controles de host e vinculação de dados, consulte Itens de host e Visão geral sobre controles de host e Vinculando dados a controles.

Atualizar a Origem de dados na memória

Por padrão, controles de host que permitem a ligação de dados simples como (controles de conteúdo em um documento do Word) ou um controle de intervalo nomeado em uma planilha do Excel não Salvar Dados muda para a Origem de dados na memória.Isto é, quando um usuário final altera um valor em um Controlarar de host e, em seguida, navega fora do Controlarar, o novo valor no Controlarar não é salvo automaticamente para a Origem de dados.

Para salvar os dados para a Origem de dados, você pode Gravar código que atualiza a Origem de dados em resposta a um evento específico no tempo de execução ou você pode configurar o Controlarar para atualizar automaticamente a Origem de dados quando o valor no Controlarar é alterado.

Você não precisará salvar ListObject alterações na Origem de dados na memória.Quando você Ligar um Controlarar de ListObject a dados, o Controlarar de ListObject automaticamente salva as alterações para a Origem de dados na memória sem exigir códigos adicionais.

Para atualizar a Origem de dados na memória em tempo de execução

• Chame o método WriteValue do objeto Binding que vincula o Controlarar para a Origem de dados.

  O exemplo a seguir salva as alterações feitas em um Controlarar de NamedRange em uma planilha do Excel para a Origem de dados.Este exemplo assume que você tenha um Controlarar de NamedRange chamado namedRange1 com sua propriedade Value2 Ligado a um campo em uma Origem de dados.

  Me.NamedRange1.DataBindings("Value2").WriteValue()
  

  this.namedRange1.DataBindings["Value2"].WriteValue();
  

Atualizar automaticamente a Origem de dados na memória

Você também pode configurar um Controlarar para que ela atualiza automaticamente a Origem de dados na memória.Em um projeto de nível de documento, você pode fazer isso usando código ou o designer.Em um projeto de nível de aplicativo, você deve usar código.

Para definir um Controlarar para atualizar automaticamente a Origem de dados na memória por meio de código

• Use a propriedade DataSourceUpdateMode do objeto Binding que vincula o Controlarar para a Origem de dados.Há duas opções para atualizar a Origem de dados:

  • Para atualizar a Origem de dados quando o Controlarar é validado, defina esta propriedade como OnValidation.

  • Para atualizar a Origem de dados quando o valor da propriedade ligados a dados do Controlarar é alterado, defina esta propriedade como OnPropertyChanged.

    Observação:
    O Opção de OnPropertyChanged não Aplicar para o Word hospedar controles, porque o Word faz notificações não, oferta documento-Alterar ou Alterar de controle.No entanto, essa opção pode ser usada para controles de Windows Forms em documentos do Word.

  O exemplo a seguir configura um Controlarar de NamedRange para atualizar automaticamente a Origem de dados quando o valor no Controlarar é alterado.Este exemplo assume que você tenha um Controlarar de NamedRange chamado namedRange1 com sua propriedade Value2 Ligado a um campo em uma Origem de dados.

  Me.NamedRange1.DataBindings("Value2").DataSourceUpdateMode = _
      DataSourceUpdateMode.OnPropertyChanged
  

  this.namedRange1.DataBindings["Value2"].DataSourceUpdateMode = 
      DataSourceUpdateMode.OnPropertyChanged;
  

Para definir um Controlarar para atualizar automaticamente a Origem de dados na memória usando o designer

1. No Visual Studio, Abrir o documento do Word ou a pasta de trabalho do Excel no designer.

2. Clique no Controlarar que você deseja atualizar automaticamente a Origem de dados.

3. Na janela propriedades, Expandirir a propriedade de (DataBindings).

4. Avançar à propriedade (Avançado), clique no botão de reticências ().

5. Na Formatação e ligação Avançado caixa de diálogo, clique Soltar Modo de Atualizar de Origem de dados Soltar-Para Baixo e Selecionar um dos seguintes valores:

   • Para atualizar a Origem de dados quando o Controlarar é validado, Selecionar OnValidation.

   • Para atualizar a Origem de dados quando o valor da propriedade ligados a dados do Controlarar é alterado, Selecionar OnPropertyChanged.

     Observação:
     O Opção de OnPropertyChanged não Aplicar para o Word hospedar controles, porque o Word faz notificações não, oferta documento-alteração ou alteração de controle.No entanto, essa opção pode ser usada para controles de Windows Forms em documentos do Word.

6. Fechar Formatação e ligação Avançado caixa de diálogo.

Atualizar o banco de dados

Se a Origem de dados na memória estiver associada um banco de dados, você deve atualizar o banco de dados com as alterações para a Origem de dados.Para obter mais informações sobre como atualizar um banco de dados, consulte Visão Geral Sobre Salvamento de Dados e Como: Atualizar dados usando um TableAdapter.

Para atualizar o banco de dados

1. Chame o método EndEdit do BindingSource para o Controlarar.

   O BindingSource é automaticamente gerado quando você Adicionar um Controlarar Ligado a dados a um documento ou pasta de trabalho em tempo de design.O BindingSource conecta o Controlarar ao dataset tipado em seu projeto.For more information, see Visão geral sobre o componente BindingSource.

   O exemplo de código a seguir assume que seu projeto contém um BindingSource chamado customersBindingSource.

   Me.CustomersBindingSource.EndEdit()
   

   this.customersBindingSource.EndEdit();
   

2. Chame o método Update do gerado TableAdapter no projeto.

   O TableAdapter é automaticamente gerado quando você Adicionar um Controlarar Ligado a dados a um documento ou pasta de trabalho em tempo de design.O TableAdapter conecta-se o dataset tipado em seu projeto ao banco de dados.For more information, see Visão geral do TableAdapter.

   O exemplo de código a seguir pressupõe que você tiver uma conexão à tabela Customers no banco de dados Northwind, e que seu projeto contém um TableAdaptercustomersTableAdapter e um dataset tipado chamado northwindDataSet.

   Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
   

   this.customersTableAdapter.Update(this.northwindDataSet.Customers);
   

Consulte também

Tarefas

Como: Atualizar dados usando um TableAdapter

Como: Rolagem através de registros de banco de dados em uma planilha

Como: Preencher planilhas com dados de um banco de dados

Como: Preencher documentos com dados de objetos

Como: Preencher documentos com dados de um banco de dados

Como: Preencher documentos com Dadosta de Services

Conceitos

Vinculando dados a controles

Visão Geral Sobre Salvamento de Dados