Freigeben über

AssignCulture-Aufgabe

  • Artikel

Diese Aufgabe akzeptiert eine Liste von Elementen, die eine gültige .NET-Kulturbezeichnerzeichenfolge als Teil des Dateinamens enthalten können, und erzeugt Elemente, die eine Metadaten mit dem Namen Culture enthalten, die den entsprechenden Kulturbezeichner enthalten. Beispielsweise der Dateiname Form1.fr-frRESX- verfügt über einen eingebetteten Kulturbezeichner "fr-fr", sodass diese Aufgabe ein Element erzeugt, das denselben Dateinamen mit den Metadaten Culture gleich fr-frhat. Die Aufgabe erzeugt auch eine Liste von Dateinamen, deren Kultur aus dem Dateinamen entfernt wurde.

Vorgangsparameter

In der folgenden Tabelle werden die Parameter des AssignCulture Vorgangs beschrieben.

Parameter Beschreibung
AssignedFiles Optionaler ITaskItem[] Ausgabeparameter.

Enthält die Liste der im Files-Parameter empfangenen Elemente, wobei jedem Element ein Culture Metadateneintrag hinzugefügt wurde.

Wenn das eingehende Element aus dem parameter Files bereits einen Culture Metadateneintrag enthält, wird der ursprüngliche Metadateneintrag verwendet.

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

Enthält die Teilmenge der Elemente aus dem AssignedFiles-Parameter mit einem Culture Metadateneintrag.
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 die gleiche Liste von Elementen, die im parameter AssignedFiles erstellt werden, mit Ausnahme der Kultur, die aus dem Dateinamen entfernt wurde.

Die Aufgabe entfernt die Kultur nur 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, der eine Kultur zugewiesen werden soll. Der Vorgang versucht herauszufinden, ob jede Datei eine kulturspezifische Ressource ist, und wenn ja, welche Kultur. Wenn Sie diesen Erkennungsprozess überspringen und erzwingen möchten, dass eine Datei kulturneutral ist, legen Sie den Metadateneintrag WithCulture auf falsefest.
RespectAlreadyAssignedItemCulture Optionaler bool-Parameter.

Wenn dieser Wert auf true festgelegt ist – werden die bereits festgelegten Kulturmetadaten für den Files Elementparameter berücksichtigt, und die CultureNeutralAssignedFiles wird mit dem unveränderten Dateinamen von Filesaufgefüllt.

Bemerkungen

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 dieser zusätzlichen Parameter und deren 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 Aufgabenausführung 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)

Siehe auch