Poznámky k verzi pro ASP.NET a webové nástroje 2013.1 pro Visual Studio 2012

od Microsoftu

Tento dokument popisuje vydání ASP.NET and Web Tools 2013.1 pro Visual Studio 2012.

Obsah

• Poznámky k instalaci

• Požadavky na software

• Nové funkce v ASP.NET and Web Tools 2013.1 pro Visual Studio 2012

  • Bootstrap

  • Šablony

    • šablona ASP.NET MVC 5
    • Šablona webového rozhraní API ASP.NET 2
    • Šablony položek

  • Entity Framework 6

  • ASP.NET generování uživatelského rozhraní

  • Razor Editor

  • NuGet 2.7

• Známé problémy a zásadní změny

  • ASP.NET generování uživatelského rozhraní

    • Generování uživatelského rozhraní MVC a webového rozhraní API – chyba HTTP 404, Nenalezena
    • Visual Studio Express 2012 for Web přestane po přidání vygenerované položky fungovat

  • ASP.NET Razor 3

    • Zobrazení souboru cshtml pomocí funkce Procházet s nebo F5 způsobí chybu serveru.
    • Přepsání adresy URL a tilda(~)

  • Šablony

Poznámky k instalaci

Nainstalujte ASP.NET and Web Tools 2013.1 pro Visual Studio 2012.

Požadavky na software

Musíte mít sadu Visual Studio 2012 nebo Visual Studio Express 2012 pro web.

Nové funkce v ASP.NET and Web Tools 2013.1 pro Visual Studio 2012

Metoda bootstrap

Když vygenerujete kontrolery a zobrazení MVC 5, značky pro zobrazení používají bootstrap.

Šablony

šablona ASP.NET MVC 5

Přidali jsme novou šablonu MVC 5. Odkazuje na nejnovější balíčky NuGet MVC 5 a k přidání kontrolerů a zobrazení můžete použít generování uživatelského rozhraní.

Šablona webového rozhraní API ASP.NET 2

Přidali jsme novou šablonu webového rozhraní API 2. Odkazuje na nejnovější balíčky NuGet webového rozhraní API 2 a k přidání kontrolerů a zobrazení můžete použít generování uživatelského rozhraní.

Šablony položek

Přidali jsme nové šablony položek pro zobrazení MVC 5, webové stránky (Razor 3) a kontrolery webového rozhraní API 2. Při přidávání nových položek nainstalují do projektu související balíčky NuGet.

Entity Framework 6

Při generování uživatelského rozhraní MVC nebo kontroleru webového rozhraní API pomocí Entity Frameworku použijeme Framework 6. Další informace o rozhraní Entity Framework najdete v historii verzí Entity Framework.

Můžete si také stáhnout a nainstalovat nástroje Entity Framework 6 pro Visual Studio 2012. Projděte si téma Získání Entity Frameworku.

ASP.NET generování uživatelského rozhraní

ASP.NET Generování uživatelského rozhraní je rozhraní pro generování kódu pro ASP.NET webové aplikace. Usnadňuje přidání často používaného kódu do projektu, který komunikuje s datovým modelem.

V předchozích verzích sady Visual Studio bylo generování uživatelského rozhraní omezeno na projekty ASP.NET MVC. S touto aktualizací teď můžete používat generování uživatelského rozhraní pro jakýkoli projekt ASP.NET, včetně Web Forms. Tato aktualizace nepodporuje generování stránek pro projekt Web Forms, ale i tak můžete použít generování uživatelského rozhraní s Web Forms přidáním závislostí MVC do projektu. Podpora generování stránek pro Web Forms bude přidána v budoucí aktualizaci.

Při použití generování uživatelského rozhraní zajistíme, aby v projektu byly nainstalované všechny požadované závislosti. Pokud například začnete s projektem ASP.NET Web Forms a pak pomocí generování přidáte kontroler webového rozhraní API, požadované balíčky NuGet a odkazy se do projektu přidají automaticky.

