다음을 통해 공유

AssignCulture 작업

  • 아티클

이 작업은 파일 이름의 일부로 유효한 .NET 문화권 식별자 문자열을 포함할 수 있는 항목 목록을 허용하고 해당 문화권 식별자를 포함하는 Culture 명명된 메타데이터가 있는 항목을 생성합니다. 예를 들어 파일 이름은 Form1에 .fr-fr.resx 포함된 문화권 식별자 "fr-fr"가 있으므로 이 작업은 메타데이터가 fr-fr같은 파일 이름이 Culture 동일한 항목을 생성합니다. 또한 작업에서는 문화권이 파일 이름에서 제거된 파일 이름 목록을 생성합니다.

작업 매개 변수

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

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

각 항목에 Culture 메타데이터 항목이 추가된 Files 매개 변수에서 받은 항목 목록을 포함합니다.

Files 매개 변수에서 들어오는 항목에 이미 Culture 메타데이터 항목이 포함되어 있으면 원래 메타데이터 항목이 사용됩니다.

파일 이름에 유효한 문화권 식별자가 포함된 경우에만 태스크에서 Culture 메타데이터 항목을 할당합니다. 문화권 식별자는 파일 이름의 마지막 두 점 사이에 있어야 합니다.
AssignedFilesWithCulture 선택적 ITaskItem[] 출력 매개 변수입니다.

Culture 메타데이터 항목이 있는 AssignedFiles 매개 변수의 항목 하위 집합을 포함합니다.
AssignedFilesWithNoCulture 선택적 ITaskItem[] 출력 매개 변수입니다.

Culture 메타데이터 항목이 없는 AssignedFiles 매개 변수의 항목 하위 집합을 포함합니다.
CultureNeutralAssignedFiles 선택적 ITaskItem[] 출력 매개 변수입니다.

파일 이름에서 제거된 문화권을 제외하고 AssignedFiles 매개 변수에서 생성되는 항목의 동일한 목록을 포함합니다.

이 작업은 유효한 문화권 식별자인 경우에만 파일 이름에서 문화권을 제거합니다.
Files 필수 ITaskItem[] 매개 변수입니다.

문화권을 할당할 문화권 이름이 포함된 파일 목록을 지정합니다. 태스크는 각 파일이 문화권별 리소스인지, 그렇다면 어떤 문화권인지 알아내려고 합니다. 이 검색 프로세스를 건너뛰고 파일을 문화권 중립적으로 설정하려면 메타데이터 항목 WithCulturefalse설정합니다.
RespectAlreadyAssignedItemCulture 선택적 bool 매개 변수입니다.

true 설정하면 Files 항목 매개 변수에 이미 설정된 Culture 메타데이터가 적용되고 CultureNeutralAssignedFilesFiles변경되지 않은 파일 이름으로 채워집니다.

발언

이 문서에 나열된 매개 변수 외에도 이 작업은 Task 클래스에서 상속되는 TaskExtension 클래스의 매개 변수를 상속합니다. 이러한 추가 매개 변수 및 해당 설명 목록은 TaskExtension 기본 클래스참조하세요.

본보기

다음 예제에서는 ResourceFiles 항목 컬렉션을 사용하여 AssignCulture 작업을 실행합니다.

<Project xmlns="http://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 (추가 메타데이터 없음)

참고 항목