Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Diese Aufgabe akzeptiert eine Liste von Elementen, die möglicherweise im Dateinamen eine gültige Zeichenfolge für den .NET-Kulturbezeichner enthalten, und erzeugt Elemente, die Metadaten mit dem Namen Culture aufweisen, in denen der entsprechende Kulturbezeichner enthalten ist.In den Dateinamen Form1.fr-fr.resx beispielsweise ist der Kulturbezeichner "fr-fr" eingebettet. Daher erzeugt diese Aufgabe ein Element, das denselben Dateinamen sowie die Metadaten Culture mit der Angabe fr-fr aufweist.Zudem erzeugt die Aufgabe eine Liste mit Dateinamen, aus denen der Kulturbezeichner entfernt wurde.
Aufgabenparameter
In der folgenden Tabelle werden die Parameter der AssignCulture-Aufgabe beschrieben.
Parameter |
Beschreibung |
---|---|
AssignedFiles |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält die im Files-Parameter empfangene Liste von Elementen, denen jeweils ein Culture-Metadateneintrag hinzugefügt wurde. Wenn das eingehende Element aus dem Files-Parameter bereits einen Culture-Metadateneintrag enthält, wird dieser 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 sich zwischen den letzten beiden Punkten im Dateinamen befinden. |
AssignedFilesWithCulture |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält die Teilmenge der Elemente aus dem AssignedFiles-Parameter, die einen Culture-Metadateneintrag aufweisen. |
AssignedFilesWithNoCulture |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält die Teilmenge der Elemente aus dem AssignedFiles-Parameter, die keinen Culture-Metadateneintrag aufweisen. |
CultureNeutralAssignedFiles |
Optionaler ITaskItem[]-Ausgabeparameter. Enthält dieselbe Liste von Elementen, die auch im AssignedFiles-Parameter erzeugt wird, allerdings wird hier der Kulturbezeichner aus dem Dateinamen entfernt. Die Aufgabe entfernt den Kulturbezeichner nur dann aus dem Dateinamen, wenn es sich um einen gültigen Kulturbezeichner handelt. |
Files |
Erforderlicher ITaskItem[]-Parameter. Gibt die Liste der Dateien mit eingebetteten Kulturnamen an, denen eine Kultur zugewiesen werden soll. |
Hinweise
Zusätzlich zu den oben 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 für die ResourceFiles-Elementauflistung ausgeführt.
<Project xmlns="https://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 |
Inhalt |
---|---|
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) |