Pokud chcete přidat generování uživatelského rozhraní MVC do projektu Web Forms, přidejte novou vygenerovanou položku a v dialogovém okně vyberte Závislosti MVC 5. Existují dvě možnosti pro generování uživatelského rozhraní MVC; Minimální a úplná. Pokud vyberete Možnost Minimální, přidají se do projektu jenom balíčky NuGet a odkazy pro ASP.NET MVC. Pokud vyberete možnost Úplné, přidají se minimální závislosti a také požadované soubory obsahu pro projekt MVC.

Podpora generování asynchronních kontrolerů využívá nové asynchronní funkce z Entity Frameworku 6.

Další informace a kurzy najdete v tématu ASP.NET Přehled generování uživatelského rozhraní. Tyto kurzy ukazují generování uživatelského rozhraní s Visual Studio 2013, ale platí i pro ASP.NET and Web Tools 2013.1 pro Visual Studio 2012.

Razor Editor

V této aktualizaci teď Visual Studio 2012 podporuje nástroje a úpravy Razor 3.

NuGet 2.7

NuGet 2.7 obsahuje bohatou sadu nových funkcí, které jsou podrobně popsané v poznámkách k verzi NuGet 2.7.

Tato verze NuGetu odstraňuje potřebu uživatelů explicitně povolit NuGetu obnovení chybějících balíčků. Při instalaci NuGetu 2.7 uživatelé implicitně souhlasí s automatickým obnovením chybějících balíčků. Uživatelé můžou výslovně vyjádřit výslovný nesouhlas s obnovením balíčků prostřednictvím nastavení NuGet v sadě Visual Studio. Tato změna zjednodušuje fungování obnovení balíčků.

Známé problémy a zásadní změny

ASP.NET generování uživatelského rozhraní

Generování uživatelského rozhraní MVC a webového rozhraní API – chyba HTTP 404, Nenalezena

Pokud při přidávání vygenerované položky do projektu dojde k chybě, je možné, že projekt zůstane v nekonzistentním stavu. Některé z provedených změn vygenerování budou vráceny zpět, ale jiné změny, jako jsou nainstalované balíčky NuGet, se nevrátí zpět. Pokud se změny konfigurace směrování vrátí zpět, uživatelům se při přechodu na vygenerované položky zobrazí chyba HTTP 404.

Pokud chcete tuto chybu u MVC opravit, přidejte novou vygenerovanou položku a vyberte Závislosti MVC 5 (minimální nebo úplné). Tento proces přidá do projektu všechny požadované změny.

Oprava této chyby u webového rozhraní API:

1. Do projektu přidejte následující třídu WebApiConfig.

   public static class WebApiConfig
   {
       public static void Register(HttpConfiguration config)
       {
           config.MapHttpAttributeRoutes();
           config.Routes.MapHttpRoute(
               name: "DefaultApi",
               routeTemplate: "api/{controller}/{id}",
               defaults: new { id = RouteParameter.Optional }
           );
       }
   }
   

   Public Module WebApiConfig
       Public Sub Register(ByVal config As HttpConfiguration)
           config.MapHttpAttributeRoutes()
           config.Routes.MapHttpRoute(
             name:="DefaultApi",
             routeTemplate:="api/{controller}/{id}",
             defaults:=New With {.id = RouteParameter.Optional}
           )
       End Sub
   End Module
   

2. V metodě Application_Start v souboru Global.asax nakonfigurujte webApiConfig.Register následujícím způsobem:

   public class WebApiApplication : System.Web.HttpApplication
   {
       protected void Application_Start()
       {
           GlobalConfiguration.Configure(WebApiConfig.Register);    
       }
   }
   

   Public Class WebApiApplication
        Inherits System.Web.HttpApplication
    
        Sub Application_Start()     
          GlobalConfiguration.Configure(AddressOf WebApiConfig.Register)       
        End Sub
   End Class
   

