方法: 概念モデルでカスタム関数を定義する (Entity Framework)

[アーティクル]
04/19/2011

概念モデルでカスタム関数を定義するには、DefiningExpression 要素を含む Function 要素を .edmx ファイルの概念スキーマ定義言語 (CSDL) に追加します。パラメーター化されたステートメントなど、CommandText 要素内の Entity SQL ステートメントを定義できます。

詳細については、「DefiningExpression (CSDL)」および「User-Defined Functions (Entity SQL)」を参照してください。

概念モデルでのカスタム関数の定義

次の手順は、Visual Studio の XML エディターで .edmx ファイルを開いていることを前提としています。この手順は、ストレージモデルでカスタム関数を追加する方法の概要をまとめたものです。各手順の詳しい説明は、その後の例で示します。

概念モデルでカスタム関数を定義するには

Function 要素を .edmx ファイルの概念モデルコンテンツセクションにある Schema 要素に追加します。

注 :

ReturnType 属性を使用して、関数の戻り値の型を指定する必要があります。

詳細については、「Function Element (SSDL)」、「Schema Element (SSDL)」、および「ReturnType (CSDL)」を参照してください。

注 :
ReturnType 属性を使用して、関数の戻り値の型を指定する必要があります。

関数が受け入れる各パラメーターについて、Parameter 要素を Function 要素に追加します。

注 :
関数パラメーターは、@ のようなプレフィックスでは設定されません。関数を定義する Entity SQL 式で名前によって直接参照されます。Entity SQL 式で使用する他の識別子とは異なるパラメーター名を選択してください。

詳細については、「Parameter Element (CSDL)」を参照してください。

DefiningExpression 要素を新しい Function 要素に追加します。
DefiningExpression 要素で Entity SQL ステートメントを定義します。
.edmx ファイルを保存して閉じます。

例

以下は、Function 要素の例です。これを .edmx ファイルの概念モデルコンテンツセクションで Schema 要素に追加してカスタム関数を定義します。この Function 要素を School モデルに追加すると、教員が雇用されてからの年数を特定する機能が加わります。

School モデルの例については、「Creating the School Sample Database」および「Generating the School Entity Data Model」を参照してください。

<Function Name="YearsSince" ReturnType="Edm.Int32">
  <Parameter Name="date" Type="Edm.DateTime" />
  <DefiningExpression>
    Year(CurrentDateTime()) - Year(date)
  </DefiningExpression>
</Function>

概念モデルで関数を定義した後、アプリケーションの Entity SQL クエリ内から呼び出すことができます。 LINQ to Entities クエリからの関数の呼び出しについては、「How to: Call Functions Defined in the Conceptual Model」を参照してください。

参照

次の方法で共有

方法: 概念モデルでカスタム関数を定義する (Entity Framework)

概念モデルでのカスタム関数の定義

概念モデルでカスタム関数を定義するには

例

参照

処理手順

概念

その他のリソース

その他のリソース