Delen via

AssignCulture-taak

  • Artikel

Deze taak accepteert een lijst met items die mogelijk een geldige .NET-cultuur-id-tekenreeks bevatten als onderdeel van de bestandsnaam en produceert items met een metagegevens met de naam Culture die de bijbehorende cultuur-id bevatten. Bijvoorbeeld de bestandsnaam Form1.fr-fr.resx- heeft een ingesloten cultuur-id 'fr-fr', dus deze taak produceert een item met dezelfde bestandsnaam met de metagegevens Culture gelijk aan fr-fr. De taak produceert ook een lijst met bestandsnamen met de cultuur die uit de bestandsnaam is verwijderd.

Taakparameters

In de volgende tabel worden de parameters van de AssignCulture taak beschreven.

Parameter Beschrijving
AssignedFiles Optionele ITaskItem[] uitvoerparameter.

Bevat de lijst met items die zijn ontvangen in de parameter Files, met een Culture metagegevensvermelding toegevoegd aan elk item.

Als het binnenkomende item van de parameter Files al een Culture metagegevensvermelding bevat, wordt de oorspronkelijke metagegevensvermelding gebruikt.

De taak wijst alleen een Culture metagegevensvermelding toe als de bestandsnaam een geldige cultuur-id bevat. De cultuur-id moet tussen de laatste twee puntjes in de bestandsnaam staan.
AssignedFilesWithCulture Optionele ITaskItem[] uitvoerparameter.

Bevat de subset van de items uit de parameter AssignedFiles met een Culture metagegevensvermelding.
AssignedFilesWithNoCulture Optionele ITaskItem[] uitvoerparameter.

Bevat de subset van de items uit de parameter AssignedFiles die geen Culture metagegevensvermelding hebben.
CultureNeutralAssignedFiles Optionele ITaskItem[] uitvoerparameter.

Bevat dezelfde lijst met items die worden geproduceerd in de parameter AssignedFiles, met uitzondering van de cultuur die uit de bestandsnaam is verwijderd.

De taak verwijdert alleen de cultuur uit de bestandsnaam als het een geldige cultuur-id is.
Files Vereiste ITaskItem[] parameter.

Hiermee geeft u de lijst met bestanden met ingesloten cultuurnamen waaraan een cultuur moet worden toegewezen. De taak probeert erachter te komen of elk bestand een cultuurspecifieke resource is, en zo ja, welke cultuur. Als u dit detectieproces wilt overslaan en wilt afdwingen dat een bestand cultuurneutraal is, stelt u de vermelding van de metagegevens in WithCulture op false.
RespectAlreadyAssignedItemCulture Optionele bool parameter.

Als deze optie is ingesteld op true: de reeds ingestelde cultuurmetagegevens op de parameter Files item worden gerespecteerd en de CultureNeutralAssignedFiles wordt gevuld met ongewijzigde bestandsnaam van Files.

Opmerkingen

Naast de parameters die in dit artikel worden vermeld, neemt deze taak parameters over van de TaskExtension-klasse, die zelf wordt overgenomen van de Task-klasse. Zie TaskExtension-basisklassevoor een lijst met deze aanvullende parameters en beschrijvingen.

Voorbeeld

In het volgende voorbeeld wordt de AssignCulture taak uitgevoerd met de ResourceFiles itemverzameling.

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

In de volgende tabel wordt de waarde van de uitvoeritems na de taakuitvoering beschreven. Metagegevens van items worden weergegeven tussen haakjes na het item.

Itemverzameling Inhoud
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (geen extra metagegevens)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (geen extra metagegevens)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (geen extra metagegevens)

Zie ook