Partilhar via


Funções canônicas

Esta seção discute as funções canônicas que são suportadas por todos os provedores de dados e podem ser usadas por todas as tecnologias de consulta. As funções canônicas não podem ser estendidas por um provedor.

Essas funções canônicas serão traduzidas para a funcionalidade de fonte de dados correspondente para o provedor. Isso permite invocações de função expressas em um formulário comum entre fontes de dados.

Como essas funções canônicas são independentes das fontes de dados, os tipos de argumento e retorno de funções canônicas são definidos em termos de tipos no modelo conceitual. No entanto, algumas fontes de dados podem não oferecer suporte a todos os tipos no modelo conceitual.

Quando funções canônicas são usadas em uma consulta Entity SQL, a função apropriada será chamada na fonte de dados.

Todas as funções canônicas têm comportamento de entrada nula e condições de erro explicitamente especificadas. Os provedores de armazenamento devem estar em conformidade com esse comportamento, mas o Entity Framework não impõe esse comportamento.

Para cenários LINQ, as consultas no Entity Framework envolvem o mapeamento de métodos CLR para métodos na fonte de dados subjacente. Os métodos CLR são mapeados para funções canônicas, de modo que um conjunto específico de métodos será mapeado corretamente, independentemente da fonte de dados.

Namespace de funções canônicas

O namespace para a função canônica é System.Data.Metadata.Edm. O System.Data.Metadata.Edm namespace é incluído automaticamente em todas as consultas. No entanto, se outro namespace for importado que contenha uma função com o mesmo nome de uma função canônica (no System.Data.Metadata.Edm namespace), você deverá especificar o namespace.

Nesta Secção

Aggregate Canonical Functions Discute as funções canônicas agregadas do Entity SQL.

Math Canonical Functions Discute as funções canônicas math Entity SQL.

Funções canônicas de cadeia de caracteres Discute funções canônicas SQL de entidade de cadeia de caracteres.

Funções canônicas de data e hora Discute as funções canônicas de data e hora do SQL da entidade.

Bitwise Canonical Functions Discute as funções canônicas bitwise Entity SQL.

Funções espaciais Discute as funções canônicas SQL da entidade espacial.

Outras funções canônicas Discute funções não classificadas como bitwise, data/hora, string, matemática ou agregação.

Consulte também