ObjectContext.ExecuteFunction メソッド

定義

名前空間:: System.Data.Objects

アセンブリ:: System.Data.Entity.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
ExecuteFunction(String, ObjectParameter[])	データソースで定義され、概念モデルで表されるストアドプロシージャまたは関数を実行します。は、関数から返された結果を破棄します。実行の影響を受ける行の数を返します。
ExecuteFunction<TElement>(String, ObjectParameter[])	データソースで定義され、指定されたパラメーターを使用して概念モデルにマップされたストアドプロシージャまたは関数を実行します。型指定された ObjectResult<T>を返します。
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	指定されたパラメーターとマージオプションを使用して、データソースで定義され、概念モデルで表される、指定されたストアドプロシージャまたは関数を実行します。型指定された ObjectResult<T>を返します。

ExecuteFunction(String, ObjectParameter[])

データソースで定義され、概念モデルで表されるストアドプロシージャまたは関数を実行します。は、関数から返された結果を破棄します。実行の影響を受ける行の数を返します。

public:
 int ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public int ExecuteFunction(string functionName, params System.Data.Objects.ObjectParameter[] parameters);

member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> int

Public Function ExecuteFunction (functionName As String, ParamArray parameters As ObjectParameter()) As Integer

パラメーター

functionName: String

ストアドプロシージャまたは関数の名前。名前には、 <Container Name>.<Function Name>などのコンテナー名を含めることができます。既定のコンテナー名がわかっている場合は、関数名のみが必要です。

parameters: ObjectParameter[]

ObjectParameter オブジェクトの配列。

返品

Int32

影響を受ける行の数。

例外

ArgumentException

functionName が null または空です。

-又は-

functionName が見つかりません。

InvalidOperationException

エンティティリーダーは、この functionNameをサポートしていません。

-又は-

リーダーと関数に型の不一致があります。

適用対象

ExecuteFunction<TElement>(String, ObjectParameter[])

データソースで定義され、指定されたパラメーターを使用して概念モデルにマップされたストアドプロシージャまたは関数を実行します。型指定された ObjectResult<T>を返します。

protected:
generic <typename TElement>
 where TElement : System::Data::Objects::DataClasses::IEntityWithChangeTracker System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

protected System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, params System.Data.Objects.ObjectParameter[] parameters) where TElement : System.Data.Objects.DataClasses.IEntityWithChangeTracker;

public System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, params System.Data.Objects.ObjectParameter[] parameters);

member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element (requires 'Element :> System.Data.Objects.DataClasses.IEntityWithChangeTracker)> (requires 'Element :> System.Data.Objects.DataClasses.IEntityWithChangeTracker)

member this.ExecuteFunction : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element>

Protected Function ExecuteFunction(Of TElement As IEntityWithChangeTracker) (functionName As String, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

Public Function ExecuteFunction(Of TElement) (functionName As String, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)

型パラメーター

TElement

データソースに対して関数が実行されるときに返される ObjectResult<T> のエンティティ型。この型は、 IEntityWithChangeTrackerを実装する必要があります。

パラメーター

functionName: String

parameters: ObjectParameter[]

ObjectParameter オブジェクトの配列。

返品

ObjectResult<TElement>

ストアドプロシージャによって返されるデータの ObjectResult<T> 。

例外

ArgumentException

functionName が null または空です

-又は-

functionName が見つかりません。

InvalidOperationException

エンティティリーダーはこの関数をサポートしていません。

-又は-

リーダーと関数に型の不一致があります。

注釈

ExecuteFunction メソッドは、データソースで定義され、概念モデルで表されるストアドプロシージャまたは関数を実行するために使用されるヘルパーメソッドです。 Entity Data Model ツールは、概念モデルの FunctionImport 要素ごとにメソッドを生成します。これらのメソッドは、厳密に型指定された ExecuteFunction を呼び出して、型指定された ObjectResult<T>を返します。

パラメーター配列には関数のすべてのパラメーターが必要であり、関数自体の型を含め、すべての型がインポート関数のメタデータに対してチェックされます。 null 値は CLR 値型に対して許可されます。パラメーターの検証は、プロバイダーによって実行されます。

ExecuteFunctionメソッドは、AppendOnlyのMergeOption値を使用します。したがって、オブジェクトがオブジェクトコンテキストに既に存在する場合、データソースからは読み込まれません。

こちらもご覧ください

オブジェクトの操作 (Entity Framework)

適用対象

ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])

指定されたパラメーターとマージオプションを使用して、データソースで定義され、概念モデルで表される、指定されたストアドプロシージャまたは関数を実行します。型指定された ObjectResult<T>を返します。

public:
generic <typename TElement>
 System::Data::Objects::ObjectResult<TElement> ^ ExecuteFunction(System::String ^ functionName, System::Data::Objects::MergeOption mergeOption, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public System.Data.Objects.ObjectResult<TElement> ExecuteFunction<TElement>(string functionName, System.Data.Objects.MergeOption mergeOption, params System.Data.Objects.ObjectParameter[] parameters);

member this.ExecuteFunction : string * System.Data.Objects.MergeOption * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectResult<'Element>

Public Function ExecuteFunction(Of TElement) (functionName As String, mergeOption As MergeOption, ParamArray parameters As ObjectParameter()) As ObjectResult(Of TElement)