Udostępnij za pośrednictwem

AssignCulture — zadanie

  • Artykuł

To zadanie akceptuje listę elementów, które mogą zawierać prawidłowy ciąg identyfikatora kultury .NET w ramach nazwy pliku, i tworzy elementy, które mają metadane o nazwie Culture zawierającej odpowiedni identyfikator kultury. Na przykład nazwa pliku Form1.fr-fr.resx ma osadzony identyfikator kultury "fr-fr", więc to zadanie generuje element, który ma tę samą nazwę pliku z metadanymi Culture równymi 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 AssignCulture zadania.

Parametr Opis
AssignedFiles Opcjonalny ITaskItem[] parametr wyjściowy.

Zawiera listę elementów odebranych w parametrze Files z wpisem metadanych dodanym Culture do każdego elementu.

Jeśli element przychodzący z parametru Files zawiera Culture już wpis metadanych, zostanie użyty oryginalny wpis metadanych.

Zadanie przypisuje Culture wpis metadanych 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 ITaskItem[] parametr wyjściowy.

Zawiera podzbiór elementów z parametru AssignedFiles , który ma Culture wpis metadanych.
AssignedFilesWithNoCulture Opcjonalny ITaskItem[] parametr wyjściowy.

Zawiera podzbiór elementów z parametru AssignedFiles , który nie ma Culture wpisu metadanych.
CultureNeutralAssignedFiles Opcjonalny ITaskItem[] parametr wyjściowy.

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 interfejsu 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 WithCulture metadanych na false.

Uwagi

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

Przykład

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

<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 Zawartość
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ż