Share via

AssignCulture 작업

  • 아티클

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

작업 매개 변수

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

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

각 항목에 추가된 Culture 메타데이터 항목을 포함하여 Files 매개 변수에 수신된 항목 목록이 포함됩니다.

Files 매개 변수에서 들어오는 항목에 Culture 메타데이터 항목이 포함되는 경우 원래 메타데이터 항목을 사용합니다.

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

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

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

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

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

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

설명

이 문서에 나열된 매개 변수 외에도 이 작업은 클래스에서 매개 변수를 TaskExtension 상속하며, 이 매개 변수는 클래스에서 Task 상속됩니다. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 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(추가 메타데이터 없음)

참고 항목