Funções canônicas

Essa seção discute as funções canônicas que têm suporte 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 convertidas à funcionalidade da fonte de dados correspondente para o provedor. Isso permite as invocações da função expressas em um formulário comum nas fontes de dados.

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

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

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

Para cenários do LINQ, as consultas ao Entity Framework envolvem mapeamento de métodos CLR para métodos na fonte de dados subjacente. Os métodos CLR mapeiam para funções canônicas, de modo que um conjunto específico de métodos mapeará 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 namespace System.Data.Metadata.Edm é incluído automaticamente em todas as consultas. No entanto, se outro namespace for importado e contiver uma função com o mesmo nome de uma função canônica (no namespace System.Data.Metadata.Edm), você deverá especificar o namespace.

Nesta seção

Funções Canônicas Agregadas Discute funções canônicas agregadas do Entity SQL.

Funções Canônicas Matemáticas Discute funções canônicas matemáticas do Entity SQL.

Funções Canônicas de Cadeias de Caracteres Discute Funções canônicas de cadeias de caracteres do Entity SQL.

Funções Canônicas de Data e Hora Discute funções canônicas de data e hora do Entity SQL.

Funções Canônicas Bit a Bit Discute Funções canônicas bit a bit do Entity SQL.

Funções Espaciais Discute funções canônicas espaciais do Entity SQL.

Outras Funções Canônicas Discute as funções não classificadas como bit a bit, data/hora, cadeia de caracteres, matemáticas ou agregadas.

Confira também