Demonstra Passo a passo: Criando e acessando um serviço de dados ADO.NET no Visual Studio

Esta explicação passo a passo demonstra como criar um simples ADO.NET Serviço de dados hospedado em um ASP.NET Aplicativo Web e, em seguida, acessá-lo a partir de um aplicativo Windows Forms.

Nesta explicação passo a passo você irá:

• Criar um aplicativo Web da Web para host um ADO.NET Serviço de dados.

• criar an Modelo de Dados de Entidade que representa a tabela Customers no banco de dados Northwind.

• criar an ADO.NET Serviço de dados.

• Criar um aplicativo cliente e adicione uma referência à ADO.NET Serviço de dados.

• Habilitar vinculação de dados para o serviço e gerar a interface do usuário.

• Opcionalmente, adicionar recursos de filtragem para o aplicativo.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

• O banco de dados de exemplo Northwind.

  Se você não tiver esse banco de dados no seu computador de desenvolvimento, você pode baixá-lo do centralizar de baixar da Microsoft.Para obter instruções, consulte Downloading Sample Databases (LINQ to SQL).

Criando o serviço

Para criar um ADO.NET Serviço de dados, você irá adicionar um projeto Web, crie um Modelo de Dados de Entidadee, em seguida, crie o serviço do modelo.

Na primeira etapa, você irá adicionar um projeto Web para hospedar o serviço.

Observação:
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Para criar o projeto Web

1. On the Visual Studio File menu, click New Project.

2. No Novo projeto diálogo caixa, expandir o Visual Basic or Translation from VPE for Csharp Visual nó e clicar Da Webe, em seguida, selecionar aplicativo Web de Web ASP .NET.

3. No Nome campo, digite NorthwindWeb e, em seguida, clicar OK para criar o projeto.

Nesta etapa, você criará um Modelo de Dados de Entidade que representa a tabela Customers no banco de dados Northwind.

Para criar o modelo de dados de entidade

1. No menu Project, clique em Add New Item.

2. No Adicionar novo item caixa de diálogo , selecionar Modelo de dados de entidade ADO.NET.

3. No Nome campo, tipo de NorthwindModele, em seguida, clicar Adicionar.

   O Assistente de modelo de dados de entidade será exibida.

4. No Assistente para modelo da dados de entidade, selecionar Gerar a partir de banco de dadose, em seguida, clicar Próximo.

5. Sobre o escolher sua conexão de dados página, execute uma das seguintes etapas:

   • Se uma conexão de dados para o banco de dados de exemplo Northwind estiver disponível na lista drop-down, selecione-o.

     - ou -

   • clicar Nova conexão para configurar uma nova conexão de dados.Para obter mais informações, consulte Como: Criar conexões para SQL Servidor bancos de dados.

6. Se o banco de dados exige uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

   Observação:
   Se uma caixa de diálogo for exibida, clicar Sim para salvar o arquivo para seu projeto.

7. Sobre o escolher seus objetos de banco de dados de página, expandir o Tabelas nó, selecionar a caixa de seleção ao lado para Clientese, em seguida, clicar Concluir.

   O diagrama de modelo de entidade será exibido e um arquivo NorthwindModel.edmx será adicionado ao seu projeto.

Nesta etapa, irá criar e testar o serviço de dados.

Criar o serviço de dados

1. No menu Project, clique em Add New Item.

2. No Adicionar novo item caixa de diálogo de de seleçãoServiço de dados ADO.NET.

3. No Nome campo, tipo de NorthwindCustomerse, em seguida, clicar Adicionar.

   O arquivo NorthwindCustomers.svc aparecerá no Editor de código.

4. No Editor de código, localizar o primeiro TODO: comentário e substituir código com o seguinte:

   Inherits DataService(Of NORTHWINDModel.NORTHWINDEntities)
   

   public class NorthwindCustomers : DataService<NORTHWINDModel.NORTHWINDEntities>
   

   Observação:
   Dependendo da versão do banco de dados Northwind que você está usando, você pode: necessário Altere "NORTHWIND" para "NORTHWND".Você também pode usar IntelliSense Para descobrir o nome correto.

5. Substitua os comentários no InitializeService manipulador de eventos com o código a seguir:

   config.SetEntitySetAccessRule("*", EntitySetRights.All)
   

   config.SetEntitySetAccessRule("*", EntitySetRights.All);
   

6. Pressione CTRL + F5 para executar o serviço.Uma janela do navegador será em aberto e o esquema XML para o serviço será exibido.

7. No Endereço bar, type Clientes no participante o URL para NorthwindCustomers.svc e pressione ENTER.

   Uma representação XML dos dados na tabela clientes será exibida.

   Observação:
   Em alguns casos , Internet Explorer irá misinterpret sistema autônomo dados sistema autônomo um RSS feed.Você deve Certifique-se de que a opção para exibir RSS auivo e DS desabilitado.Para obter mais informações, consulte Solucionando problemas de referências de serviço.

8. Feche a janela do navegador.

As próximas etapas, você irá criar um aplicativo cliente do Windows Forms para consumir o serviço.

Criando um aplicativo cliente

Para criar o aplicativo cliente, você irá adicionar um segundo projeto, adicione uma referência de serviço para o projeto, configurar uma fonte de dados e criar uma interface de usuário para exibir os dados do serviço.

Na primeira etapa, você irá adicionar à solução um projeto Windows Forms e defini-la sistema autônomo o projeto de inicialização.

Para criar o aplicativo cliente

