Kanonische Funktionen (Entity SQL)

In diesem Abschnitt werden die von allen Datenanbietern unterstützten und in allen Abfragetechnologien verwendbaren kanonischen Funktionen erläutert. Kanonische Funktionen können von Anbietern nicht erweitert werden.

Diese kanonischen Funktionen werden für den Anbieter in die entsprechenden Funktionen der Datenquelle übersetzt. Dadurch können Funktionsaufrufe für verschiedene Datenquellen in einer allgemeinen Form ausgedrückt werden.

Da diese kanonischen Funktionen unabhängig von der Datenquelle sind, werden die Argument- und Rückgabetypen kanonischer Funktionen in Form von Typen im Entitätsdatenmodell (EDM) definiert. Jedoch werden von einigen Datenquellen möglicherweise nicht alle Typen im EDM unterstützt.

Wenn in einer Entity SQL-Abfrage kanonische Funktionen verwendet werden, werden in der Datenquelle die entsprechenden Funktionen aufgerufen.

Für alle kanonischen Funktionen sind das Verhalten bei NULL-Eingaben sowie die Fehlerbedingungen explizit angegeben. Speicheranbieter sollten diesen Vorgaben entsprechend vorgehen. Dieses Verhalten wird vom Entity Framework jedoch nicht erzwungen.

In LINQ-Szenarien müssen bei Abfragen des Entity Framework CLR-Methoden den Methoden in der zugrunde liegenden Datenquelle zugeordnet werden. Die CLR-Methoden werden kanonischen Funktionen zugeordnet, sodass bestimmte Methoden unabhängig von der Datenquelle korrekt zugeordnet werden.

Namespace kanonischer Funktionen

Der Namespace für kanonische Funktionen ist Edm. Der Edm-Namespace wird in allen Abfragen automatisch eingebunden. Wenn jedoch ein anderer Namespace importiert wird, der eine Funktion mit dem gleichen Namen wie eine kanonische Funktion (im Edm-Namespace) enthält, muss der Namespace angegeben werden.

Themen dieses Abschnitts

• Aggregieren von kanonischen Funktionen (Entity SQL)
  Erläutert die kanonischen Aggregatfunktionen von Entity SQL.

• Kanonische mathematische Funktionen (Entity SQL)
  Erläutert die kanonischen mathematischen Funktionen von Entity SQL.

• Kanonische Zeichenfolgenfunktionen (Entity SQL)
  Erläutert die kanonischen Zeichenfolgenfunktionen von Entity SQL.

• Kanonische Datums- und Uhrzeitfunktionen (Entity SQL)
  Erläutert die kanonischen Datums- und Uhrzeitfunktionen von Entity SQL.

• Bitweise kanonische Funktionen (Entity SQL)
  Erläutert die kanonischen bitweisen Funktionen von Entity SQL.

• Weitere kanonische Funktionen (Entity SQL)
  Erläutert Funktionen, die keine bitweisen Funktionen, Datums- und Uhrzeitfunktionen, Zeichenfolgenfunktionen, mathematische Funktionen oder Aggregatfunktionen sind.

Siehe auch

Konzepte

Übersicht über Entity SQL
Entity SQL-Referenz
Mapping von kanonischen EDM-Funktionen zu SQL Server-Funktionen