DataContext Methods (O/R Designer)
Publicado: abril de 2016
DataContext métodos (no contexto do LINQ to SQL Tools no Visual Studio) são métodos da DataContext classe que executam procedimentos armazenados e funções em um banco de dados.
O DataContext classe é um LINQ to SQL classe que atua como um canal entre um banco de dados do SQL Server e o LINQ to SQL classes de entidade mapeados para esse banco de dados. O DataContext classe contém as informações de cadeia de caracteres 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 envia dados atualizados de LINQ to SQL classes para o banco de dados. Você também pode criar adicionais DataContext métodos que mapeiam para procedimentos armazenados e funções. Em outras palavras, chamar esses métodos personalizados executará a função ou procedimento armazenado no banco de dados que o DataContext método é mapeado para. Você pode adicionar novos métodos para o DataContext classe exatamente como você adicionará métodos para estender qualquer classe. No entanto, em discussões sobre DataContext métodos no contexto do Designer Relacional de Objetos, é o DataContext métodos que mapeiam para procedimentos armazenados e funções que estão sendo discutidas.
Painel de métodos
DataContext métodos que mapeiam para procedimentos armazenados e funções são exibidos no painel dos métodos de Designer Relacional de Objetos. O painel de métodos é o lado do entidades painel (a superfície de design principal). O painel de métodos lista todos os DataContext métodos que você criou usando o Designer Relacional de Objetos. Por padrão, o painel de métodos está vazio. Arraste procedimentos armazenados ou funções de Server Explorer/Database Explorer até o Designer Relacional de Objetos criar DataContext métodos e preencher o painel de métodos. Para obter mais informações, consulte Como: criar métodos DataContext mapeados para procedimentos armazenados e funções (Object Relational Designer).
Dica
Abrir e fechar o painel de métodos clicando com o Designer Relacional de Objetos 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 de DataContext
Métodos de DataContext são os métodos que mapeiam para procedimentos armazenados e funções no banco de dados. Você pode criar e adicionar métodos de DataContext no painel dos métodos de Designer Relacional de Objetos. Há dois tipos distintos de DataContext métodos; aqueles que retornam um ou mais conjuntos de resultados e os que não:
DataContext métodos que retornam um ou mais conjuntos de resultados:
Crie esse tipo de DataContext método quando seu aplicativo precisa apenas para executar procedimentos armazenados e funções no banco de dados e retornar os resultados. Para obter mais informações, consulte Como: criar métodos DataContext mapeados para procedimentos armazenados e funções (Object Relational 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 DataContext método quando seu aplicativo precisa executar procedimentos armazenados em vez de usar o padrão LINQ to SQL comportamento para salvar dados modificados entre uma classe de 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 (Object Relational Designer).
Tipos de retorno dos métodos DataContext
Quando você arrasta procedimentos armazenados e funções de Server Explorer/Database Explorer até o Designer Relacional de Objetos, o tipo de retorno de gerado DataContext método difere dependendo de onde você solta o item. Soltar itens diretamente em uma classe de entidade existente cria um DataContext método com o tipo de retorno da classe de entidade; soltar item em uma área vazia do Designer Relacional de Objetos (em qualquer painel) cria um DataContext método que retorna um tipo gerado automaticamente. O tipo gerado automaticamente criado tem um nome que corresponda ao procedimento armazenado ou nome da função e propriedades que mapeiam para os campos retornados pelo procedimento armazenado ou função.
Dica
Você pode alterar o tipo de retorno de um DataContext método depois de adicioná-lo ao painel de métodos. Para verificar ou alterar o tipo de retorno de um DataContext método, selecione-o e inspecione o tipo de retorno propriedade no propriedades janela. Para obter mais informações, consulte Como: alterar o tipo de retorno de um método DataContext (Object Relational Designer).
Arraste do banco de dados para a superfície de Object Relational Designer de objetos serã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á acrescentado ao final do nome do novo que diferencia os nomes. Quando os nomes de objeto de banco de dados contêm espaços ou caracteres que não são suportados no Visual Basic ou c#, o espaço ou caractere inválido é substituído por um sublinhado.
Consulte também
LINQ to SQL Tools no Visual Studio
LINQ to SQL
Stored Procedures
Como: criar métodos DataContext mapeados para procedimentos armazenados e funções (Object Relational Designer)
Como: atribuir procedimentos armazenados para executar atualizações, inserções e exclusões (Object Relational Designer)
Passo a passo: Personalizando a inserção, atualização e exclusão de comportamento de classes de entidade
Walkthrough: Creating LINQ to SQL Classes (O/R Designer)