AssignCulture 작업AssignCulture Task

이 작업은 유효한 .NET 문화권 식별자 문자열이 포함되어 있는 항목의 목록을 파일 이름의 일부로 허용하고 해당 문화권 식별자가 포함된 Culture라는 메타데이터가 있는 항목을 생성합니다.This task accepts a list of items that may contain a valid .NET culture identifier string as part of the file name, and produces items that have a metadata named Culture containing the corresponding culture identifier. 예를 들어 Form1.fr-fr.resx라는 파일 이름에 포함된 문화권 식별자 "fr-fr"이 있으므로 이 작업은 fr-fr와 같은 Culture 메타데이터를 포함하는 동일한 파일 이름을 가진 항목을 생성합니다.For example, the file name Form1.fr-fr.resx has an embedded culture identifier "fr-fr", so this task will produce an item that has the same filename with the metadata Culture equal to fr-fr. 태스크는 파일 이름에서 제거된 문화권을 포함하는 파일 이름의 목록도 생성합니다.The task also produces a list of filenames with the culture removed from the filename.

작업 매개 변수Task Parameters

다음 표에서는 AssignCulture 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the AssignCulture task.

매개 변수Parameter 설명Description
AssignedFiles 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

각 항목에 추가된 Culture 메타데이터 항목을 포함하여 Files 매개 변수에 수신된 항목 목록이 포함됩니다.Contains the list of items received in the Files parameter, with a Culture metadata entry added to each item.

Files 매개 변수에서 들어오는 항목에 Culture 메타데이터 항목이 포함되는 경우 원래 메타데이터 항목을 사용합니다.If the incoming item from the Files parameter already contains a Culture metadata entry, the original metadata entry is used.

파일 이름에 유효한 문화권 식별자가 포함되는 경우에만 작업이 Culture 메타데이터 항목을 할당합니다.The task only assigns a Culture metadata entry if the file name contains a valid culture identifier. 문화권 식별자는 파일 이름에서 마지막 두 점 사이에 있어야 합니다.The culture identifier must be between the last two dots in the filename.
AssignedFilesWithCulture 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

Culture 메타 데이터 항목이 있는 AssignedFiles 매개 변수에서 항목의 하위 집합이 포함됩니다.Contains the subset of the items from the AssignedFiles parameter that have a Culture metadata entry.
AssignedFilesWithNoCulture 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

Culture 메타 데이터 항목이 없는 AssignedFiles 매개 변수에서 항목의 하위 집합이 포함됩니다.Contains the subset of the items from the AssignedFiles parameter that do not have a Culture metadata entry.
CultureNeutralAssignedFiles 선택적 ITaskItem[] 출력 매개 변수입니다.Optional ITaskItem[] output parameter.

파일 이름에서 제거된 문화권을 제외하고 AssignedFiles 매개 변수에서 생성되는 동일한 항목 목록이 포함됩니다.Contains the same list of items that is produced in the AssignedFiles parameter, except with the culture removed from the file name.

작업이 유효한 문화권 식별자인 경우에만 파일 이름에서 문화권을 제거합니다.The task only removes the culture from the file name if it is a valid culture identifier.
Files 필수 ITaskItem[] 매개 변수입니다.Required ITaskItem[] parameter.

문화권을 할당할 문화권 이름이 포함된 파일 목록을 지정합니다.Specifies the list of files with embedded culture names to assign a culture to.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension Base Class를 참조하세요.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

예제Example

다음 예제에서는 ResourceFiles 항목 컬렉션을 포함하는 AssignCulture 작업을 실행합니다.The following example executes the AssignCulture task with the ResourceFiles item collection.

<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>  

다음 표에서는 작업 실행 이후의 출력 항목 값을 설명합니다.The following table describes the value of the output items after task execution. 항목 뒤에 괄호로 묶은 내용이 항목 메타데이터입니다.Item metadata is shown in parenthesis after the item.

항목 컬렉션입니다.Item collection 목차Contents
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx(추가 메타데이터 없음)MyResource2.XX.resx (no additional metadata)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx(추가 메타데이터 없음)MyResource2.XX.resx (no additional metadata)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

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

참고 항목See Also

작업 Tasks
작업 참조Task Reference