1. On the Visual Studio File menu, click Add, and then click New Project.

2. No Novo projeto diálogo caixa, expandir o Visual Basic or Translation from VPE for Csharp Visual nó e clicar Windowse, em seguida, selecionar Aplicativo do Windows Forms.

3. No Nome campo, tipo de NorthwindCliente, em seguida, clicar OK para em em aberto o projeto.

4. In O gerenciador de soluções, selecionar o projeto NorthwindClient.

5. Sobre o Projeto menu, clicar conjunto sistema autônomo projeto de inicialização.

Nesta etapa, você irá adicionar uma referência de serviço para o ADO.NET Serviço de dados no projeto Web.

Para adicionar uma referência de serviço

1. Sobre o Projeto menu, clicar Adicionar referência de serviço.

2. Na caixa Adicionar serviço de referência caixa de diálogo, clique em Descubra .

   A URL do serviço NorthwindCustomers aparecerão no Endereço campo.

3. Clique em OK para adicionar a referência do serviço.

Nesta etapa, você irá configurar uma fonte de dados para habilitar vinculação de dados para o serviço.

Para habilitar vinculação de dados para o serviço

1. No menu Data, clique em Show Data Sources.

2. Na janela Data Sources, clique em Add New Data Source.

3. Sobre o escolher um tipo de fonte de dados página de do Assistente para configuração da fonte de dados, clicar Objetoe, em seguida, clicar Próximo.

4. Sobre o selecionar o objeto que você deseja BIND a de página, expandir o NorthwindClient nó e, em seguida, expandir o NorthwindClient.ServiceReference1 nó.

5. selecionar Clientese, em seguida, clicar Concluir.

Nesta etapa, você criará a interface do usuário que irá exibir os dados do serviço.

Para criar a interface do usuário

1. arrastar o Clientes nó from a Fontes de dados janela para o formulário.

   A DataGridView controle, uma BindingSource componente e um BindingNavigator componente são adicionados ao formulário.

2. clicar duas vezes no formulário para em aberto o Editor de código e adicione o seguinte código à Form1_Load manipulador de eventos:

   Dim proxy As New ServiceReference1.NORTHWINDEntities _
    (New Uri("https://localhost:14735/NorthwindCustomers.svc"))
   Me.CustomersBindingSource.DataSource = proxy.Customers
   

   ServiceReference1.NORTHIWNDEntities proxy = new
    ServiceReference1.NORTHIWNDEntities(new
    Uri("https://localhost:14735/NorthwindCustomers.svc"));
   this.customersBindingSource.DataSource = proxy.Customers;
   

   Observação:
   Dependendo da versão do banco de dados Northwind que você está usando, você pode: necessário Altere "NORTHWIND" para "NORTHWND".Você também pode usar IntelliSense Para descobrir o nome correto.

3. In O gerenciador de soluções, clicar com o botão direito do mouse no arquivo NorthwindCustomers.svc e clique em Exibir no navegador.Internet Explorer será em aberto e o esquema XML para o serviço será exibido.

4. Copie a URL de BAR de endereços do Internet Explorer.

5. No código que você adicionou na etapa 2, selecionar https://localhost:14735/NorthwindCustomers.svc e substituir-a com a URL que você acabou de copiar.

6. Pressione F5 para executar o aplicativo.As informações do cliente serão exibidas.

Agora você tem um aplicativo de trabalho que irá exibir uma lista de clientes do serviço NorthwindCustomers.Se você deseja expor dados adicionais por meio do serviço, você pode modificar o Modelo de Dados de Entidade para incluir tabelas adicionais do banco de dados Northwind.

A próxima etapa opcional, você aprenderá como filtrar dados que são retornados pelo serviço.

Adicionando recursos de filtragem

Nesta etapa, você personalizará o aplicativo para filtrar os dados por cidade do cliente.

Para adicionar a filtragem por cidade

1. In O gerenciador de soluções, clicar duas vezes em Form1.vb ou Form1.cs para exibir Designer de Formulários do Windows.

2. arrastar um TextBox controle e um Button controlar a partir do Caixa de ferramentas para o formulário.

3. clicar duas vezes o Button controlar e adicione o código a seguir no Button1_Click evento manipulador:

   Dim proxy As New ServiceReference1.NORTHWINDEntities _
    (New Uri("https://localhost:14735/NorthwindCustomers.svc"))
   Dim city As String = TextBox1.Text
   
   If city <> "" Then
       Me.CustomersBindingSource.DataSource = From c In _
    proxy.Customers Where c.City = city
   End If
   

   ServiceReference1.NORTHWINDEntities proxy = new
    ServiceReference1.NORTHWINDEntities(new
    Uri("https://localhost:14735/NorthwindCustomers.svc"));
   string city = textBox1.Text;
   
   if (city != "")
   {
       this.customersBindingSource.DataSource = from c in
    proxy.Customers where c.City == city select c;
   

4. No código anterior, substituir https://localhost:14735/NorthwindCustomers.svc com a URL das Form1_Load manipulador de eventos.

5. Pressione F5 para executar o aplicativo.

6. Na caixa de texto, digite London e, em seguida, clicar no botão.Somente os clientes de London serão exibidos.

Consulte também

Tarefas

Como: Adicionar, atualização, ou remover uma referência de serviço do ADO.NET

Outros recursos

ADO.NET Data Services Framework

Date	History	Motivo
Julho de 2008	Tópico adicional.	Alteração de recurso do SP1.