ObjectContext.ExecuteFunction 方法

定義

命名空間:

System.Data.Entity.Core.Objects

組件:

EntityFramework.dll

多載

ExecuteFunction(String, ObjectParameter[])	執行資料來源中所定義和以概念模型表示的預存程序或函式、捨棄函式傳回的任何結果，然後傳回受執行所影響的資料列數目。
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	使用指定的參數和合併選項，執行資料來源中所定義和以概念模型表示之指定的預存程序或函式。 傳回具 ObjectResult<T> 類型的 。
ExecuteFunction<TElement>(String, ObjectParameter[])	使用指定的參數，執行資料來源中所定義且在概念模型中有所對應的預存程序或函式。 傳回具 ObjectResult<T> 類型的 。
ExecuteFunction<TElement>(String, ExecutionOptions, ObjectParameter[])	在預設容器上執行指定的函式。

ExecuteFunction(String, ObjectParameter[])

執行資料來源中所定義和以概念模型表示的預存程序或函式、捨棄函式傳回的任何結果，然後傳回受執行所影響的資料列數目。

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

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

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

參數

functionName

String

預存程序或函式的名稱。 名稱可以包含容器名稱，例如 < 容器名稱 > 。 <函式名稱 > 。 已知預設容器名稱時，只需要函式名稱。

parameters

ObjectParameter[]

ObjectParameter 物件的陣列。 如果使用輸出參數，則在完整讀取結果之前，將無法使用其值。 這是因為 DbDataReader 的基礎行為，如需詳細資訊，請參閱 http://go.microsoft.com/fwlink/?LinkID=398589 。

傳回

Int32

受影響的資料列數目。

例外狀況

ArgumentException

函式為 Null 或空白或找不到函式。

InvalidOperationException

實體讀取器不支援此函式，或讀取器和函式上的類型不符。

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

使用指定的參數和合併選項，執行資料來源中所定義和以概念模型表示之指定的預存程序或函式。 傳回具 ObjectResult<T> 類型的 。

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

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

類型參數

TElement

針對資料來源執行此函式時，所傳回之 ObjectResult<T> 的實體類型。 此類型必須實作 IEntityWithChangeTracker 。

參數

functionName

String

預存程序或函式的名稱。 名稱可以包含容器名稱，例如 < 容器名稱 > 。 <函式名稱 > 。 已知預設容器名稱時，只需要函式名稱。

mergeOption

MergeOption

要在執行查詢時使用的 MergeOption。

parameters

ObjectParameter[]

ObjectParameter 物件的陣列。 如果使用輸出參數，則在完整讀取結果之前，將無法使用其值。 這是因為 DbDataReader 的基礎行為，如需詳細資訊，請參閱 http://go.microsoft.com/fwlink/?LinkID=398589 。

傳回

ObjectResult<TElement>

預存程序所傳回之資料的 ObjectResult<T>。

例外狀況

ArgumentException

函式為 Null 或空白或找不到函式。

InvalidOperationException

實體讀取器不支援此函式，或讀取器和函式上的類型不符。

ExecuteFunction<TElement>(String, ObjectParameter[])

使用指定的參數，執行資料來源中所定義且在概念模型中有所對應的預存程序或函式。 傳回具 ObjectResult<T> 類型的 。

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

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

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 物件的陣列。 如果使用輸出參數，則在完整讀取結果之前，將無法使用其值。 這是因為 DbDataReader 的基礎行為，如需詳細資訊，請參閱 http://go.microsoft.com/fwlink/?LinkID=398589 。

傳回

ObjectResult<TElement>

預存程序所傳回之資料的 ObjectResult<T>。

例外狀況

ArgumentException

函式為 Null 或空白或找不到函式。

InvalidOperationException

實體讀取器不支援此函式，或讀取器和函式上的類型不符。

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

在預設容器上執行指定的函式。

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

abstract member ExecuteFunction : string * System.Data.Entity.Core.Objects.ExecutionOptions * System.Data.Entity.Core.Objects.ObjectParameter[] -> System.Data.Entity.Core.Objects.ObjectResult<'Element>
override this.ExecuteFunction : string * System.Data.Entity.Core.Objects.ExecutionOptions * System.Data.Entity.Core.Objects.ObjectParameter[] -> System.Data.Entity.Core.Objects.ObjectResult<'Element>

類型參數

TElement

函式結果的專案類型。

參數

functionName

String

函式的名稱。 在已知 DefaultContainerName 時，可能包含容器 (，例如 ContainerName.FunctionName) 或只包含函式名稱。

executionOptions

ExecutionOptions

執行此函式的選項。

parameters

ObjectParameter[]

要用於函式的參數值。 如果使用輸出參數，則在完整讀取結果之前，將無法使用其值。 這是因為 DbDataReader 的基礎行為，如需詳細資訊，請參閱 http://go.microsoft.com/fwlink/?LinkID=398589 。

傳回

ObjectResult<TElement>

物件，表示執行此函式的結果。

例外狀況

ArgumentException

如果函式為 Null 或空白

InvalidOperationException

如果函式 (語法無效，則表示傳回類型與 T) 不相容的函式