AssignCulture, zadanie

To zadanie akceptuje listę elementów, które mogą zawierać prawidłowy ciąg identyfikatora kultury platformy .NET w ramach nazwy pliku, i tworzy elementy, które mają metadane o nazwie Culture zawierające odpowiedni identyfikator kultury. Na przykład nazwa pliku Form1.fr-fr.resx ma identyfikator kultury osadzonej "fr-fr", więc to zadanie generuje element, który ma tę samą nazwę pliku z metadanymi Culture równe fr-fr. Zadanie tworzy również listę nazw plików z kulturą usuniętą z nazwy pliku.

Parametry zadania

W poniższej tabeli opisano parametry zadania AssignCulture.

Parametr	Opis
AssignedFiles	Opcjonalny parametr wyjściowy ITaskItem[]. Zawiera listę elementów odebranych w parametrze Files z wpisem metadanych Culture dodanym do każdego elementu. Jeśli element przychodzący z parametru Files zawiera już wpis metadanych Culture, jest używany oryginalny wpis metadanych. Zadanie przypisuje wpis metadanych Culture tylko wtedy, gdy nazwa pliku zawiera prawidłowy identyfikator kultury. Identyfikator kultury musi należeć do dwóch ostatnich kropek w nazwie pliku.
AssignedFilesWithCulture	Opcjonalny parametr wyjściowy ITaskItem[]. Zawiera podzestaw elementów z parametru AssignedFiles, który ma wpis metadanych Culture.
AssignedFilesWithNoCulture	Opcjonalny parametr wyjściowy ITaskItem[]. Zawiera podzbiór elementów z parametru AssignedFiles, który nie ma wpisu metadanych Culture.
CultureNeutralAssignedFiles	Opcjonalny parametr wyjściowy ITaskItem[]. Zawiera tę samą listę elementów, które są generowane w parametrze AssignedFiles, z wyjątkiem kultury usuniętej z nazwy pliku. Zadanie usuwa kulturę tylko z nazwy pliku, jeśli jest prawidłowym identyfikatorem kultury.
Files	Wymagany parametr ITaskItem[]. Określa listę plików z osadzonymi nazwami kultur, do których ma zostać przypisana kultura. Zadanie próbuje ustalić, czy każdy plik jest zasobem specyficznym dla kultury, a jeśli tak, jaka jest kultura. Aby pominąć ten proces wykrywania i wymusić neutralność kulturową pliku, ustaw wpis metadanych WithCulture na false.
RespectAlreadyAssignedItemCulture	Opcjonalny parametr bool. Jeśli ustawiono wartość true — parametr elementu Files jest już ustawiony dla parametru elementu Files, a Files zostanie wypełniona niezmienioną nazwą pliku z .

Uwagi

Oprócz parametrów wymienionych w tym artykule to zadanie dziedziczy parametry z klasy TaskExtension, która sama dziedziczy z klasy Task. Aby uzyskać listę tych dodatkowych parametrów i ich opisów, zobacz TaskExtension, klasa bazowa.

Przykład

Poniższy przykład wykonuje zadanie AssignCulture z kolekcją elementów ResourceFiles.

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

W poniższej tabeli opisano wartość elementów wyjściowych po wykonaniu zadania. Metadane elementu są wyświetlane w nawiasach po elemencie.

Kolekcja elementów	Treść
OutAssignedFiles	MyResource1.fr.resx (Culture="fr") MyResource2.XX.resx (brak dodatkowych metadanych)
OutAssignedFilesWithCulture	MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture	MyResource2.XX.resx (brak dodatkowych metadanych)
OutCultureNeutralAssignedFiles	MyResource1.resx (Culture="fr") MyResource2.XX.resx (brak dodatkowych metadanych)

Zobacz też

• Tasks
• — dokumentacja zadania