AssignCulture-Aufgabe

  • Artikel

Diese Aufgabe akzeptiert eine Liste von Elementen, die eine gültige .NET-Kulturbezeichnerzeichenfolge als Teil des Dateinamens enthalten kann, und erzeugt Elemente, die Metadaten mit dem Namen Culture aufweisen, die die entsprechenden Kulturbezeichner enthalten. Der Dateiname Form1.fr-fr.resx enthält beispielsweise den eingebetteten Kulturbezeichner „fr-fr“, damit diese Aufgabe ein Element erstellt, das den gleichen Dateinamen mit Metadaten aufweist, bei denen Culture gleich fr-fr ist. Die Aufgabe erstellt auch eine Liste von Dateinamen ohne Kultur.

Aufgabenparameter

In der folgenden Tabelle werden die Parameter der AssignCulture -Aufgabe beschrieben.

Parameter Beschreibung
AssignedFiles Optionaler ITaskItem[] -Ausgabeparameter.

Enthält die Liste der Elemente, die innerhalb des Files-Parameters empfangen wurden, mit einem Culture-Metadateneintrag, der jedem Element hinzugefügt wurde.

Wenn das eingehende Element vom Files-Parameter bereits einen Culture-Metadateneintrag enthält, wird der ursprüngliche Metadateneintrag verwendet.

Die Aufgabe weist nur dann einen Culture-Metadateneintrag zu, wenn der Dateiname einen gültigen Kulturbezeichner enthält. Der Kulturbezeichner muss zwischen den letzten beiden Punkten im Dateinamen platziert werden.
AssignedFilesWithCulture Optionaler ITaskItem[] -Ausgabeparameter.

Enthält die Teilmenge der Elemente aus dem AssignedFiles-Parameter mit Culture-Metadateneintrag
AssignedFilesWithNoCulture Optionaler ITaskItem[] -Ausgabeparameter.

Enthält die Teilmenge der Elemente aus dem AssignedFiles-Parameter ohne Culture-Metadateneintrag.
CultureNeutralAssignedFiles Optionaler ITaskItem[] -Ausgabeparameter.

Enthält dieselben Elemente, die im AssignedFiles-Parameter erzeugt werden. Der einzige Unterschied ist, dass die Kultur aus dem Dateinamen entfernt wurde.

Die Aufgabe entfernt nur die Kultur aus dem Dateinamen, wenn der Kulturbezeichner gültig ist.
Files Erforderlicher ITaskItem[]-Parameter.

Gibt die Liste der Dateien mit eingebetteten Kulturnamen an, denen eine Kultur zugewiesen werden soll Die Aufgabe versucht herauszufinden, ob die jeweilige Datei eine kulturspezifische Ressource ist, und wenn ja, für welche Kultur sie zutrifft. Um diesen Erkennungsprozess zu überspringen und zu erzwingen, dass eine Datei kulturneutral ist, legen Sie den Metadateneintrag WithCulture auf false fest.

Hinweise

Zusätzlich zu den in diesem Artikel aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.

Beispiel

Im folgenden Beispiel wird die AssignCulture-Aufgabe mit der ResourceFiles-Elementauflistung ausgeführt.

<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 der folgenden Tabelle wird der Wert der Ausgabeelemente nach der Ausführung der Aufgabe beschrieben. Elementmetadaten werden in Klammern nach dem Element angezeigt.

Elementauflistung Inhalte
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (keine zusätzlichen Metadaten)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (keine zusätzlichen Metadaten)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (keine zusätzlichen Metadaten)

Weitere Informationen