Parameter 요소(CSDL)
CSDL(개념 스키마 정의 언어)의 Parameter 요소는 FunctionImport 요소 또는 Function 요소의 자식일 수 있습니다.
FunctionImport 요소 적용
FunctionImport 요소의 자식인 Parameter 요소를 사용하여 CSDL로 선언된 함수 가져오기에 대한 입력 및 출력 매개 변수를 정의할 수 있습니다.
Parameter 요소는 다음에 나열된 순서대로 자식 요소를 포함할 수 있습니다.
Documentation(0개 또는 한 개의 요소 허용)
Annotation 요소(0개 이상의 요소 허용)
적용 가능한 특성
다음 표에서는 Parameter 요소에 적용할 수 있는 특성에 대해 설명합니다.
| 특성 이름 | 필수 여부 | 값 |
|---|---|---|
Name |
예 |
매개 변수의 이름입니다. |
Type |
예 |
매개 변수 형식입니다. 값은 모델 범위 내에 있는 EDMSimpleType 또는 복합 형식이어야 합니다. 자세한 내용은 개념적 모델 형식을 참조하십시오. |
Mode |
아니요 |
매개 변수가 입력, 출력 또는 입력/출력 매개 변수 중 어느 유형인지에 따라 In, Out 또는 InOut입니다. |
MaxLength |
아니요 |
매개 변수의 최대 허용 길이입니다. |
Precision |
아니요 |
매개 변수의 전체 자릿수입니다. |
Scale |
아니요 |
매개 변수의 소수 자릿수입니다. |
.gif "Ee473431.note(ko-kr,VS.100).gif") 참고: |
|---|
| 주석 특성(사용자 지정 XML 특성)을 원하는 수만큼 Parameter 요소에 적용할 수 있습니다.그러나 사용자 지정 특성은 CSDL에 예약된 XML 네임스페이스에 속할 수 없습니다.두 사용자 지정 특성의 정규화된 이름은 서로 같을 수 없습니다. |
예제
다음 예제에서는 하나의 Parameter 자식 요소가 포함된 FunctionImport 요소를 보여 줍니다. 함수는 하나의 입력 매개 변수를 받아들이고 엔터티 형식의 컬렉션을 반환합니다.
<FunctionImport Name="GetStudentGrades"
EntitySet="StudentGrade"
ReturnType="Collection(SchoolModel.StudentGrade)">
<Parameter Name="StudentID" Mode="In" Type="Int32" />
</FunctionImport>
Function 요소 적용
Function 요소의 자식인 Parameter 요소는 개념적 모델에서 정의되거나 선언된 함수에 대한 매개 변수를 정의합니다.
Parameter 요소는 다음에 나열된 순서대로 자식 요소를 포함할 수 있습니다.
Documentation(0개 또는 한 개의 요소)
CollectionType(0개 또는 한 개의 요소)
ReferenceType(0개 또는 한 개의 요소)
RowType(0개 또는 한 개의 요소)
| 참고: |
|---|
| CollectionType, ReferenceType 또는 RowType 요소 중 하나만 Property 요소의 자식 요소가 될 수 있습니다. |
- Annotation 요소(0개 이상의 요소 허용)
| 참고: |
|---|
| Annotation 요소는 다른 모든 자식 요소 뒤에 와야 합니다.Annotation 요소는 .NET Framework 버전 4 이상을 대상으로 하는 응용 프로그램에 대한 개념적 모델에서만 허용됩니다.이러한 모델에 대한 XML 네임스페이스는 https://schemas.microsoft.com/ado/2008/09/edm입니다. |
적용 가능한 특성
다음 표에서는 Parameter 요소에 적용할 수 있는 특성에 대해 설명합니다.
| 특성 이름 | 필수 여부 | 값 |
|---|---|---|
Name |
예 |
매개 변수의 이름입니다. |
Type |
아니요 |
매개 변수 형식입니다. 매개 변수는 다음 형식 또는 이러한 형식의 컬렉션일 수 있습니다.
이러한 형식에 대한 자세한 내용은 개념적 모델 형식을 참조하십시오. |
Nullable |
아니요 |
속성에 null 값을 사용할 수 있는지 여부에 따라 True(기본값) 또는 False입니다. |
DefaultValue |
아니요 |
속성의 기본값입니다. |
MaxLength |
아니요 |
속성 값의 최대 길이입니다. |
FixedLength |
아니요 |
속성 값이 고정 길이 문자열로 저장될지 여부에 따라 True 또는 False입니다. |
Precision |
아니요 |
속성 값의 전체 자릿수입니다. |
Scale |
아니요 |
속성 값의 소수 자릿수입니다. |
Unicode |
아니요 |
속성 값이 유니코드 문자열로 저장될지 여부에 따라 True 또는 False입니다. |
Collation |
아니요 |
데이터 소스에 사용될 데이터 정렬 순서를 지정하는 문자열입니다. |
| 참고: |
|---|
| 주석 특성(사용자 지정 XML 특성)을 원하는 수만큼 Parameter 요소에 적용할 수 있습니다.그러나 사용자 지정 특성은 CSDL에 예약된 XML 네임스페이스에 속할 수 없습니다.두 사용자 지정 특성의 정규화된 이름은 서로 같을 수 없습니다. |
예제
다음 예제에서는 하나의 Parameter 자식 요소를 사용하여 함수 매개 변수를 정의하는 Function 요소를 보여 줍니다.
<Function Name="GetYearsEmployed" ReturnType="Edm.Int32">
<Parameter Name="Instructor" Type="SchoolModel.Person" />
<DefiningExpression>
Year(CurrentDateTime()) - Year(cast(Instructor.HireDate as DateTime))
</DefiningExpression>
</Function>
참고 항목
개념
Entity Framework 개요
CSDL 사양
EntityContainer 요소(CSDL)
기타 리소스
CSDL, SSDL 및 MSL 사양
ADO.NET Entity Data Model Tools
How to: Import a Stored Procedure
How to: Define Custom Functions in the Conceptual Model