Métodos de DataContext (Designer O/R)

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.

A DataContext classe é uma classe LINQ to SQL que atua como um canal entre um banco de dados do 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 do LINQ para classes SQL para o banco de dados. Você também pode criar métodos adicionais DataContext que mapeiam para procedimentos e funções armazenados. 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 Designer O/R, são os DataContext métodos que se mapeiam para procedimentos armazenados e funções que estão sendo discutidos.

Painel dos métodos

DataContext os métodos mapeados para procedimentos e funções armazenados são exibidos no painel Métodos do Designer O/R. 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 Designer O/R. 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 Designer de O/R 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 e funções armazenados (Designer O/R).

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 Designer O/R. Há dois tipos distintos de DataContext métodos; aqueles que retornam um ou mais conjuntos de resultados e aqueles que não retornam:

• DataContext métodos que retornam um ou mais conjuntos de resultados:

  Crie esse tipo de DataContext método quando seu aplicativo só precisa 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 e funções armazenados (Designer O/R), 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 tiver que executar procedimentos armazenados em vez de usar o comportamento linq to SQL padrão 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 (Designer O/R).

Retornar tipos 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 Designer de O/R, o tipo de retorno do método gerado DataContext difere dependendo de onde você descarta 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 Designer O/R (em ambos os painéis) cria um DataContext método que retorna um tipo gerado automaticamente. O tipo gerado automaticamente tem um nome que corresponde ao procedimento armazenado ou à função, e possui propriedades que são mapeadas para os campos retornados pelo procedimento ou pela função armazenados.

Os objetos que você arrasta do banco de dados para a superfície do Designer O/R 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 objetos 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 do LINQ to SQL no Visual Studio
• LINQ para SQL
• Procedimentos armazenados
• Como criar métodos DataContext mapeados para procedimentos e funções armazenados (Designer O/R)
• Como atribuir procedimentos armazenados para executar atualizações, inserções e exclusões (Designer O/R)
• Passo a passo: personalizando o comportamento de inserção, atualização e exclusão de classes de entidade
• Passo a passo: Criando classes de LINQ to SQL (O-R Designer)