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

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Projetos de nível de documento O Excel 2003 O Excel 2007 Word 2003 Word 2007 Projetos de nível de aplicativo O Excel 2007 Word 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Projetos de nível de documento

O Excel 2003
O Excel 2007
Word 2003
Word 2007

Projetos de nível de aplicativo

O Excel 2007
Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

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:

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.
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

No Visual Studio, Abrir o documento do Word ou a pasta de trabalho do Excel no designer.
Clique no Controlarar que você deseja atualizar automaticamente a Origem de dados.
Na janela propriedades, Expandirir a propriedade de (DataBindings).
Avançar à propriedade (Avançado), clique no botão de reticências ().

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.

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

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();
```
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);
```