GenerateResource – úloha
Převede mezi txt a soubory RESX (formát zdrojů na základě XML) a společný jazyk runtime s příponou Resources binární soubory, které může být vložený v binární spustitelný runtime nebo zkompilován satelitní sestavení.Tento úkol se obvykle používá k převodu souborů TXT nebo RESX .resource soubory.GenerateResource Úkolu je funkčně podobná resgen.exe.
Parametry
Následující tabulka popisuje parametry GenerateResource úkolu.
Parametr |
Description |
|---|---|
AdditionalInputs |
Volitelný ITaskItem[] parametr. Obsahuje další vstupy pro tento úkol provést kontrola závislosti.Například soubory projektu a cílů obvykle třeba vstupů, tak, že pokud jsou aktualizovány všechny prostředky vygenerují. |
EnvironmentVariables |
Volitelný String[] parametr. Určuje pole páry název hodnota prostředí proměnných, které mají být předány na vytvářený resgen.exe kromě (nebo selektivně potlačení) pravidelné prostředí block. |
ExcludedInputPaths |
Volitelný ITaskItem[] parametr. Určuje pole zadat cesty, z nichž budou ignorovány sledované vstupů během kontroly aktuální položky. |
ExecuteAsTool |
Volitelný Boolean parametr. Pokud true, spustí tlbimp.exe a aximp.exe z odpovídající cílové rámce z mimoprocesovou generovat sestavení nezbytné obálky.Tento parametr umožňuje multi zaměření ResolveComReferences. |
FilesWritten |
Volitelný ITaskItem[] výstupní parametr. Obsahuje názvy všech souborů, které jsou zapsány na disk.To zahrnuje soubor mezipaměti, pokud existují.Tento parametr je užitečný pro implementace vyčistit. |
MinimalRebuildFromTracking |
Volitelný Boolean parametr. Získá nebo nastaví přepínač, který určuje, zda budou použity sledované přírůstkového sestavení.Pokud true, je zapnuto přírůstkového sestavení; nové vytvoření jinak, budou ukončeny. |
NeverLockTypeAssemblies |
Volitelný Boolean parametr. Určuje název se soubory, například soubory s příponou Resources.Pokud nezadáte název, použit název odpovídající vstupní soubor a soubor s příponou Resources, který je vytvořen je umístěn v adresáři, který obsahuje vstupní soubor. |
OutputResources |
Volitelný ITaskItem[] výstupní parametr. Určuje název se soubory, například soubory s příponou Resources.Pokud nezadáte název, použit název odpovídající vstupní soubor a soubor s příponou Resources, který je vytvořen je umístěn v adresáři, který obsahuje vstupní soubor. |
PublicClass |
Volitelný Boolean parametr. Pokud true, vytvoří třídu prostředků se silnými jako třída public. |
References |
Volitelný String[] parametr. Odkazy načíst typy souborů RESX.Prvky dat souboru RESX pravděpodobně.Typ sítě.Přečtení souboru RESX to musí být vyřešeny.Obvykle je přeložen úspěšně pomocí standardní typ načítání pravidel.Pokud zadáte sestavení v References, budou mít přednost. Tento parametr není vyžadován silnými zdrojů. |
SdkToolsPath |
Volitelný String parametr. Určuje cestu k SDK nástroje, jako je například resgen.exe. |
Sources |
Požadované ITaskItem[] parametr. Určuje položky, které chcete převést.Položky předán tento parametr musí mít některou z následujících přípon:
|
StateFile |
Volitelný ITaskItem parametr. Určuje cestu k souboru volitelnou mezipaměť, který slouží k urychlení závislost, kontrola odkazů v RESX vstupní soubory. |
StronglyTypedClassName |
Volitelný String parametr. Určuje název třídy prostředků se silnými třídy.Pokud tento parametr není zadán, je použita základní název souboru prostředků. |
StronglyTypedFilename |
Volitelný ITaskItem parametr. Určuje název souboru pro zdrojový soubor.Pokud tento parametr není zadán, bude název třídy slouží jako základní název souboru s příponou závislé na jazyku.Například: MyClass.cs. |
StronglyTypedLanguage |
Volitelný String parametr. Určuje jazyk při generování zdroj třídy silnými zdroje.Tento parametr musí odpovídat přesně jeden z jazyků používaných zprostředkovatel CodeDomProvider.For example: VB or C#. Předáním hodnoty tohoto parametru dáte pokyn úkolu generovat silnými prostředky. |
StronglyTypedManifestPrefix |
Volitelný String parametr. Určuje předponu oboru názvů nebo manifestu zdroje používat zdroje vygenerované třídy silnými zdroje. |
StronglyTypedNamespace |
Volitelný String parametr. Určuje obor názvů pro zdroj generované třídy silnými zdroje.Pokud není tento parametr zadán, jsou silnými prostředky v globální obor názvů. |
TLogReadFiles |
Volitelný ITaskItem[] parametr pouze pro čtení. Získá-li pole položek, které představují čtení sledování protokolů. |
TLogWriteFiles |
Volitelný ITaskItem[] parametr pouze pro čtení. Získá pole položek, které představují zápisu sledování protokolů. |
ToolArchitecture |
Volitelný [String] parametr. Slouží k určení, zda Tracker.exe lze spustit ResGen.exe. Musí být parsable na člena ExecutableType výčtu.Pokud String.Empty, používá k určení výchozí architektura heuristika.Musí být parsable na členem výčtu Microsoft.Build.Utilities.ExecutableType. |
TrackerFrameworkPath |
Volitelný [String] parametr. Určuje cestu k příslušné.NET Framework umístění, které obsahuje FileTracker.dll. Pokud nastavení uživatele má odpovědnost za ověřování, zda odpovídá počtu bitů FileTracker.dll, že předání počtu bitů ResGen.exe, který chtějí použít.Není-li sadu úkolu rozhodne příslušné umístění na základě aktuální.NET Framework verze. |
TrackerLogDirectory |
Volitelný [String] parametr. Určuje zprostředkující adresář, do kterého bude umístěn protokoly sledování od spuštění této úlohy. |
TrackerSdkPath |
Volitelný [String] parametr. Určuje cestu do příslušného umístění Windows SDK, která obsahuje Tracker.exe. Pokud nastavení uživatele má odpovědnost za ověřování, zda odpovídá počtu bitů Tracker.exe, že předání počtu bitů ResGen.exe, který chtějí použít.Není-li sadu úkolu rozhodne příslušné umístění na základě aktuální Windows SDK. |
TrackFileAccess |
Volitelný [Boolean] parametr. Pokud je hodnota true, adresář vstupního souboru se používá pro řešení relativní cesty k souborům. |
UseSourcePath |
Volitelný Boolean parametr. Pokud true, určuje, že vstupní soubor adresáře pro řešení relativní cesty k souborům. |
Poznámky
Protože RESX soubory mohou obsahovat odkazy na jiné soubory prostředků, není dostatečné jednoduše porovnávat časová razítka souboru RESX a .resource zda výstupy jsou aktuální.Místo toho GenerateResource úkol následující odkazy v souborech RESX a zkontroluje časová propojené soubory.To znamená, že není vhodné používat obecně Inputs a Outputs atributy obsahující cílový GenerateResource , jak to může způsobit vynechány, by ve skutečnosti spuštění úloh.
Vedle výše uvedených parametrů, zdědí tento úkol parametry z TaskExtension dědí třídu, která sama Task třídy.Seznam těchto další parametry a jejich popis naleznete v TaskExtension – základní třída.
Při použití nástroje MSBuild 4.0 k cíli.NET 3.5 projekty sestavení může selhat x 86 prostředky.Chcete-li tento problém vyřešit, můžete vytvořit cíl jako sestavení AnyCPU.
Příklad
V následujícím příkladu GenerateResource úkolu generovat soubory s příponou Resources ze souborů určených Resx položka kolekce.
<GenerateResource
Sources="@(Resx)"
OutputResources="@(Resx->'$(IntermediateOutputPath)%(Identity).resources')">
<Output
TaskParameter="OutputResources"
ItemName="Resources"/>
</GenerateResource>
GenerateResource Úloh používá <LogicalName> metadata <EmbeddedResource> Položka název prostředku, který je vložen v sestavení.
Za předpokladu, že sestavení s názvem myAssembly, následující kód vygeneruje vložený prostředek s názvem someQualifier.someResource.resources:
<ItemGroup> <EmbeddedResource Include="myResource.resx"> <LogicalName>someQualifier.someResource.resources</LogicalName> </EmbeddedResource></ItemGroup>
Bez <LogicalName> metadata, zdroj bude název myAssembly.myResource.resources.Tento příklad se vztahuje pouze na procesu vytváření Visual Basic a Visual C#.