Sdílet prostřednictvím

Migrace aplikace pro Windows 8.x do .NET Native

.NET Native poskytuje statickou kompilaci aplikací v Microsoft Storu nebo na počítači vývojáře. To se liší od dynamické kompilace prováděné pro aplikace pro Windows 8.x (také dříve označované jako aplikace z Microsoft Storu) kompilátorem JIT (just-in-time) nebo generátorem nativních imagí (Ngen.exe) na zařízení. Navzdory rozdílům se .NET Native snaží udržovat kompatibilitu s .NET pro aplikace pro Windows 8.x. Ve většině případů věci, které fungují na .NET pro aplikace Windows 8.x, také fungují s .NET Native. V některých případech ale můžete narazit na změny chování. Tento dokument popisuje tyto rozdíly mezi standardními aplikacemi .NET pro Windows 8.x a .NET Native v následujících oblastech:

Obecné rozdíly v runtime

  • Výjimky, například TypeLoadException, které kompilátor JIT vyvolá, když aplikace běží v modulu CLR (Common Language Runtime), obvykle vedou k chybám v době kompilace při zpracování rozhraním .NET Native.

  • Nevolejte metodu GC.WaitForPendingFinalizers z vlákna uživatelského rozhraní aplikace. To může mít za následek zablokování v .NET Native.

  • Nezávislejte na pořadí vyvolání konstruktorů statických tříd. V .NET Native se pořadí vyvolání liší od pořadí ve standardním modulu runtime. (I v případě standardního modulu runtime byste neměli spoléhat na pořadí provádění konstruktorů statických tříd.)

  • Nekonečné smyčkování bez volání (například while(true);) v libovolném vlákně může paralyzovat aplikaci. Podobně může velké či nekonečné čekání přivést aplikaci k zastavení.

  • Některé obecné inicializační cykly nevyvolají výjimky v .NET Native. Například následující kód vyvolá TypeLoadException výjimku ve standardním CLR. V .NET Native ne.

    using System;

struct N<T> {}
struct X { N<X> x; }

public class Example
{
   public static void Main()
   {
      N<int> n = new N<int>();
      X x = new X();
   }
}

  • V některých případech poskytuje .NET Native různé implementace knihoven tříd rozhraní .NET Framework. Objekt vrácený metodou vždy implementuje členy vráceného typu. Vzhledem k tomu, že se jeho základní implementace liší, možná ji nebudete moct přetypovat na stejnou sadu typů, jakou byste mohli na jiných platformách .NET Framework. V některých případech například není možné přetypovat IEnumerable<T> objekt rozhraní vrácený metodami, jako jsou TypeInfo.DeclaredMembers nebo TypeInfo.DeclaredProperties, na T[].

  • Mezipaměť WinInet není ve výchozím nastavení povolená v .NET pro aplikace pro Windows 8.x, ale je v .NET Native. To zlepšuje výkon, ale má vliv na pracovní sadu. Není nutná žádná akce vývojáře.

Dynamické rozdíly v programování

.NET Native staticky začleňuje kód z rozhraní .NET Framework, aby byl kód součástí aplikace a zajišťoval tak maximální výkon. Binární velikosti ale musí zůstat malé, takže nelze převést celé rozhraní .NET Framework. Kompilátor .NET Native toto omezení vyřeší pomocí reduktoru závislostí, který odebere odkazy na nepoužitý kód. .NET Native ale nemusí udržovat nebo generovat informace o typu a kód, pokud tyto informace nelze odvodit staticky v době kompilace, ale místo toho se načítají dynamicky za běhu.

.NET Native umožňuje reflexi a dynamické programování. Ne všechny typy ale můžou být označeny k reflexi, protože by byla vygenerovaná velikost kódu příliš velká (zejména proto, že je podporováno použití veřejných rozhraní API v rozhraní .NET Framework). Kompilátor .NET Native provádí inteligentní volby o typech, které by měly podporovat reflexi, a uchovává metadata a generuje kód pouze pro tyto typy.

