Funciones canónicasCanonical Functions

Esta sección describe las funciones canónicas que son admitidas por todos los proveedores de datos y pueden ser utilizadas por todas las tecnologías de creación de consultas.This section discusses canonical functions that are supported by all data providers, and can be used by all querying technologies. Las funciones canónicas no pueden ser ampliadas por un proveedor.Canonical functions cannot be extended by a provider.

Estas funciones canónicas se convertirán en la funcionalidad de origen de datos correspondiente para el proveedor.These canonical functions will be translated to the corresponding data source functionality for the provider. Esto permite que las llamadas a funciones se expresen de forma común en los orígenes de datos.This allows for function invocations expressed in a common form across data sources.

Dado que estas funciones canónicas son independientes de los orígenes de datos, los tipos de argumentos y valores devueltos de las funciones canónicas se definen en función de los tipos en el modelo conceptual.Because these canonical functions are independent of data sources, argument and return types of canonical functions are defined in terms of types in the conceptual model. Sin embargo, puede que algunos orígenes de datos no admitan todos los tipos en el modelo conceptual.However, some data sources might not support all types in the conceptual model.

Cuando las funciones canónicas se usan en una consulta de Entity SQLEntity SQL, se llamará a la función apropiada en el origen de datos.When canonical functions are used in an Entity SQLEntity SQL query, the appropriate function will be called at the data source.

Todas las funciones canónicas tienen comportamiento de entrada NULL y condiciones de error especificadas explícitamente.All canonical functions have both null-input behavior and error conditions explicitly specified. Los proveedores de almacenes deben cumplir ese comportamiento, pero Entity Framework no aplica este comportamiento.Store providers should comply with that behavior, but Entity Framework does not enforce this behavior.

En el caso de los escenarios de LINQ, las consultas en el Entity Framework implican la asignación de métodos CLR a métodos en el origen de datos subyacente.For LINQ scenarios, queries against the Entity Framework involve mapping CLR methods to methods in the underlying data source. Los métodos de CLR se asignan a funciones canónicas de modo que un conjunto específico de métodos se asignará correctamente, con independencia del origen de datos.The CLR methods map to canonical functions, so that a specific set of methods will correctly map, regardless of the data source.

Espacio de nombres de funciones canónicasCanonical Functions Namespace

El espacio de nombres para una función canónica es System.Data.Metadata.Edm.The namespace for canonical function is System.Data.Metadata.Edm. El espacio de nombres System.Data.Metadata.Edm se incluye automáticamente en todas las consultas.The System.Data.Metadata.Edm namespace is automatically included in all queries. Sin embargo, si se importa otro espacio de nombres que contiene una función con el mismo nombre que una función canónica (en el espacio de nombres System.Data.Metadata.Edm), se debe especificar el espacio de nombres.However, if another namespace is imported that contains a function with the same name as a canonical function (in the System.Data.Metadata.Edm namespace), you must specify the namespace.

En esta secciónIn This Section

Funciones canónicas de agregadoAggregate Canonical Functions
Describe las funciones canónicas de agregado de Entity SQLEntity SQL.Discusses aggregate Entity SQLEntity SQL canonical functions.

Funciones canónicas matemáticasMath Canonical Functions
Describe las funciones canónicas matemáticas de Entity SQLEntity SQL.Discusses math Entity SQLEntity SQL canonical functions.

Funciones canónicas de cadenaString Canonical Functions
Describe las funciones canónicas de cadena de Entity SQLEntity SQL.Discusses string Entity SQLEntity SQL canonical functions.

Funciones canónicas de fecha y horaDate and Time Canonical Functions
Describe las funciones canónicas de fecha y hora de Entity SQLEntity SQL.Discusses date and time Entity SQLEntity SQL canonical functions.

Funciones canónicas bit a bitBitwise Canonical Functions
Describe las funciones canónicas bit a bit de Entity SQLEntity SQL.Discusses bitwise Entity SQLEntity SQL canonical functions.

Funciones espacialesSpatial Functions
Describe las funciones canónicas y espaciales de Entity SQLEntity SQL.Discusses Spatial Entity SQLEntity SQL canonical functions.

Otras funciones canónicasOther Canonical Functions
Describe las funciones no clasificadas como funciones bit a bit, de fecha y hora, de cadena, matemáticas o de agregado.Discusses functions not classified as bitwise, date/time, string, math, or aggregate.

Vea tambiénSee also