Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
DataContext métodos (no contexto do LINQ to SQL Tools no Visual Studio) são métodos da classe que executam procedimentos armazenados e funções numa base de DataContext dados.
A DataContext classe é uma classe LINQ to SQL que atua como um canal entre um banco de dados SQL Server e as classes de entidade LINQ to SQL mapeadas para esse banco de dados. A DataContext classe contém as informações da cadeia de conexão e os métodos para se conectar a um banco de dados e manipular os dados no banco de dados. Por padrão, a DataContext classe contém vários métodos que você pode chamar, como o SubmitChanges método que envia dados atualizados de classes LINQ to SQL para o banco de dados. Você também pode criar métodos adicionais DataContext que mapeiam para procedimentos armazenados e funções. Em outras palavras, chamar esses métodos personalizados executa o procedimento armazenado ou a função no banco de dados para o qual o DataContext método é mapeado. Você pode adicionar novos métodos à DataContext classe da mesma forma que adicionaria métodos para estender qualquer classe. No entanto, em discussões sobre DataContext métodos no contexto do O/R Designer, são os DataContext métodos que são mapeados para procedimentos armazenados e funções que estão a ser discutidos.
Painel de Métodos
DataContext os métodos que mapeiam para procedimentos armazenados e funções são exibidos no painel Métodos do O/R Designer. O painel Métodos é o painel ao longo do lado do painel Entidades (a superfície de design principal). O painel Métodos lista todos os DataContext métodos que você criou usando o O/R Designer. Por padrão, o painel Métodos está vazio; arraste procedimentos armazenados ou funções do Gerenciador de Servidores ou do Gerenciador de Banco de Dados para o O/R Designer para criar DataContext métodos e preencher o painel Métodos . Para obter mais informações, consulte Como criar métodos DataContext mapeados para procedimentos armazenados e funções (O/R Designer).
Observação
Abra e feche o painel de métodos clicando com o botão direito do mouse no O/R Designer e, em seguida, clicando em Ocultar Painel de Métodos ou Mostrar Painel de Métodos, ou use o atalho de teclado CTRL+1.
Dois tipos de métodos DataContext
Os métodos do DataContext são aqueles que mapeiam para procedimentos armazenados e funções no banco de dados. Você pode criar e adicionar métodos DataContext no painel Métodos do O/R Designer. Existem dois tipos distintos de métodos: aqueles que retornam um ou mais conjuntos de DataContext resultados e aqueles que não retornam:
DataContext Métodos que retornam um ou mais conjuntos de resultados:
Crie esse tipo de método quando seu aplicativo só precisa executar procedimentos armazenados e funções no banco de DataContext dados e retornar os resultados. Para obter mais informações, consulte Como criar métodos DataContext mapeados para procedimentos armazenados e funções (O/R Designer), System.Data.Linq.ISingleResult<T> e IMultipleResults.
DataContext métodos que não retornam conjuntos de resultados: como Inserções, Atualizações e Exclusões para uma classe de entidade específica.
Crie esse tipo de método quando seu aplicativo tiver que executar procedimentos armazenados em vez de usar o comportamento padrão LINQ to SQL para salvar dados modificados entre uma classe de DataContext entidade e o banco de dados. Para obter mais informações, consulte Como atribuir procedimentos armazenados para executar atualizações, inserções e exclusões (O/R Designer).
Tipos de retorno de métodos DataContext
Quando você arrasta procedimentos armazenados e funções do Gerenciador de Servidores ou do Gerenciador de Banco de Dados para o O/R Designer, o tipo de retorno do método gerado DataContext difere dependendo de onde você solta o item. Soltar os itens diretamente em uma classe de entidade existente cria um DataContext método com o tipo de retorno da classe de entidade; soltar itens em uma área vazia do O/R Designer (em qualquer painel) cria um DataContext método que retorna um tipo gerado automaticamente. O tipo gerado automaticamente tem um nome que corresponde ao nome do procedimento armazenado ou da função e possui propriedades que são mapeadas para os campos retornados pelo procedimento armazenado ou função.
Observação
Você pode alterar o tipo de retorno de um DataContext método depois de adicioná-lo ao painel de métodos. Para inspecionar ou alterar o tipo de retorno de um DataContext método, selecione-o e inspecione a propriedade Tipo de retorno na janela Propriedades . Para obter mais informações, consulte Como alterar o tipo de retorno de um método DataContext (O/R Designer).
Os objetos arrastados do banco de dados para a superfície do O/R Designer são nomeados automaticamente, com base no nome dos objetos no banco de dados. Se você arrastar o mesmo objeto mais de uma vez, um número será adicionado ao final do novo nome que diferencia os nomes. Quando os nomes de objeto de banco de dados contêm espaços ou caracteres sem suporte no Visual Basic ou C#, o espaço ou caractere inválido é substituído por um sublinhado.
Conteúdo relacionado
- Ferramentas LINQ to SQL no Visual Studio
- LINQ para SQL
- Procedimentos armazenados
- Como criar métodos DataContext mapeados para procedimentos armazenados e funções (O/R Designer)
- Como atribuir procedimentos armazenados para executar atualizações, inserções e exclusões (O/R Designer)
- Passo a passo: Personalizando o comportamento de inserção, atualização e exclusão de classes de entidade
- Passo a passo: Criando classes LINQ to SQL (O-R Designer)