ObjectContext.ExecuteFunction 메서드

정의

오버로드

ExecuteFunction(String, ObjectParameter[])

데이터 소스에 정의되어 있으며 개념적 모델로 표현되는 저장 프로시저 또는 함수를 실행합니다. 함수에서 반환되는 결과는 모두 무시되고 실행의 영향을 받는 행 수가 반환됩니다.Executes a stored procedure or function that is defined in the data source and expressed in the conceptual model; discards any results returned from the function; and returns the number of rows affected by the execution.

ExecuteFunction<TElement>(String, ObjectParameter[])

데이터 소스에 정의되어 있으며 개념적 모델에 매핑되는 저장 프로시저 또는 함수를 지정된 매개 변수를 사용하여 실행합니다.Executes a stored procedure or function that is defined in the data source and mapped in the conceptual model, with the specified parameters. 형식화된 ObjectResult<T>을 반환합니다.Returns a typed ObjectResult<T>.

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

데이터 소스에 정의되어 있으며 개념적 모델로 표현되는 지정된 저장 프로시저 또는 함수를 지정된 매개 변수와 병합 옵션을 사용하여 실행합니다.Executes the given stored procedure or function that is defined in the data source and expressed in the conceptual model, with the specified parameters, and merge option. 형식화된 ObjectResult<T>을 반환합니다.Returns a typed ObjectResult<T>.

ExecuteFunction(String, ObjectParameter[])

데이터 소스에 정의되어 있으며 개념적 모델로 표현되는 저장 프로시저 또는 함수를 실행합니다. 함수에서 반환되는 결과는 모두 무시되고 실행의 영향을 받는 행 수가 반환됩니다.Executes a stored procedure or function that is defined in the data source and expressed in the conceptual model; discards any results returned from the function; and returns the number of rows affected by the execution.

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

저장 프로시저나 함수의 이름입니다.The name of the stored procedure or function. 이름에는 컨테이너 이름 등의 컨테이너 이름이 포함 될 수 있습니다 < > . < 함수 이름 > 입니다.The name can include the container name, such as <Container Name>.<Function Name>. 기본 컨테이너 이름이 알려져 있으면 함수 이름만 필요합니다.When the default container name is known, only the function name is required.

parameters
ObjectParameter[]

ObjectParameter 개체의 배열입니다.An array of ObjectParameter objects.

반환

Int32

영향을 받은 행 수입니다.The number of rows affected.

예외

function이 null이거나 비어 있는 경우function is null or empty

또는-or-

function 가 없는 경우function is not found.

엔터티 판독기에서 이 function을 지원하지 않는 경우The entity reader does not support this function.

또는-or-

판독기와 function에서 형식이 일치하지 않는 경우There is a type mismatch on the reader and the function.

적용 대상

ExecuteFunction<TElement>(String, ObjectParameter[])

데이터 소스에 정의되어 있으며 개념적 모델에 매핑되는 저장 프로시저 또는 함수를 지정된 매개 변수를 사용하여 실행합니다.Executes a stored procedure or function that is defined in the data source and mapped in the conceptual model, with the specified parameters. 형식화된 ObjectResult<T>을 반환합니다.Returns a typed 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>의 엔터티 형식입니다.The entity type of the ObjectResult<T> returned when the function is executed against the data source. 이 형식은 IEntityWithChangeTracker를 구현해야 합니다.This type must implement IEntityWithChangeTracker.

매개 변수

functionName
String

저장 프로시저나 함수의 이름입니다.The name of the stored procedure or function. 이름에는 컨테이너 이름 등의 컨테이너 이름이 포함 될 수 있습니다 < > . < 함수 이름 > 입니다.The name can include the container name, such as <Container Name>.<Function Name>. 기본 컨테이너 이름이 알려져 있으면 함수 이름만 필요합니다.When the default container name is known, only the function name is required.

parameters
ObjectParameter[]

ObjectParameter 개체의 배열입니다.An array of ObjectParameter objects.

반환

ObjectResult<TElement>

저장 프로시저에서 반환하는 데이터의 ObjectResult<T>입니다.An ObjectResult<T> for the data that is returned by the stored procedure.

예외

function이 null이거나 비어 있는 경우function is null or empty

또는-or-

function 가 없는 경우function is not found.

엔터티 판독기에서 이 function을 지원하지 않는 경우The entity reader does not support this function.

또는-or-

판독기와 function에서 형식이 일치하지 않는 경우There is a type mismatch on the reader and the function.

설명

