Notas de versão do ASP.NET and Web Tools 2012.2 (RTW)

Este documento descreve a versão do ASP.NET and Web Tools 2012.2. É uma atualização das Ferramentas da Web do Visual Studio e ASP.NET.

• Notas de instalação

• Documentação

• Suporte

• Requisitos de software

• Novos recursos no ASP.NET and Web Tools 2012.2

  • Ferramentas

  • Publicação na Web

  • Modelos do ASP.NET MVC

  • ASP.NET Web API

  • ASP.NET SignalR

  • URLs amigáveis do ASP.NET

• Problemas conhecidos e alterações interruptivas

Notas de instalação

ASP.NET and Web Tools 2012.2 para Visual Studio 2012 pode ser instalado usando o instalador da Plataforma Web. Esta é uma atualização para o Visual Studio 2012 ou Visual Studio Express 2012 para Web, o que é necessário. Se você não tiver o Visual Studio instalado, Visual Studio Express 2012 para Web será instalado.

Você também pode instalar o ASP.NET and Web Tools 2012.2 manualmente. Você deve ter o Visual Studio 2012 ou Visual Studio Express 2012 para Web instalado. Em seguida, use as seguintes instruções:

1. Baixe ASP.NET e o instalador do Web Frameworks 2012.2 no Centro de Download.
2. Quando solicitado, clique em Executar. Você também pode salvar o arquivo para executá-lo mais tarde.
3. Verifique a versão do Visual Studio que você atualizará. Você pode fazer isso iniciando o Visual Studio que deseja atualizar. Em seguida, clique no item de menu Ajuda.
   
4. Se você vir o item de menu "Sobre o Microsoft Visual Studio 2012 para Web", baixe As Ferramentas para Desenvolvedores da Web 2012.2 – Visual Studio Express 2012 para Web. Caso contrário, baixe o Web Developer Tools 2012.2 – Visual Studio 2012.
5. Quando solicitado, clique em Executar. Você também pode salvar o arquivo para executá-lo mais tarde.

Observação

ASP.NET and Web Tools versão 2012.2 não inclui SQL Server Data Tools. SQL Server e Bancos de Dados do Windows SQL do Azure fornece um conjunto mais avançado de ferramentas de banco de dados, incluindo desenvolvimento com suporte de projeto offline, comparação de esquemas e recursos avançados de implantação de banco de dados. Para obter mais informações ou instalar SQL Server Data Tools visite https://go.microsoft.com/fwlink/?LinkID=237127.

Documentação

