note sulla versione ASP.NET and Web Tools 2012.2 (RTW)

Questo documento descrive la versione di ASP.NET and Web Tools 2012.2. Si tratta di un aggiornamento dello strumento Web di Visual Studio e ASP.NET.

• Note sull'installazione

• Documentazione

• Supporto

• Requisiti software

• Nuove funzionalità in ASP.NET and Web Tools 2012.2

  • Strumenti

  • pubblicazione sul Web

  • modelli ASP.NET MVC

  • API Web ASP.NET

  • ASP.NET SignalR

  • URL brevi di ASP.NET

• Problemi noti e modifiche di rilievo

Note di installazione

ASP.NET and Web Tools 2012.2 per Visual Studio 2012 può essere installato usando il programma di installazione della piattaforma Web. Si tratta di un aggiornamento a Visual Studio 2012 o Visual Studio Express 2012 per Web, che è necessario. Se Visual Studio non è installato, verrà installato Visual Studio Express 2012 per Web.

È anche possibile installare manualmente ASP.NET and Web Tools 2012.2. È necessario avere installato Visual Studio 2012 o Visual Studio Express 2012 per Web. Usare quindi le istruzioni seguenti:

1. Scaricare ASP.NET e Web Frameworks 2012.2 dal programma di installazione download.
2. Quando richiesto fare clic su Esegui. È anche possibile salvare il file per eseguirlo in un secondo momento.
3. Verificare la versione di Visual Studio che verrà aggiornata. È possibile eseguire questa operazione avviando Visual Studio che si desidera aggiornare. Fare quindi clic sulla voce di menu Della Guida.
   
4. Se viene visualizzata la voce di menu "Informazioni su Microsoft Visual Studio 2012 for Web", scaricare Web Developer Tools 2012.2 - Visual Studio Express 2012 per Web. In caso contrario, scaricare Web Developer Tools 2012.2 - Visual Studio 2012.
5. Quando richiesto fare clic su Esegui. È anche possibile salvare il file per eseguirlo in un secondo momento.

Nota

ASP.NET and Web Tools versione 2012.2 non include SQL Server Data Tools. SQL Server e Database di Windows Azure SQL offre un set più completo di strumenti di database, tra cui lo sviluppo con supporto del progetto offline, il confronto dello schema e le funzionalità di distribuzione avanzata del database. Per altre informazioni o per installare SQL Server Data Tools visitare https://go.microsoft.com/fwlink/?LinkID=237127.

Documentazione