ExecuteFunction메서드는 데이터 소스에 정의 되어 있으며 개념적 모델로 표현 되는 저장 프로시저 또는 함수를 실행 하는 데 사용 되는 도우미 메서드입니다.The ExecuteFunction method is a helper method that is used to execute stored procedures or functions that are defined in the data source and expressed in the conceptual model. 엔터티 데이터 모델 도구는 개념적 모델의 각 FunctionImport 요소 에 대해 메서드를 생성 합니다.The Entity Data Model tools generate a method for each FunctionImport Element in the conceptual model. 이러한 메서드는 강력한 형식의를 호출 ExecuteFunction 하 여 형식화 된을 반환 ObjectResult<T> 합니다.These methods call a strongly-typed ExecuteFunction to return a typed ObjectResult<T>. 자세한 내용은 저장 프로시저를 사용 하는 응용 프로그램 코드 (Entity Framework)를 참조 하세요.For more information, see Application Code using Stored Procedures (Entity Framework).

함수에 대 한 모든 매개 변수는 매개 변수 배열에 필요 하며, 함수 자체의 형식을 포함 하 여 가져오기 함수의 메타 데이터에 대해 모든 형식을 검사 합니다.All parameters for the function are required in the parameters array and all types are checked against the metadata for the import function, including the type of the function itself. null CLR 값 형식에는 값을 사용할 수 있습니다.null values are permitted for CLR value types. 공급자는 매개 변수 유효성 검사를 수행 합니다.Parameter validation is performed by the provider.

ExecuteFunction메서드는의 값을 사용 합니다 MergeOption AppendOnly .The ExecuteFunction method uses the MergeOption value of AppendOnly. 따라서 개체가 개체 컨텍스트에 이미 있으면 데이터 원본에서 로드 되지 않습니다.Therefore, if an object already exists in the object context, it will not be loaded from the data source.

추가 정보

적용 대상

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

데이터 소스에 정의되어 있으며 개념적 모델로 표현되는 지정된 저장 프로시저 또는 함수를 지정된 매개 변수와 병합 옵션을 사용하여 실행합니다.Executes the given stored procedure or function that is defined in the data source and expressed in the conceptual model, with the specified parameters, and merge option. 형식화된 ObjectResult<T>을 반환합니다.Returns a typed 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)

형식 매개 변수

TElement

함수가 데이터 소스에 대해 실행될 때 반환되는 ObjectResult<T>의 엔터티 형식입니다.The entity type of the ObjectResult<T> returned when the function is executed against the data source. 이 형식은 IEntityWithChangeTracker를 구현해야 합니다.This type must implement IEntityWithChangeTracker.

매개 변수

functionName
String

저장 프로시저나 함수의 이름입니다.The name of the stored procedure or function. 이름에는 컨테이너 이름 등의 컨테이너 이름이 포함 될 수 있습니다 < > . < 함수 이름 > 입니다.The name can include the container name, such as <Container Name>.<Function Name>. 기본 컨테이너 이름이 알려져 있으면 함수 이름만 필요합니다.When the default container name is known, only the function name is required.

mergeOption
MergeOption

쿼리를 실행할 때 사용할 MergeOption입니다.The MergeOption to use when executing the query.

parameters
ObjectParameter[]

ObjectParameter 개체의 배열입니다.An array of ObjectParameter objects.

반환

ObjectResult<TElement>

저장 프로시저에서 반환하는 데이터의 ObjectResult<T>입니다.An ObjectResult<T> for the data that is returned by the stored procedure.

예외

function이 null이거나 비어 있는 경우function is null or empty

또는-or-

function 가 없는 경우function is not found.

엔터티 판독기에서 이 function을 지원하지 않는 경우The entity reader does not support this function.

또는-or-

판독기와 function에서 형식이 일치하지 않는 경우There is a type mismatch on the reader and the function.

설명

ExecuteFunction메서드는 데이터 원본에 정의 되 고 개념적 모델로 표현 되는 저장 프로시저 또는 함수를 실행 하는 데 사용 되는 도우미 메서드입니다.The ExecuteFunction method is a helper method that is used to execute stored procedures or functions that are defined in the data source and expressed in conceptual model. 엔터티 데이터 모델 도구는 개념적 모델의 각 FunctionImport 요소 에 대해 메서드를 생성 합니다.The Entity Data Model tools generate a method for each FunctionImport Element in the conceptual model. 이러한 메서드는 강력한 형식의를 호출 ExecuteFunction 하 여 형식화 된을 반환 ObjectResult<T> 합니다.These methods call a strongly-typed ExecuteFunction to return a typed ObjectResult<T>. 자세한 내용은 저장 프로시저를 사용 하는 응용 프로그램 코드 (Entity Framework)를 참조 하세요.For more information, see Application Code using Stored Procedures (Entity Framework).

함수에 대 한 모든 매개 변수는 매개 변수 배열에 필요 하며, 함수 자체의 형식을 포함 하 여 가져오기 함수의 메타 데이터에 대해 모든 형식을 검사 합니다.All parameters for the function are required in the parameters array and all types are checked against the metadata for the import function, including the type of the function itself. null CLR 값 형식에는 값을 사용할 수 있습니다.null values are permitted for CLR value types. 공급자는 매개 변수 유효성 검사를 수행 합니다.Parameter validation is performed by the provider.

추가 정보

적용 대상