FunctionImport 요소(CSDL)

CSDL(개념 스키마 정의 언어)의 FunctionImport 요소는 데이터 소스에 정의되어 있지만 개념적 모델을 통해 개체에 사용할 수 있는 함수를 나타냅니다. 예를 들어, 저장소 모델에 Function 요소를 사용하여 데이터베이스의 저장 프로시저를 나타낼 수 있습니다. 개념적 모델의 FunctionImport 요소는 Entity Framework 응용 프로그램에서 해당되는 함수를 나타내며 FunctionImportMapping 요소를 사용하여 저장소 모델 함수로 매핑됩니다. 응용 프로그램에서 함수가 호출되면 해당되는 저장 프로시저가 데이터베이스에서 실행됩니다.

FunctionImport 요소를 기반으로 Entity Framework 응용 프로그램에 대한 CLR(공용 언어 런타임) 메서드를 생성할 수 있습니다. 자세한 내용은 생성된 코드 개요(엔터티 데이터 모델 디자이너) 및 방법: EdmGen.exe를 사용하여 개체 계층 코드 생성을 참조하십시오.

FunctionImport 요소는 다음에 나열된 순서대로 자식 요소를 포함할 수 있습니다.

• Documentation(0개 또는 한 개의 요소 허용)

• Parameter(0개 이상의 요소 허용)

• Annotation 요소(0개 이상의 요소 허용)

함수가 받아들이는 각 매개 변수에 대해 하나의 Parameter 요소를 정의해야 합니다.

적용 가능한 특성

다음 표에서는 FunctionImport 요소에 적용할 수 있는 특성에 대해 설명합니다.

특성 이름	필수 여부	값
Name	예	가져온 함수의 이름입니다.
ReturnType	아니요	함수에서 반환하는 형식입니다. 함수에서 값을 반환하지 않으면 이 특성을 사용하지 마십시오. 그렇지 않으면 값은 모델의 범위 내에 있는 EDMSimpleType, 엔터티 형식, 복합 형식 또는 엔터티 형식이나 복합 형식의 컬렉션이어야 합니다. 참고: .NET Framework 버전 3.5 SP1을 대상으로 하는 응용 프로그램에 대한 개념적 모델에서 반환 형식은 EDMSimpleTypes 또는 엔터티 형식의 컬렉션이어야 합니다.
EntitySet	아니요	함수에서 엔터티 형식의 컬렉션을 반환하는 경우 EntitySet 값은 컬렉션이 속한 엔터티 집합이어야 합니다. 그렇지 않으면 EntitySet 특성을 사용하지 않아야 합니다.

참고:
주석 특성(사용자 지정 XML 특성)을 원하는 수만큼 FunctionImport 요소에 적용할 수 있습니다.그러나 사용자 지정 특성은 CSDL에 예약된 XML 네임스페이스에 속할 수 없습니다.두 사용자 지정 특성의 정규화된 이름은 서로 같을 수 없습니다.

예제

다음 예제에서는 하나의 매개 변수를 받아들이고 엔터티 형식의 컬렉션을 반환하는 FunctionImport 요소를 보여 줍니다.

<FunctionImport Name="GetStudentGrades" 
                EntitySet="StudentGrade" 
                ReturnType="Collection(SchoolModel.StudentGrade)">
       <Parameter Name="StudentID" Mode="In" Type="Int32" />
</FunctionImport>

참고 항목

개념

Entity Framework 개요
CSDL 사양
EntityContainer 요소(CSDL)

기타 리소스

CSDL, SSDL 및 MSL 사양
ADO.NET Entity Data Model Tools
How to: Import a Stored Procedure