Le esercitazioni e altre informazioni su ASP.NET and Web Tools 2012.2 sono disponibili da ASP.NET sito Web ( https://www.asp.net).

Supporto

ASP.NET and Web Tools 2012.2 è ufficialmente rilasciato e supportato. È possibile usare il canale di supporto normale. È anche possibile inviare domande ai forum ASP.NET (https://forums.asp.net/), dove i membri della community ASP.NET sono spesso in grado di fornire supporto informale.

Requisiti software

Il ASP.NET and Web Tools 2012.2 richiede Visual Studio 2012 o Visual Studio Express 2012 per Web.

Nuove funzionalità in ASP.NET and Web Tools 2012.2

Questa sezione descrive le funzionalità introdotte nella versione ASP.NET and Web Tools 2012.2.

Strumenti

• Controllo pagina

  • Supportare il mapping di selezione JavaScript che consente Controllo pagina di eseguire il mapping di elementi aggiunti dinamicamente alla pagina al codice JavaScript corrispondente.
  • Possibilità di visualizzare gli aggiornamenti CSS in tempo reale.
  • Per altre informazioni, leggere Mapping di sincronizzazione automatica CSS e Selezione JavaScript in Controllo pagina.

• Editor

  • Evidenziazione della sintassi di supporto per CoffeeScript, Mustache, Handlebars e JsRender.
  • L'editor HTML fornisce Intellisense per le associazioni Knockout.
  • Supporto di meno modifiche e compilatore per abilitare la compilazione di CSS dinamici usando LESS.
  • Incollare JSON come classe .NET. Usando questo comando Special Paste per incollare JSON in un file di codice C# o VB.NET e Visual Studio genererà automaticamente classi .NET derivate dal codice JSON.

• Il supporto dell'emulatore mobile aggiunge hook di estendibilità in modo che gli emulatori di terze parti possano essere installati come VSIX. Gli emulatori installati verranno visualizzati nell'elenco a discesa F5, in modo che gli sviluppatori possano visualizzare in anteprima i propri siti Web in un'ampia gamma di dispositivi mobili. Per altre informazioni su questa funzionalità, vedere la voce di blog di Scott Hanselman sulla nuova integrazione di BrowserStack con Visual Studio.

pubblicazione sul Web

• I progetti del sito Web hanno ora la stessa esperienza di pubblicazione dei progetti applicazione Web, inclusa la pubblicazione in Siti Web di Windows Azure.

• Pubblicazione selettiva: per uno o più file è possibile eseguire le azioni seguenti (dopo la pubblicazione in un endpoint di distribuzione Web):

  • Pubblicare file selezionati.
  • Vedere la differenza tra un file locale e un file remoto.
  • Aggiornare il file locale con il file remoto o aggiornare il file remoto con il file locale.

modelli ASP.NET MVC

• Il nuovo modello Applicazione Facebook consente di creare facilmente applicazioni Canvas per Facebook. In pochi e semplici passaggi, è possibile creare un'applicazione per Facebook in grado di ottenere dati da un utente connesso e integrarsi con i relativi contatti. Nel modello è inclusa una nuova libreria per la gestione del plumbing relativo alla creazione di app per Facebook, ad esempio autenticazione, autorizzazioni, accesso ai dati di Facebook e altro ancora, Per altre informazioni sull'uso del modello di applicazione Facebook, vedere https://go.microsoft.com/fwlink/?LinkID=269921.
• Un nuovo modello MVC per applicazioni a pagina singola consente agli sviluppatori di creare app Web interattive sul lato client, mediante HTML 5, CSS 3 e le più conosciute librerie JavaScript, Knockout e jQuery, basate su ASP.NET Web API. Il modello include un'applicazione di elenco "todo" che illustra le procedure comuni per la creazione di un'applicazione HTML5 JavaScript che usa un'API server RESTful. Per altre informazioni, https://www.asp.net/single-page-applicationvedere .
• È ora possibile creare un VSIX che aggiunge nuovi modelli alla finestra di dialogo ASP.NET nuovo progetto MVC. Informazioni su come: https://go.microsoft.com/fwlink/?LinkId=275019
• Pacchetto FixedDisplayModes: i modelli di progetto MVC sono stati aggiornati per includere il nuovo pacchetto NuGet "FixedDisplayModes", che contiene una soluzione alternativa per un bug in MVC 4. Per altre informazioni sulla correzione contenuta nel pacchetto, vedere questo post di blog (/archive/blogs/rickandy/asp-net-mvc-4-mobile-caching-bug-fixed) dal team MVC.

API Web ASP.NET

API Web ASP.NET è stato migliorato con diverse nuove funzionalità:

• API Web ASP.NET OData
• API Web ASP.NET traccia
• Pagina della Guida API Web ASP.NET

API Web ASP.NET OData

API Web ASP.NET OData offre la flessibilità necessaria per creare endpoint OData con logica di business avanzata su qualsiasi origine dati. Con API Web ASP.NET OData si controlla la quantità di semantica OData da esporre. API Web ASP.NET OData è incluso nei modelli di progetto ASP.NET MVC 4 ed è disponibile anche da NuGet (https://www.nuget.org/packages/microsoft.aspnet.webapi.odata).

API Web ASP.NET OData supporta attualmente le funzionalità seguenti:

• Abilitare la semantica di query OData applicando l'attributo [Queryable].
• Convalidare facilmente le query OData e limitare il set di opzioni di query supportate, operatori e funzioni.
• Il parametro si associa direttamente a ODataQueryOptions per ottenere una rappresentazione astratta dell'albero della sintassi della query che può quindi essere convalidata e applicata a un oggetto IQueryable o IEnumerable.
• Abilitare il paging basato sul servizio e la generazione di collegamenti di pagina successiva specificando i limiti dei risultati sull'attributo [Queryable].
• Richiedere un numero inlined del numero totale di risorse corrispondenti usando $inlinecount.
• Controllare la propagazione null.
• Qualsiasi/Tutti gli operatori in $filter.
• Dedurre un modello di dati di entità per convenzione o personalizzare in modo esplicito un modello in modo simile a Entity Framework Code-First.
• Esporre i set di entità derivando da EntitySetController.
• Convenzioni semplici e personalizzabili per esporre le proprietà di spostamento, modificare i collegamenti e implementare azioni OData.
• Routing semplificato usando il metodo di estensione MapODataRoute.
• Supporto per il controllo delle versioni esponendo più modelli EDM.
• Esporre il documento del servizio e $metadata in modo da poter generare client (.NET, Windows Phone, Windows Store e così via) per l'API Web.
• Supporto per i formati dettagliato OData Atom, JSON e JSON.
• Creare, aggiornare, aggiornare parzialmente (PATCH) ed eliminare entità.
• Eseguire query e modificare le relazioni tra entità.
• Creare collegamenti di relazione che si collegano alle route.
• Tipi complessi.
• Ereditarietà del tipo di entità.
• Proprietà della raccolta.
• Enumerazioni.
• Azioni OData.
• Basato sulla stessa base di WCF Data Services, ovvero ODataLib (https://www.nuget.org/packages/microsoft.data.odata).

Per altre informazioni su API Web ASP.NET OData, vedere https://go.microsoft.com/fwlink/?LinkId=271141.

API Web ASP.NET traccia

API Web ASP.NET Traccia integra i dati di traccia dalle API Web con .NET Tracing. È ora abilitato per impostazione predefinita nel modello di progetto API Web. I dati di traccia per le API Web vengono inviati alla finestra output e vengono resi disponibili tramite IntelliTrace. API Web ASP.NET Traccia consente di tracciare le informazioni sull'API Web ospitata in Windows Azure tramite l'integrazione con Windows Diagnostica di Azure. È anche possibile installare e abilitare API Web ASP.NET Traccia in qualsiasi applicazione usando il pacchetto NuGet di traccia API Web ASP.NET (https://www.nuget.org/packages/microsoft.aspnet.webapi.tracing).

Per altre informazioni sulla configurazione e sull'uso di API Web ASP.NET Traccia vedere https://go.microsoft.com/fwlink/?LinkID=269874.

Pagina della Guida API Web ASP.NET

La pagina della Guida API Web ASP.NET è ora inclusa per impostazione predefinita nel modello di progetto API Web. La pagina della Guida di API Web ASP.NET genera automaticamente la documentazione per le API Web, inclusi gli endpoint HTTP, i metodi HTTP supportati, i parametri e i payload dei messaggi di richiesta e risposta di esempio. La documentazione viene automaticamente estratta dai commenti nel codice. È anche possibile aggiungere la pagina della Guida API Web ASP.NET a qualsiasi applicazione usando il pacchetto NuGet della pagina della Guida API Web ASP.NET (https://www.nuget.org/packages/microsoft.aspnet.webapi.helppage).

Per altre informazioni sulla configurazione e la personalizzazione della pagina della Guida di API Web ASP.NET vedere https://go.microsoft.com/fwlink/?LinkId=271140.

ASP.NET SignalR

ASP.NET SignalR semplifica l'aggiunta di funzionalità Web in tempo reale all'applicazione ASP.NET, usando WebSocket se disponibile e torna automaticamente ad altre tecniche quando non è disponibile.

Per altre informazioni sull'uso di ASP.NET SignalR, vedere https://go.microsoft.com/fwlink/?LinkId=271271.

URL brevi di ASP.NET

ASP.NET FriendlyURLs rende molto facile per gli sviluppatori di moduli Web generare URL più puliti(senza estensione aspx). Non è necessaria alcuna configurazione e può essere usata con applicazioni ASP.NET v4.0 esistenti. La funzionalità FriendlyURLs semplifica anche gli sviluppatori ad aggiungere supporto per dispositivi mobili alle applicazioni, supportando il passaggio tra le visualizzazioni desktop e per dispositivi mobili.

Per altre informazioni sull'installazione e l'uso di URL descrittivi ASP.NET vedere http://www.hanselman.com/blog/IntroducingASPNETFriendlyUrlsCleanerURLsEasierRoutingAndMobileViewsForASPNETWebForms.aspx.

Problemi noti e modifiche di rilievo

Questa sezione descrive i problemi noti e le modifiche che si verificano nella versione ASP.NET and Web Tools 2012.2.

Problemi di installazione

Installazioni non ordinate di Visual Studio 2012

L'installazione di uno SKU aggiuntivo di Visual Studio 2012 dopo l'installazione del ASP.NET and Web Tools 2012.2 richiederà un'operazione di ripristino. Considerare la sequenza seguente:

1. Installare Visual Studio 2012 Express per Web
2. Installare ASP.NET and Web Tools 2012.2
3. Installare Visual Studio 2012 Professional, Premium o Ultimate

Il passaggio 2 comporta solo l'installazione degli aggiornamenti per Express for Web. Per assicurarsi che lo SKU aggiuntivo installato durante il passaggio 3 contenga l'aggiornamento necessario per ripristinare il ASP.NET and Web Tools 2012.2 per installare gli aggiornamenti per l'ultimo SKU installato. Questo vale anche se gli SKU nel passaggio 1 e 3 vengono invertito.

Installazione di Microsoft ASP.NET and Web Tools 2012.2 quando Visual Studio è aperto

Se VS è aperto durante l'installazione di Microsoft ASP.NET and Web Tools 2012.2, Visual Studio potrebbe terminare in uno stato non valido. È consigliabile chiudere tutte le istanze di Visual Studio prima di procedere con l'installazione.

Annullamento dell'installazione ASP.NET and Web Tools 2012.2 al centro dell'installazione

L'annullamento dell'installazione ASP.NET and Web Tools 2012.2 al centro dell'installazione lascerà Visual Studio in uno stato non valido. Per risolvere questo problema, seguire questa procedura:

• Andare a Installazione applicazioni.
• Disinstallare Microsoft ASP.NET and Web Tools 2012.2, se presente.
• Reinstallare Microsoft ASP.NET and Web Tools 2012.2

Dopo aver disinstallato ASP.NET and Web Tools 2012.2 i modelli ASP.NET MVC 4 e i modelli di sito Web Razor v2 mancano

La disinstallazione di ASP.NET and Web Tools 2012.2 disinstalla anche tutti i modelli ASP.NET di sito Web MVC 4 e Razor v2 da Visual Studio 2012.

La soluzione alternativa consiste nel ripristinare l'installazione di Visual Studio 2012 per reinstallare ASP.NET modelli di sito Web MVC 4 e Razor v2.

Problemi di strumenti

Errore NuGet segnalato durante la creazione del progetto

Dopo aver installato ASP.NET and Web Tools 2012.2, è possibile che venga visualizzato l'errore seguente durante la creazione di un progetto MVC 4

Il ASP.NET and Web Tools 2012.2 viene fornito NuGet 2.1 e aggiornerà l'estensione in Visual Studio 2012. In alcuni casi, il programma di installazione VSIX non riuscirà ad aggiornare correttamente VSIX. La procedura seguente consente di risolvere questo problema:

1. Avviare Visual Studio 2012 come amministratore

2. Passare a Estensioni strumenti> e Aggiornamenti e disinstallare NuGet.

3. Chiudere Visual Studio

4. Passare alla cartella di installazione ASP.NET and Web Tools 2012.2:

   1. Per Visual Studio 2012: Programmi\Microsoft ASP.NET\ASP.NET Web Stack\Visual Studio 2012
   2. Per Visual Studio 2012 Express for Web: Programmi\Microsoft ASP.NET\ASP.NET Web Stack\Visual Studio Express 2012 per Web

5. Fare doppio clic su NuGet.Tools.vsix per reinstallare NuGet

Problemi relativi all'API Web

Analisi dei problemi nei valori letterali $filter e DateTime

Il parser URI OData non riesce a analizzare correttamente i valori letterali datetime parziali. Ad esempio, $filter=start eq datetime'2012-12-31T12:00' non riesce a analizzare correttamente. Una soluzione alternativa consiste nell'usare il valore letterale completo, $filter=start eq datetime'2012-12-31T12:00:00'.

OData non supporta nomi di proprietà senza distinzione tra maiuscole e minuscole.

OData non supporta i nomi delle proprietà senza distinzione tra maiuscole e minuscole nelle query OData e nel percorso odata.

Se gli utenti hanno maiuscole e minuscole diverse sul lato client javascript e sul lato server, probabilmente si verifica questo problema. Questo problema è per progettazione nel protocollo odata. Tuttavia, molti utenti segnalano questo problema. Per risolverlo, gli utenti devono correggere i loro casi in URL.

Le convenzioni di routing OData predefinite non supportano POST/PUT nella proprietà di spostamento.

Le convenzioni di routing OData predefinite non supportano POST/PUT nella proprietà di spostamento. Manca questa convenzione comunemente usata nelle convenzioni predefinite.

Per aggirarlo, gli utenti devono estendere la nuova convenzione di routing per supportarla.

Problemi relativi ai modelli di Facebook

Il modello di applicazione Facebook funziona solo con .NET 4.5

È necessario selezionare .NET 4.5 nell'elenco a discesa framework nella finestra di dialogo Nuovo progetto per visualizzare il modello di applicazione Facebook in ASP.NET MVC 4.

Controller di aggiornamento in tempo reale

Il modello di applicazione Facebook consente all'utente di creare facilmente un controller API Web per gestire gli aggiornamenti in tempo reale da Facebook. Se il computer di sviluppo è dietro NAT, il controller potrebbe non funzionare senza ulteriori configurazioni di rete. Per informazioni dettagliate, vedere qui: http://facebook.stackoverflow.com/questions/5259467/can-a-computer-behind-a-nat-router-receive-realtime-updates-from-facebook

I valori della stringa di query sono in conflitto con i parametri OAuth di Facebook

I campi seguenti sono in conflitto con l'URL di richiamo della finestra di dialogo OAuth di Facebook. Non aggiungere valori di stringa di query personalizzati con i nomi seguenti: codice, errore, error_description, error_reason.

Uso di Controllo pagina con il modello di Facebook

Non è possibile usare la funzionalità di Controllo pagina in Visual Studio 2012 durante il debug dell'applicazione Facebook. L'Controllo pagina attualmente non supporta iframe.

Problemi relativi al modello di applicazione a pagina singola

Con l'aggiornamento JQuery 1.9/Knockout 2.2.1, quando si esegue il progetto MVC SPA predefinito, non viene gestito correttamente il nuovo elemento di modifica dell'elemento todo invio dell'evento di stato attivo.

Con l'aggiornamento di JQuery 1.9/Knockout 2.2.1, quando si esegue il progetto MVC SPA predefinito, la modifica del nuovo elemento todo non torna più alla nuova casella di modifica dell'elemento todo dopo aver immesso il nuovo elemento todo nell'elenco todo.

Per fare riferimento http://knockoutjs.com/documentation/hasfocus-binding.htmlalla soluzione alternativa e apportare una correzione simile al codice di esempio seguente:

todo.model.js file
function todolist(data), aggiungere quanto segue:
self.isSelected = ko.observable(false);

function todoList.prototype.addTodo, aggiungere il testo nero seguente:
self.isSelected(true);
self.newTodoTitle("");

File index.cshtml, aggiungere il testo nero seguente:
<form data-bind="submit: addTodo">
<input class="addTodo" type="text" data-bind="value: newTodoTitle, segnaposto: 'Type here to add', blurOnEnter: true, hasfocus: isSelected, event: { blur: addTodo }" />
</modulo>