ObjectContext.ExecuteFunction 方法

定義

命名空間:: System.Data.Objects

組件:: System.Data.Entity.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
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 為零或為空。

-或-

找不到 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

儲存過程或函式的名稱。名稱可包含容器名稱，例如 <Container Name>.<Function Name>。當已知預設容器名稱時，只需函式名稱即可。

parameters: ObjectParameter[]

ObjectParameter 物件的陣列。

傳回

ObjectResult<TElement>

一個 ObjectResult<T> 由儲存程序回傳的資料。

例外狀況

ArgumentException

functionName 為零或為空

-或-

找不到 functionName。

InvalidOperationException

實體讀取器不支援此功能。

-或-

讀取器與函式之間存在型別不匹配。

備註

此 ExecuteFunction 方法是一種輔助方法，用於執行資料來源中定義並以概念模型表達的儲存程序或函式。實體資料模型工具會為概念模型中的每個 FunctionImport 元素產生一個方法。這些方法呼叫強型別 ExecuteFunction 以回傳型別 ObjectResult<T>。

函式的所有參數皆需在參數陣列中，且所有類型都會與匯入函式的元資料（包括函式本身的型別）進行檢查。 null CLR 值類型允許使用數值。參數驗證由提供者執行。

此ExecuteFunction方法使用值AppendOnly。MergeOption 因此，如果物件已經存在於物件上下文中，則不會從資料來源載入。

另請參閱

物件操作（實體框架）

適用於

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)