다음을 통해 공유

AssignCulture 작업

  • 아티클

이 작업에서는 파일 이름의 일부에 유효한 .NET culture 식별자 문자열이 포함되어 있는 항목의 목록을 전달받고, 해당 culture 식별자가 포함된 Culture라는 메타데이터가 있는 항목을 생성합니다. 예를 들어, 파일 이름 Form1.fr-fr.resx에는 "fr-fr"이라는 culture 식별자가 삽입되어 있으므로 이 작업에서는 메타데이터 Culture가 fr-fr인 동일한 파일 이름이 있는 항목을 생성합니다. 또한 이 작업은 파일 이름에서 culture를 제거한 파일 이름 목록을 생성합니다.

작업 매개 변수

다음 표에서는 AssignCulture 작업의 매개 변수에 대해 설명합니다.

Parameter

설명

AssignedFiles

선택적 ITaskItem[] 출력 매개 변수입니다.

Files 매개 변수에서 받은 항목의 목록이 각 항목에 Culture 메타데이터 엔트리가 추가된 상태로 들어 있습니다.

Files 매개 변수에서 가져오는 항목에 이미 Culture 메타데이터 엔트리가 들어 있으면 원래 메타데이터 엔트리가 사용됩니다.

이 작업에서는 파일 이름에 유효한 문화권 식별자가 포함되어 있는 경우에만 Culture 메타데이터 엔트리를 할당합니다. culture 식별자는 파일 이름에서 마지막 두 개의 마침표 사이에 있어야 합니다.

AssignedFilesWithCulture

선택적 ITaskItem[] 출력 매개 변수입니다.

Culture 메타데이터 엔트리가 있는 AssignedFiles 매개 변수의 하위 항목 집합이 들어 있습니다.

AssignedFilesWithNoCulture

선택적 ITaskItem[] 출력 매개 변수입니다.

Culture 메타데이터 엔트리가 없는 AssignedFiles 매개 변수의 하위 항목 집합이 들어 있습니다.

CultureNeutralAssignedFiles

선택적 ITaskItem[] 출력 매개 변수입니다.

파일 이름에서 culture가 제거되어 있다는 점을 제외하고는 AssignedFiles 매개 변수에서 생성한 것과 동일한 항목 집합이 들어 있습니다.

이 작업에서는 유효한 culture 식별자인 경우에만 파일 이름에서 culture를 제거합니다.

Files

필수적 ITaskItem[] 매개 변수입니다.

culture를 할당할, culture 이름이 포함된 파일 목록을 지정합니다.

설명

위에 나열된 매개 변수 외에도 이 작업은 Task 클래스에서 상속하는 TaskExtension 클래스의 매개 변수를 상속합니다. 추가 매개 변수 목록과 해당 설명은 TaskExtension 기본 클래스를 참조하십시오.

예제

다음 예제에서는 ResourceFiles 항목 컬렉션과 함께 AssignCulture 작업을 실행합니다.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ResourceFiles Include="MyResource1.fr.resx"/>
        <ResourceFiles Include="MyResource2.XX.resx"/>
    </ItemGroup>

    <Target Name="Culture">
        <AssignCulture
            Files="@(ResourceFiles)"
            <Output TaskParameter="AssignedFiles"
                ItemName="OutAssignedFiles"/>
            <Output TaskParameter="AssignedFilesWithCulture"
                ItemName="OutAssignedFilesWithCulture"/>
            <Output TaskParameter="AssignedFilesWithNoCulture"
                ItemName="OutAssignedFilesWithNoCulture"/>
            <Output TaskParameter="CultureNeutralAssignedFiles"
                ItemName="OutCultureNeutralAssignedFiles"/>
        </AssignCulture>
    </Target>
</Project>

다음 표에서는 작업을 실행한 후의 출력 항목에 대한 값을 설명합니다. 항목 메타데이터는 항목 뒤에 괄호로 표시되어 있습니다.

항목 컬렉션

내용

OutAssignedFiles

MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (추가 메타데이터 없음)

OutAssignedFilesWithCulture

MyResource1.fr.resx (Culture="fr")

OutAssignedFilesWithNoCulture

MyResource2.XX.resx (추가 메타데이터 없음)

OutCultureNeutralAssignedFiles

MyResource1.resx (Culture="fr")

MyResource2.XX.resx (추가 메타데이터 없음)

참고 항목

개념

MSBuild 작업

기타 리소스

MSBuild 작업 참조