Visual Studio Express 2012 for Web přestane po přidání vygenerované položky fungovat

Pokud Visual Studio Express 2012 for Web přestane fungovat po přidání vygenerované položky s Rozhraním Entity Framework (například Kontroler webového rozhraní API 2 s akcemi pomocí Entity Framework), je možné, že Visual Studio Express nepodařilo načíst nativní bitovou kopii sestavení závislého na System.Web.Extensions.

Chcete-li tento problém vyřešit, nakonfigurujte Visual Studio Express pro práci s bitovou kopií jazyka MSIL system.Web.Extensions:

1. Otevřete příkazový řádek v režimu správce.

2. Přejděte na %ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE nebo %ProgramFiles(x86)%\Microsoft Visual Studio 11.0\Common7\IDE (pro 64bitovou verzi Windows).

3. Otevřete VWDExpress.exe.config v textovém editoru.

4. Do elementu <configuration>/<runtime> přidejte následující řádek:

   <disableNativeImageLoad>
       <assemblyIdentity name="System.Web.Extensions" />
   </disableNativeImageLoad>
   

5. Restartujte Visual Studio Express 2012 pro web.

ASP.NET Razor 3

Zobrazení souboru cshtml pomocí funkce Procházet s nebo F5 způsobí chybu serveru.

Když v sadě Visual Studio 2012 vytvoříte projekt MVC 5 (nebo otevřete v sadě Visual Studio 2012 projekt MVC 5, který byl vytvořen v Visual Studio 2013) a pokusíte se zobrazit soubor cshtml pomocí příkazu Procházet s nebo F5, zobrazí se chybová zpráva Chyba serveru v aplikaci /. Server se pokusí přejít na http://localhost:XXXX/Views/../XXXX.cshtml

Pokud chcete tento problém vyřešit, změňte nastavení Spustit akci v projektu na Konkrétní stránka. Pro stránku nemusíte zadávat hodnotu.

Po provedení této změny se stisknutím klávesy F5 přejde do kořenového adresáře aplikace (http://localhost:XXXX). Toto chování není stejné jako u projektů MVC 5 v Visual Studio 2013, kde nastavení Aktuální stránka spustí otevřenou stránku.

Přepsání adresy URL a tilda(~)

Po upgradu na ASP.NET Razor 3 nebo ASP.NET MVC 5 nemusí zápis tildy (~) fungovat správně, pokud používáte přepisy adres URL. Přepsání adresy URL ovlivňuje zápis tildy(~) v elementech HTML, jako <je A/>, <SCRIPT/>, <LINK/>, a v důsledku toho se tilda už nemapuje na kořenový adresář.

Pokud například přepíšete požadavky na asp.net/content na asp.net, atribut href v <A href="~/content/"/> se místo přeloží na /content/content/ místo na /. Chcete-li tuto změnu potlačit, můžete nastavit kontext IIS_WasUrlRewritten na hodnotu false v každé webové stránce nebo v Application_BeginRequest v souboru Global.asax.

Šablony

Při vytváření projektů ASP.NET MVC se sadou Visual Studio 2012 na Windows 8.1 nebo Windows Server 2012 R2 zobrazí sada Visual Studio chybovou zprávu, že konfigurace webu [url] pro ASP.NET 4.5 se nezdařila."

Tato chyba se zobrazí, protože Visual Studio 2012 při instalaci v těchto verzích Windows nepovoluje funkci ASP.NET 4.5. Pokud chcete povolit ASP.NET 4.5, proveďte kroky popsané v tématu Zapnutí nebo vypnutí funkcí systému Windows.

Alternativně můžete povolit ASP.NET 4.5 prostřednictvím příkazového řádku.

1. Otevřete příkazový řádek v režimu správce.
2. Spuštěním následujícího příkazu povolte ASP.NET 4.5.
   dism /Online /Enable-Feature /FeatureName:NetFx4Extended-ASPNET45 /Quiet /NoRestart