Například datová vazba vyžaduje, aby aplikace mohla mapovat názvy vlastností na funkce. V .NET pro aplikace pro Windows 8.x modul CLR automaticky využívá reflexi k poskytování této funkce pro spravované typy a veřejně dostupné nativní typy. V .NET Native kompilátor automaticky obsahuje metadata pro typy, ke kterým svážete data.

Kompilátor .NET Native může také zpracovávat běžně používané obecné typy, jako List<T> jsou a Dictionary<TKey,TValue>, které fungují bez nutnosti jakýchkoli tipů nebo direktiv. Klíčové slovo dynamické je také podporováno v určitých mezích.

Poznámka:

Při přenosu aplikace do .NET Native byste měli důkladně otestovat všechny dynamické cesty kódu.

Výchozí konfigurace pro .NET Native je dostatečná pro většinu vývojářů, ale někteří vývojáři můžou chtít vyladit konfigurace pomocí direktiv modulu runtime (.rd.xml). V některých případech navíc kompilátor .NET Native nedokáže určit, která metadata musí být k dispozici pro reflexi, a spoléhá na rady, zejména v následujících případech:

  • Některé konstrukce jako Type.MakeGenericType a MethodInfo.MakeGenericMethod nelze je určit staticky.

  • Vzhledem k tomu, že kompilátor nemůže určit instance, musí být obecný typ, který chcete odrážet, určen direktivami modulu runtime. To není jen proto, že musí být zahrnut veškerý kód, ale protože reflexe obecných typů může tvořit nekonečný cyklus (například při vyvolání obecné metody pro obecný typ).

Poznámka:

Direktivy modulu runtime jsou definovány v souboru direktiv modulu runtime (.rd.xml). Obecné informace o použití tohoto souboru naleznete v tématu Začínáme. Informace o direktivách modulu runtime naleznete v dokumentu Referenční příručka ke konfiguračnímu souboru direktiv modulu runtime (rd.xml).

.NET Native také obsahuje nástroje pro profilaci, které vývojářům pomáhají určit, které typy mimo výchozí sadu by měly podporovat reflexi.

Existuje řada dalších rozdílů souvisejících s reflexí v chování mezi .NET pro aplikace pro Windows 8.x a .NET Native.

V rámci .NET Native:

  • Soukromé reflexe nad typy a členy v knihovně tříd rozhraní .NET Framework není podporována. Můžete však uvažovat o svých vlastních soukromých typech a členech, stejně jako o typech a členech v knihovnách třetích stran.

  • Vlastnost ParameterInfo.HasDefaultValue správně vrací false pro objekt ParameterInfo, který představuje návratovou hodnotu. V .NET pro aplikace pro Windows 8.x vrátí true. Zprostředkující jazyk (IL) tuto funkci přímo nepodporuje a interpretace zůstává v jazyce.

  • Veřejní členové ve strukturách RuntimeFieldHandle a RuntimeMethodHandle nejsou podporováni. Tyto typy jsou podporovány pouze pro LINQ, stromy výrazů a inicializaci statického pole.

  • RuntimeReflectionExtensions.GetRuntimeProperties a RuntimeReflectionExtensions.GetRuntimeEvents zahrnují skryté členy v základních třídách, a proto mohou být přepsány bez nutnosti explicitního přepsání. To platí také pro jiné metody RuntimeReflectionExtensions.GetRuntime*.

  • Type.MakeArrayType a Type.MakeByRefType neselžou, když se pokusíte vytvořit určité kombinace (například pole objektů typu byref).

  • Reflexi nelze použít k vyvolání členů s parametry ukazatele.

  • Reflexi nelze použít k získání nebo nastavení pole ukazatele.

  • Pokud je počet argumentů chybný a typ jednoho z argumentů je nesprávný, vyvolá .NET Native ArgumentException místo argumentu TargetParameterCountException.

  • Binární serializace výjimek se obecně nepodporuje. V důsledku toho lze do slovníku Exception.Data přidat ne serializovatelné objekty.

Nepodporované scénáře a rozhraní API