Tutoriais e outras informações sobre ASP.NET and Web Tools 2012.2 estão disponíveis no ASP.NET site ( https://www.asp.net).

Suporte

ASP.NET and Web Tools 2012.2 é oficialmente lançado e tem suporte. Você pode usar seu canal de suporte normal. Você também pode postar perguntas nos fóruns do ASP.NET (https://forums.asp.net/), em que os membros da comunidade ASP.NET frequentemente podem fornecer suporte informal.

Requisitos de software

O ASP.NET and Web Tools 2012.2 requer o Visual Studio 2012 ou o Visual Studio Express 2012 para Web.

Novos recursos no ASP.NET and Web Tools 2012.2

Esta seção descreve os recursos que foram introduzidos na versão ASP.NET and Web Tools 2012.2.

Ferramentas

• Inspetor de Página

  • Suporte ao mapeamento de seleção de JavaScript, permitindo que Inspetor de Página mapeiem itens que foram adicionados dinamicamente à página de volta ao código JavaScript correspondente.
  • A capacidade de ver atualizações de CSS em tempo real.
  • Para obter mais informações, leia Sincronização Automática do CSS e Mapeamento de Seleção de JavaScript no Inspetor de Página.

• Editor

  • Suporte ao realce de sintaxe para CoffeeScript, Mustache, Handlebars e JsRender.
  • O editor de HTML fornece o IntelliSense para associações knockout.
  • Menos suporte à edição e ao compilador para habilitar a criação de CSS dinâmico usando LESS.
  • Cole JSON como uma classe .NET. Usando esse comando Special Paste para colar JSON em um arquivo de código C# ou VB.NET, e o Visual Studio gerará automaticamente classes .NET inferidas do JSON.

• O suporte ao Emulador Móvel adiciona ganchos de extensibilidade para que emuladores de terceiros possam ser instalados como um VSIX. Os emuladores instalados aparecerão na lista suspensa F5, para que os desenvolvedores possam visualizar seus sites em uma variedade de dispositivos móveis. Leia mais sobre esse recurso na entrada do blog de Scott Hanselman sobre a nova integração do BrowserStack com o Visual Studio.

Publicação na Web

• Os projetos de site agora têm a mesma experiência de publicação que os projetos de Aplicativo Web, incluindo a publicação em sites do Windows Azure.

• Publicação seletiva – para um ou mais arquivos, você pode executar as seguintes ações (depois de publicar em um ponto de extremidade de Implantação da Web):

  • Publicar arquivos selecionados.
  • Veja a diferença entre um arquivo local e um arquivo remoto.
  • Atualize o arquivo local com o arquivo remoto ou atualize o arquivo remoto com o arquivo local.

Modelos do ASP.NET MVC

• O novo modelo de aplicativo do Facebook facilita a gravação de aplicativos Canvas do Facebook. Em alguns passos simples, é possível criar um aplicativo do Facebook que obtém dados de um usuário conectado e se integra com os amigos. O modelo inclui uma nova biblioteca para tratar de todo o encanamento envolvido na criação de um aplicativo do Facebook, incluindo autenticação, permissões, acesso aos dados do Facebook, entre outros. Para obter mais informações sobre como usar o modelo de Aplicativo do Facebook, consulte https://go.microsoft.com/fwlink/?LinkID=269921.
• Um novo modelo MVC de aplicativo de página única permite aos desenvolvedores criar aplicativos da Web interativos de cliente usando HTML 5, CSS 3 e as bibliotecas populares Knockout e jQuery JavaScript, na parte superior do ASP.NET Web API. O modelo inclui um aplicativo de lista "todo" que demonstra práticas comuns para criar um aplicativo HTML5 JavaScript que usa uma API de servidor RESTful. Você pode ler mais em https://www.asp.net/single-page-application.
• Agora você pode criar um VSIX que adiciona novos modelos à caixa de diálogo ASP.NET Novo Projeto do MVC. Saiba como aqui: https://go.microsoft.com/fwlink/?LinkId=275019
• Pacote FixedDisplayModes – os modelos de projeto MVC foram atualizados para incluir o novo pacote NuGet 'FixedDisplayModes', que contém uma solução alternativa para um bug no MVC 4. Para obter mais informações sobre a correção contida no pacote, consulte esta postagem no blog (/archive/blogs/rickandy/asp-net-mvc-4-mobile-caching-bug-fixed) da equipe do MVC.

ASP.NET Web API

ASP.NET Web API foi aprimorado com vários novos recursos:

• ASP.NET Web API OData
• Rastreamento de ASP.NET Web API
• Página de Ajuda do ASP.NET Web API

ASP.NET Web API OData

ASP.NET Web API OData oferece a flexibilidade necessária para criar pontos de extremidade OData com lógica de negócios avançada em qualquer fonte de dados. Com ASP.NET Web API OData, você controla a quantidade de semântica OData que deseja expor. ASP.NET Web API OData está incluído nos modelos de projeto do ASP.NET MVC 4 e também está disponível no NuGet (https://www.nuget.org/packages/microsoft.aspnet.webapi.odata).

ASP.NET Web API OData atualmente dá suporte aos seguintes recursos:

• Habilite a semântica de consulta OData aplicando o atributo [Queryable].
• Valide facilmente as consultas OData e restrinja o conjunto de opções de consulta, operadores e funções com suporte.
• Associação de parâmetro a ODataQueryOptions diretamente para obter uma representação de árvore de sintaxe abstrata da consulta que pode ser validada e aplicada a um IQueryable ou IEnumerable.
• Habilite a paginação controlada pelo serviço e a geração de link da próxima página especificando limites de resultados no atributo [Queryable].
• Solicite uma contagem embutida do número total de recursos correspondentes usando $inlinecount.
• Controlar a propagação nula.
• Operadores Any/All no $filter.
• Inferir um modelo de dados de entidade por convenção ou personalizar explicitamente um modelo de maneira semelhante ao Entity Framework Code-First.
• Exponha conjuntos de entidades derivando de EntitySetController.
• Convenções simples e personalizáveis para expor propriedades de navegação, manipular links e implementar ações OData.
• Roteamento simplificado usando o método de extensão MapODataRoute.
• Suporte para controle de versão expondo vários modelos de EDM.
• Exponha o documento de serviço e $metadata para que você possa gerar clientes (.NET, Windows Phone, Windows Store etc.) para sua API Web.
• Suporte para os formatos detalhados OData Atom, JSON e JSON.
• Criar, atualizar, atualizar parcialmente (PATCH) e excluir entidades.
• Consultar e manipular relações entre entidades.
• Crie links de relacionamento que se conectem às suas rotas.
• Tipos complexos.
• Herança de tipo de entidade.
• Propriedades da coleção.
• Enums.
• Ações OData.
• Criado com base na mesma base que WCF Data Services, ou seja, ODataLib (https://www.nuget.org/packages/microsoft.data.odata).

Para obter mais informações sobre ASP.NET Web API OData, consulte https://go.microsoft.com/fwlink/?LinkId=271141.

Rastreamento de ASP.NET Web API

ASP.NET Web API Rastreamento integra dados de rastreamento de suas APIs Web ao Rastreamento do .NET. Agora ele está habilitado por padrão no modelo de projeto da API Web. Os dados de rastreamento para suas APIs Web são enviados para a janela Saída e disponibilizados por meio do IntelliTrace. ASP.NET Web API Rastreamento permite rastrear informações sobre sua API Web quando hospedada no Windows Azure por meio da integração com o Windows Diagnóstico do Azure. Você também pode instalar e habilitar ASP.NET Web API Rastreamento em qualquer aplicativo usando o pacote NuGet de Rastreamento de ASP.NET Web API (https://www.nuget.org/packages/microsoft.aspnet.webapi.tracing).

Para obter mais informações sobre como configurar e usar ASP.NET Web API Rastreamento, consulte https://go.microsoft.com/fwlink/?LinkID=269874.

Página de Ajuda do ASP.NET Web API

A Página de Ajuda do ASP.NET Web API agora está incluída por padrão no modelo de projeto da API Web. A Página de Ajuda do ASP.NET Web API gera automaticamente a documentação para APIs Web, incluindo os pontos de extremidade HTTP, os métodos HTTP com suporte, parâmetros e conteúdos de mensagens de solicitação e resposta de exemplo. A documentação é extraída automaticamente dos comentários em seu código. Você também pode adicionar a Página de Ajuda do ASP.NET Web API a qualquer aplicativo usando o pacote NuGet da Página de Ajuda do ASP.NET Web API (https://www.nuget.org/packages/microsoft.aspnet.webapi.helppage).

Para obter mais informações sobre como configurar e personalizar o ASP.NET Web API Página de Ajuda, consulte https://go.microsoft.com/fwlink/?LinkId=271140.

ASP.NET SignalR

ASP.NET SignalR simplifica a adição de recursos da Web em tempo real ao seu aplicativo ASP.NET, usando WebSockets se disponível e automaticamente voltando a outras técnicas quando não estiver.

Para obter mais informações sobre como usar ASP.NET SignalR, consulte https://go.microsoft.com/fwlink/?LinkId=271271.

URLs amigáveis do ASP.NET

ASP.NET FriendlyURLs torna muito fácil para os desenvolvedores de web forms gerar URLs mais limpas (sem a extensão .aspx). Ele requer pouca ou nenhuma configuração e pode ser usado com aplicativos ASP.NET v4.0 existentes. O recurso FriendlyURLs também torna mais fácil para os desenvolvedores adicionar suporte móvel a seus aplicativos, dando suporte à alternância entre modos de exibição da área de trabalho e móveis.

Para obter mais informações sobre como instalar e usar ASP.NET URLs amigáveis, consulte http://www.hanselman.com/blog/IntroducingASPNETFriendlyUrlsCleanerURLsEasierRoutingAndMobileViewsForASPNETWebForms.aspx.

Problemas conhecidos e alterações interruptivas

Esta seção descreve problemas conhecidos e alterações interruptivas que estão na versão ASP.NET and Web Tools 2012.2.

Problemas de instalação

Instalações fora de ordem do Visual Studio 2012

Instalar um SKU adicional do Visual Studio 2012 depois de instalar o ASP.NET and Web Tools 2012.2 exigirá uma operação de reparo. Considere a sequência a seguir:

1. Instalar o Visual Studio 2012 Express para Web
2. Instalar o ASP.NET and Web Tools 2012.2
3. Instalar o Visual Studio 2012 Professional, Premium ou Ultimate

A etapa 2 resultaria apenas na instalação de atualizações do Express para Web. Para garantir que o SKU adicional instalado durante a etapa 3 contenha a atualização, você precisará reparar o ASP.NET and Web Tools 2012.2 para instalar as atualizações do último SKU instalado. Isso também se aplica se as SKUs nas Etapas 1 e 3 forem invertidas.

Instalando o Microsoft ASP.NET and Web Tools 2012.2 quando o Visual Studio está aberto

Se o VS estiver aberto durante a instalação do Microsoft ASP.NET and Web Tools 2012.2, o Visual Studio poderá acabar em um estado inválido. É recomendável que os usuários fechem todas as instâncias do Visual Studio antes de prosseguir com a instalação.

Cancelando a instalação do ASP.NET and Web Tools 2012.2 no meio da instalação

O cancelamento ASP.NET and Web Tools instalação do 2012.2 no meio da instalação deixará o Visual Studio em um estado inválido. Para resolver esse problema, siga estas etapas:

• Vá para Adicionar ou Remover Programas
• Desinstale Microsoft ASP.NET and Web Tools 2012.2, se presente.
• Reinstalar Microsoft ASP.NET and Web Tools 2012.2

Depois de desinstalar o ASP.NET and Web Tools 2012.2, os modelos do ASP.NET MVC 4 e os modelos de Site do Razor v2 estão ausentes

A desinstalação do ASP.NET and Web Tools 2012.2 também desinstalará todos os modelos de site do ASP.NET MVC 4 e Razor v2 do Visual Studio 2012.

A solução alternativa é reparar a instalação do Visual Studio 2012 para reinstalar ASP.NET modelos de site MVC 4 e Razor v2.

Problemas de ferramentas

Erro do NuGet relatado durante a criação do projeto

Depois de instalar o ASP.NET and Web Tools 2012.2, você poderá ver o seguinte erro ao criar um projeto MVC 4

O ASP.NET and Web Tools 2012.2 é fornecido pelo NuGet 2.1 e atualizará a extensão no Visual Studio 2012. Em alguns casos, o instalador do VSIX não atualizará corretamente o VSIX. As etapas a seguir permitirão que você resolva esse problema:

1. Iniciar o Visual Studio 2012 como administrador

2. Acesse Ferramentas-Extensões> e Atualizações e desinstale o NuGet.

3. Fechar o Visual Studio

4. Navegue até a pasta de instalação do ASP.NET and Web Tools 2012.2:

   1. Para o Visual Studio 2012: Arquivos de Programas\Microsoft ASP.NET\ASP.NET Web Stack\Visual Studio 2012
   2. Para o Visual Studio 2012 Express para Web: Arquivos de Programas\Microsoft ASP.NET\ASP.NET Web Stack\Visual Studio Express 2012 para Web

5. Clique duas vezes no NuGet.Tools.vsix para reinstalar o NuGet

Problemas de API Web

Analisando problemas nos literais $filter e DateTime

O analisador de URI OData não consegue analisar literais parciais de datetime corretamente. Por exemplo, $filter=start eq datetime'2012-12-31T12:00' falha ao analisar corretamente. Uma solução alternativa é usar o literal completo, $filter=start eq datetime'2012-12-31T12:00:00'.

O OData não dá suporte a nomes de propriedade que não diferenciam maiúsculas de minúsculas.

O OData não dá suporte a nomes de propriedade que não diferenciam maiúsculas de minúsculas em consultas OData e caminho odata.

Se os usuários tiverem maiúsculas e minúsculas diferentes no lado do cliente javascript e no lado do servidor, eles provavelmente encontrarão esse problema. Esse problema é por design no protocolo odata. No entanto, muitos usuários relatam esse problema. Para contornar isso, os usuários precisam corrigir seus casos na URL.

As convenções de roteamento OData padrão não dão suporte a POST/PUT na propriedade de navegação.

As convenções de roteamento OData padrão não dão suporte a POST/PUT na propriedade de navegação. Estamos perdendo essa convenção comumente usada em convenções padrão.

Para contornar isso, os usuários precisam estender a nova convenção de roteamento para dar suporte a ela.

Problemas de modelo do Facebook

O modelo de Aplicativo do Facebook só funciona usando o .NET 4.5

Você deve selecionar .NET 4.5 na lista suspensa da estrutura na caixa de diálogo Novo Projeto para ver o modelo de Aplicativo do Facebook no ASP.NET MVC 4.

Controlador de atualização em tempo real

O modelo de Aplicativo do Facebook permite que o usuário crie facilmente um Controlador de API Web para lidar com atualizações em tempo real do Facebook. Se o computador de desenvolvimento estiver atrás do NAT, o Controlador poderá não funcionar sem configuração de rede adicional. Consulte aqui para obter detalhes: http://facebook.stackoverflow.com/questions/5259467/can-a-computer-behind-a-nat-router-receive-realtime-updates-from-facebook

Os valores da cadeia de caracteres de consulta entram em conflito com os parâmetros OAuth do Facebook

Os campos a seguir entram em conflito com a URL de back de chamada da caixa de diálogo OAuth do Facebook. Não adicione seus próprios valores de cadeia de caracteres de consulta com os seguintes nomes: código, erro, error_description error_reason.

Usando Inspetor de Página com o Modelo do Facebook

Você não pode usar o recurso Inspetor de Página no Visual Studio 2012 ao depurar seu aplicativo do Facebook. No momento, o Inspetor de Página não dá suporte a iframes.

Problemas de modelo de aplicativo de página única

Com a atualização do JQuery 1.9/Knockout 2.2.1, ao executar o projeto padrão do SPA do MVC, o novo evento de edição de edição de item de tarefas pendentes não é tratado corretamente.

Com a atualização do JQuery 1.9/Knockout 2.2.1, ao executar o projeto padrão do SPA do MVC, a nova edição de item todo não entra mais em foco novamente na nova caixa de edição de item todo depois de inserir o novo item todo na lista de tarefas pendentes.

Para fazer uma referência http://knockoutjs.com/documentation/hasfocus-binding.htmlalternativa e fazer uma correção semelhante ao seguinte código de exemplo:

todo.model.js de arquivo
function todolist(data), adicione o seguinte:
self.isSelected = ko.observable(false);

function todoList.prototype.addTodo, adicione o seguinte texto preto:
self.isSelected(true);
self.newTodoTitle("");

File index.cshtml, add the following blacked text:
<form data-bind="submit: addTodo">
<input class="addTodo" type="text" data-bind="value: newTodoTitle, placeholder: 'Type here to add', blurOnEnter: true, hasfocus: isSelected, event: { blur: addTodo }" />
</Forma>