ObjectContext.ExecuteFunction 메서드

정의

네임스페이스:

System.Data.Objects

어셈블리:

System.Data.Entity.dll

오버로드

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

function이 null이거나 비어 있는 경우

또는

function 가 없는 경우

InvalidOperationException

엔터티 판독기에서 이 function을 지원하지 않는 경우

또는

판독기와 function에서 형식이 일치하지 않는 경우

ExecuteFunction<TElement>(String, ObjectParameter[])

데이터 소스에 정의되어 있으며 개념적 모델에 매핑되는 저장 프로시저 또는 함수를 지정된 매개 변수를 사용하여 실행합니다. 형식화된 ObjectResult<T>을 반환합니다.

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

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>

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

function이 null이거나 비어 있는 경우

또는

function 가 없는 경우

InvalidOperationException

엔터티 판독기에서 이 function을 지원하지 않는 경우

또는

판독기와 function에서 형식이 일치하지 않는 경우

설명

ExecuteFunction 메서드는 데이터 원본에 정의되고 개념적 모델에 표현된 저장 프로시저 또는 함수를 실행하는 데 사용되는 도우미 메서드입니다. 엔터티 데이터 모델 도구는 개념적 모델의 각 FunctionImport 요소 에 대한 메서드를 생성합니다. 이러한 메서드는 강력한 형식의 ExecuteFunction 를 호출하여 형식화된 ObjectResult<T>를 반환합니다. 자세한 내용은 저장 프로시저를 사용하는 애플리케이션 코드(Entity Framework)를 참조하세요.

함수에 대한 모든 매개 변수는 매개 변수 배열에 필요하며 모든 형식은 함수 자체의 형식을 포함하여 가져오기 함수의 메타데이터에 대해 검사됩니다. null CLR 값 형식에는 값이 허용됩니다. 매개 변수 유효성 검사는 공급자가 수행합니다.

메서드는 ExecuteFunction 의 MergeOptionAppendOnly값을 사용합니다. 따라서 개체 컨텍스트에 개체가 이미 있는 경우 데이터 원본에서 로드되지 않습니다.

추가 정보

• 개체 작업(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)

형식 매개 변수

TElement

함수가 데이터 소스에 대해 실행될 때 반환되는 ObjectResult<T>의 엔터티 형식입니다. 이 형식은 IEntityWithChangeTracker를 구현해야 합니다.

매개 변수

functionName

String

저장 프로시저나 함수의 이름입니다. 이름에는 컨테이너 이름(예: <Container Name>.<Function Name>)이 포함될 수 있습니다. 기본 컨테이너 이름이 알려져 있으면 함수 이름만 필요합니다.

mergeOption

MergeOption

쿼리를 실행할 때 사용할 MergeOption입니다.

parameters

ObjectParameter[]

ObjectParameter 개체의 배열입니다.

반환

ObjectResult<TElement>

저장 프로시저에서 반환하는 데이터의 ObjectResult<T>입니다.

예외

ArgumentException

function이 null이거나 비어 있는 경우

또는

function 가 없는 경우

InvalidOperationException

엔터티 판독기에서 이 function을 지원하지 않는 경우

또는

판독기와 function에서 형식이 일치하지 않는 경우

설명

메서드 ExecuteFunction 는 데이터 원본에 정의되고 개념적 모델로 표현되는 저장 프로시저 또는 함수를 실행하는 데 사용되는 도우미 메서드입니다. 엔터티 데이터 모델 도구는 개념적 모델의 각 FunctionImport 요소 에 대한 메서드를 생성합니다. 이러한 메서드는 강력한 형식의 ExecuteFunction 를 호출하여 형식화된 ObjectResult<T>를 반환합니다. 자세한 내용은 저장 프로시저를 사용하는 애플리케이션 코드(Entity Framework)를 참조하세요.

함수에 대한 모든 매개 변수는 매개 변수 배열에 필요하며 모든 형식은 함수 자체의 형식을 포함하여 가져오기 함수의 메타데이터에 대해 검사됩니다. null CLR 값 형식에는 값이 허용됩니다. 매개 변수 유효성 검사는 공급자가 수행합니다.

추가 정보

• 개체 작업(Entity Framework)