Následující části obsahují nepodporované scénáře a rozhraní API pro obecný vývoj, interoperabilitu a technologie, jako jsou HTTPClient a Windows Communication Foundation (WCF):

Obecné rozdíly ve vývoji

typy hodnot

  • Pokud přepíšete ValueType.Equals a ValueType.GetHashCode metody pro typ hodnoty, nevolejte implementace základní třídy. V .NET pro aplikace pro Windows 8.x tyto metody spoléhají na reflexi. V době kompilace generuje .NET Native implementaci, která nespoléhá na reflexi modulu runtime. To znamená, že pokud tyto dvě metody nepřepíšete, budou fungovat podle očekávání, protože .NET Native vygeneruje implementaci v době kompilace. Přesto při přepsání těchto metod a volání implementace základní třídy dojde k výjimce.

  • Typy hodnot větší než 1 megabajt nejsou podporované.

  • Typy hodnot nemohou mít konstruktor bez parametrů v .NET Native. (C# a Visual Basic zakazují konstruktory bez parametrů u typů hodnot. Lze je však vytvořit v il.)

polí

  • Pole s jinou dolní mezí než nulou nejsou podporována. Obvykle jsou tato pole vytvořena voláním přetíženého Array.CreateInstance(Type, Int32[], Int32[]).

  • Dynamické vytváření multidimenzionálních polí se nepodporuje. Taková pole jsou obvykle vytvořena přetížením metody Array.CreateInstance, které zahrnuje parametr lengths, nebo voláním metody Type.MakeArrayType(Int32).

  • Multidimenzionální pole, která mají čtyři nebo více dimenzí, nejsou podporována; to znamená, že jejich Array.Rank hodnota vlastnosti je čtyři nebo větší. Místo toho použijte jagged arrays (pole polí). Například array[x,y,z] je neplatný, ale array[x][y][z] není.

  • Rozptyl vícerozměrných polí není podporován a způsobuje výjimku InvalidCastException během běhu programu.

Generika

  • Nekonečné rozšíření obecného typu vede k chybě kompilátoru. Tento kód se například nepodaří zkompilovat:

    class A<T> {}

class B<T> : A<B<A<T>>>
{}

ukazatele

  • Pole ukazatelů nejsou podporována.

  • Reflexi nelze použít k získání nebo nastavení pole ukazatele.

serializace

Atribut KnownTypeAttribute(String) není podporován. KnownTypeAttribute(Type) Místo toho použijte atribut.

Prostředky

Použití lokalizovaných zdrojů s třídou EventSource není podporováno. Vlastnost EventSourceAttribute.LocalizationResources nedefinuje lokalizované prostředky.

delegáti

Delegate.BeginInvoke a Delegate.EndInvoke nejsou podporovány.

Různá rozhraní API

  • Vlastnost TypeInfo.GUID vyvolá PlatformNotSupportedException výjimku, pokud GuidAttribute atribut není použit na typ. Identifikátor GUID se používá hlavně pro podporu modelu COM.

  • Metoda DateTime.Parse správně parsuje řetězce, které obsahují krátká data v .NET Native. Neudržuje ale kompatibilitu s určitými změnami při analýze data a času.

  • BigInteger.ToString ("E") je správně zaokrouhleno v .NET Native. V některých verzích CLR je výsledný řetězec zkrácen místo zaokrouhlení.

Rozdíly v HttpClient

V .NET Native interně používá třída HttpClientHandler WinINet (prostřednictvím třídy HttpBaseProtocolFilter) místo tříd WebRequest a WebResponse používaných ve standardních aplikacích .NET pro Windows 8.x. WinINet nepodporuje všechny možnosti konfigurace, které HttpClientHandler třída podporuje. Výsledek:

  • Na .NET Native některé vlastnosti schopností vracejí HttpClientHandler, zatímco ve standardních aplikacích .NET pro Windows 8.x vracejí false.

  • Některé přístupové metody konfigurace vlastnosti get vždy vrací pevnou hodnotu v rozhraní .NET Native, která se liší od výchozí konfigurační hodnoty v .NET pro aplikace Windows 8.x.

Některé další rozdíly v chování jsou popsány v následujících pododdílech.

Plná moc

Třída HttpBaseProtocolFilter nepodporuje konfiguraci ani přepisování proxy serveru pro jednotlivé požadavky. To znamená, že všechny požadavky na .NET Native používají systémově nakonfigurovaný proxy server nebo žádný proxy server v závislosti na hodnotě HttpClientHandler.UseProxy vlastnosti. V .NET pro aplikace pro Windows 8.x je proxy server definovaný vlastností HttpClientHandler.Proxy . V prostředí .NET Native při nastavení HttpClientHandler.Proxy na hodnotu odlišnou od null dojde k vyvolání výjimky PlatformNotSupportedException. Tato HttpClientHandler.SupportsProxy vlastnost se vrací false v .NET Native, zatímco se vrací true v rozhraní .NET Framework pro aplikace Windows 8.x.

Automatické přesměrování

Třída HttpBaseProtocolFilter neumožňuje konfiguraci maximálního počtu automatických přesměrování. Hodnota HttpClientHandler.MaxAutomaticRedirections vlastnosti je ve výchozím nastavení 50 ve standardním rozhraní .NET pro aplikace pro Windows 8.x a lze ji upravit. V rozhraní .NET Native je hodnota této vlastnosti 10 a pokus o změnu vyvolá PlatformNotSupportedException výjimku. Vlastnost HttpClientHandler.SupportsRedirectConfiguration vrací false v .NET Native, zatímco v .NET pro Windows 8.x aplikace vrací true.

automatická dekomprese

Aplikace .NET pro Windows 8.x umožňují nastavit vlastnost na HttpClientHandler.AutomaticDecompression, Deflate, GZip, jak Deflate, tak GZip nebo None. .NET Native podporuje Deflate pouze společně s rozhraním GZip nebo None. Při pokusu o nastavení vlastnosti AutomaticDecompression buď na Deflate, nebo na GZip, se tiše nastaví na obojí Deflate i GZip.

Sušenky

Zpracování souborů cookie se provádí současně pomocí HttpClient sítě WinINet. Soubory cookie z CookieContainer jsou kombinovány se soubory cookie v mezipaměti WinINet. Odebráním souboru cookie zabrání CookieContainer odesílat soubor cookie HttpClient, ale pokud byl soubor cookie již registrován WinINetem a uživatel neodstranil soubory cookie, WinINet ho odešle. Není možné programově odebrat soubor cookie ze sítě WinINet pomocí API HttpClient, HttpClientHandler nebo CookieContainer. Nastavení vlastnosti HttpClientHandler.UseCookies na false způsobí, že pouze HttpClient přestane odesílat soubory cookie; WinINet může stále zahrnout své soubory cookie do požadavku.

Pověření

Ve Windows 8.x aplikacích pro .NET fungují vlastnosti HttpClientHandler.UseDefaultCredentials a HttpClientHandler.Credentials nezávisle na sobě. Kromě toho Credentials vlastnost přijímá všechny objekty, které implementuje ICredentials rozhraní. V .NET Native způsobí nastavení vlastnosti UseDefaultCredentials na true, že se vlastnost Credentials stane null. Kromě toho Credentials lze vlastnost nastavit pouze na null, DefaultCredentialsnebo objekt typu NetworkCredential. Přiřazení jakéhokoli jiného objektu ICredentials, z nichž nejoblíbenější je CredentialCache, k vlastnosti Credentials vyvolá PlatformNotSupportedException.

Další nepodporované nebo nekonfigurovatelné funkce

V rámci .NET Native:

Rozdíly v interoperabilitě

Zastaralá rozhraní API

Řada zřídka používaných rozhraní API pro interoperabilitu se spravovaným kódem je zastaralá. Při použití s rozhraním .NET Native mohou tato rozhraní API vyvolat výjimku NotImplementedException nebo způsobit chybu kompilátoru PlatformNotSupportedException. V .NET pro aplikace pro Windows 8.x jsou tato rozhraní API označena jako zastaralá, i když jejich volání generuje upozornění kompilátoru místo chyby kompilátoru.

Zastaralá rozhraní API pro VARIANT maršálování zahrnují:

UnmanagedType.Struct se podporuje, ale v některých scénářích vyvolá výjimku, například při použití s variantami IDispat ch nebo byref.

Zastaralá rozhraní API pro podporu IDispatch zahrnují:

Zastaralá rozhraní API pro klasické události modelu COM zahrnují:

Nepodporovaná API v rozhraní System.Runtime.InteropServices.ICustomQueryInterface, která nejsou podporována v .NET Native, zahrnují:

Mezi další nepodporované funkce spolupráce patří:

Zřídka používané rozhraní API pro maršalování:

Platformové vyvolání a kompatibilita se zprostředkováním komunikace s COM

Většina scénářů pro volání platformy P/Invoke a COM interop je stále podporována v .NET Native. Zejména se podporuje veškerá interoperabilita s rozhraními API prostředí Windows Runtime (WinRT) a veškeré zařazování vyžadované pro prostředí Windows Runtime. Patří sem získávání podpory pro:

.NET Native ale nepodporuje následující:

Použití reflexe k vyvolání metody platformního vyvolání není podporováno. Toto omezení můžete obejít tak, že volání metody zabalíte do jiné metody a místo toho použijete reflexi k volání této obalové metody.

Další rozdíly v rozhraních .NET API pro aplikace pro Windows 8.x

Tato část obsahuje seznam zbývajících rozhraní API, která nejsou v .NET Native podporovaná. Největší sadou nepodporovaných rozhraní API jsou rozhraní API wcf (Windows Communication Foundation).

DataAnnotations (System.ComponentModel.DataAnnotations)

Typy v prostorech názvů System.ComponentModel.DataAnnotations a System.ComponentModel.DataAnnotations.Schema nejsou podporovány v .NET Native. Patří mezi ně následující typy, které jsou přítomné v .NET pro aplikace pro Windows 8.x:

Visual Basic

Visual Basic se v současné době nepodporuje v .NET Native. V rozhraní .NET Native nejsou k dispozici následující typy v jmenných prostorech Microsoft.VisualBasic a Microsoft.VisualBasic.CompilerServices:

kontext reflexe (obor názvů System.Reflection.Context)

Třída System.Reflection.Context.CustomReflectionContext není v .NET Native podporovaná.

RTC (System.Net.Http.Rtc)

Třída System.Net.Http.RtcRequestFactory není v .NET Native podporovaná.

Windows Communication Foundation (WCF) (System.ServiceModel.*)

Typy v oborech názvů System.ServiceModel.* nejsou v .NET Native podporovány. Patří mezi ně následující typy:

Rozdíly v serializátorech

Následující rozdíly se týkají serializace a deserializace s DataContractSerializer, DataContractJsonSerializera XmlSerializer třídy:

Rozdíly Visual Studio

výjimky a ladění (odstraňování chyb)

Při spouštění aplikací kompilovaných pomocí .NET Native v ladicím programu jsou povoleny výjimky s první šancí pro následující typy výjimek:

Vytváření aplikací

Použijte nástroje sestavení x86, které jsou ve výchozím nastavení používány sadou Visual Studio. Nedoporučujeme používat nástroje AMD64 MSBuild, které najdete v C:\Program Files (x86)\MSBuild\12.0\bin\amd64; to může způsobit problémy se sestavením.

profilátory

  • Profiler procesoru sady Visual Studio a profiler paměti XAML nezobrazují správně Just-My-Code.

  • Profiler paměti XAML nezobrazuje přesně data spravované haldy.

  • Profiler procesoru správně neidentifikuje moduly a zobrazuje názvy funkcí s předponou.

projekty knihovny jednotkových testů

Povolení .NET Native v knihovně pro jednotkové testy pro projekt aplikace pro Windows 8.x není podporované a vede k tomu, že se projekt nepodaří sestavit.

Viz také

  • Last updated on