Como: preencher documentos com dados de serviçosHow to: Populate documents with data from services

Acesso a dados funciona da mesma maneira no nível de documento para o Microsoft Office, como faz em projetos do Windows Forms.Data access works the same way in document-level projects for Microsoft Office as it does in Windows Forms projects. Usar as mesmas ferramentas e código para trazer os dados para sua solução, e você pode até mesmo usar controles dos Windows Forms para exibir os dados.You use the same tools and code to bring the data into your solution, and you can even use Windows Forms controls to display the data. Além disso, você pode tirar proveito dos controles, chamados de controles de host, que são objetos nativos no Microsoft Office Excel e Microsoft Office Word que foram aprimorados com eventos e a funcionalidade de associação de dados.In addition, you can take advantage of controls called host controls, which are native objects in Microsoft Office Excel and Microsoft Office Word that have been enhanced with events and data binding capability. Para obter mais informações, consulte hospedam itens e visão geral dos controles.For more information, see Host items and host controls overview.

Aplicável a: as informações neste tópico são aplicáveis aos projetos no nível de documento para Excel e Word.Applies to: The information in this topic applies to document-level projects for Excel and Word. Para obter mais informações, consulte recursos disponíveis por tipo de projeto e aplicativo do Office.For more information, see Features available by Office application and project type.

O exemplo a seguir mostra como adicionar controles ligados a dados a documentos em tempo de design.The following example shows how to add data-bound controls to documents at design time. Para obter um exemplo de como adicionar controles ligados a dados nos suplementos do VSTO em tempo de execução, consulte instruções passo a passo: associar a dados de um serviço em um projeto de suplemento do VSTO.For an example of how to add data-bound controls in VSTO Add-ins at run time, see Walkthrough: Bind to data from a service in a VSTO Add-in project.

link para vídeo para uma demonstração em vídeo relacionada, consulte como fazer i: interagir com os serviços web do Microsoft Excel?.link to video For a related video demonstration, see How do I: Interact with web services from Microsoft Excel?.

Para popular um projeto de nível de documento com os dados de um serviço webTo populate a document-level project with data from a web service

  1. Abra o fontes de dados janela e criar uma fonte de dados de serviço para seu projeto.Open the Data Sources window and create a service data source for your project. Para obter mais informações, consulte Adicionar novas fontes de dados.For more information, see Add new data sources.

  2. Arraste a tabela ou o campo desejado a fontes de dados janela ao documento.Drag the table or field you want from the Data Sources window to your document.

    Um controle é criado no documento, um BindingSource é criado que está associado à classe de objeto em seu projeto e classes são geradas para o serviço.A control is created on the document, a BindingSource is created that is bound to the object class in your project, and classes are generated for the service.

  3. Em seu código, crie uma instância da classe de serviço da web conectado na etapa 1.In your code, create an instance of the web service class that you connected to in step 1.

  4. Se houver propriedades que são necessárias para a comunicação com o serviço web, crie instâncias dessas propriedades.If there are properties that are required for communication with the web service, create instances of those properties.

  5. Criar e enviar uma solicitação de dados usando os métodos expostos pelo serviço da Web e quaisquer instâncias de propriedade criado na etapa 4.Create and send a data request using methods exposed by the Web service and any property instances you created in step 4.

    Os métodos que você usa dependem do serviço web oferece.The methods that you use depend on what the web service offers.

  6. Atribuir a resposta de dados do serviço da web para o DataSource propriedade do BindingSource.Assign the data response from the web service to the DataSource property of the BindingSource.

Quando você executa o projeto, os controles exibem o primeiro registro na fonte de dados.When you run the project, the controls display the first record in the data source. Você pode habilitar a rolagem pelos registros manipulando os eventos de moeda usando os objetos no BindingSource.You can enable scrolling through the records by handling the currency events using the objects in the BindingSource.

Consulte tambémSee also