Bibliotecas de classe portátil

  • Artigo

O projeto deBiblioteca de classes portátil permite que você escrever e compilar assemblies gerenciados que funcionam em mais de uma.NET Framework plataforma. Você pode criar classes que contêm o código que você deseja compartilhar entre vários projetos, como, por exemplo, a lógica de negócios compartilhados, e então consultar essas classes de diferentes tipos de projetos.

Usando o projeto deBiblioteca de classes portátil , você pode criar assemblies portátil que funcionam sem modificação.NET Framework, Silverlight, o Windows 7 do telefone ou plataformas XNA (Xbox). Sem o Biblioteca de classes portátil o projeto, você deve ser uma única plataforma de destino e, em seguida, manualmente retrabalho a biblioteca de classes para outras plataformas. O Biblioteca de classes portátil projeto suporta um subconjunto de assemblies nessas plataformas e fornece um modelo de Visual Studio, que torna possível criar assemblies executados sem modificação nessas plataformas.

Pré-requisitos

Para criar um Biblioteca de classes portátil o projeto, você deve instalar esses componentes na seguinte ordem:

  1. 2010 Service Pack 1 (SP1) Visual Studio

  2. Ferramentas de biblioteca portátil

Conjuntos de Módulos (Assemblies)

Os assemblies a seguir estão disponíveis dentro de um Biblioteca de classes portátil projeto:

  • mscorlib. dll

  • System.dll

  • System.Core.dll

  • System.XML.dll

  • System.ComponentModel.Composition.dll

  • System.NET.dll

  • System

  • System.ServiceModel.dll

  • System.XML.Serialization.dll

  • System.Windows.dll (a partir do Silverlight)

No entanto, nem todos esses assemblies são suportados em todas as plataformas. Em um Biblioteca de classes portátil o projeto, especifique as plataformas de destino e somente os assemblies com suporte para essas plataformas são referenciados no projeto. Se você tentar fazer referência a um assembly que não há suporte para as plataformas de destino, Visual Studio avisa a incompatibilidade. Os assemblies de núcleo (mscorlib. dll, System. dll, System.Core.dll e System.Xml.dll) são suportados em todas as plataformas.

A tabela a seguir mostra quais assemblies são compatíveis com as plataformas disponíveis.

Característica

Conjuntos de Módulos (Assemblies)

.NET Framework 4

Silverlight

Telefone do Windows 7

XNA (Xbox)

Núcleo

mscorlib. dll, System. dll, System.Core.dll, System.Xml.dll

Sim

Sim

Sim

Sim

Estrutura de extensibilidade gerenciada (MEF)

System.ComponentModel.Composition.dll

Sim

Sim

Não

Não

Biblioteca de classes de rede (NCL)

System.NET.dll

Sim

Sim

Sim

Não

Série

System

Sim

Sim

Sim

Não

Windows Communication Foundation (WCF)

System.ServiceModel.dll

Sim

Sim

Sim

Não

Serialização em XML

System.XML.Serialization.dll

Sim

Sim

Sim

Não

O suporte ao modelo de exibição

System.Windows.dll

Não

Sim

Sim

Não

Biblioteca de classes portátilprojetos de uma combinação de plataformas de destino. A tabela a seguir mostra os recursos que têm suporte para combinações de plataforma.

Plataformas

Suporte

Silverlight e o telefone do Windows 7

Tudo exceto MEF

.NET Framework 4 e o Silverlight

Tudo exceto o suporte ao modelo de exibição

.NET Framework 4 e o telefone do Windows 7

Tudo exceto MEF e suporte ao modelo de exibição

.NET Framework 4, o Silverlight e o telefone do Windows 7

Tudo exceto MEF e suporte ao modelo de exibição

O XNA e qualquer outra plataforma.

Somente o Core

Localizando os membros com suporte na documentação de referência

Você pode encontrar os membros que são suportados pelo Biblioteca de classes portátil o projeto nos tópicos de referência para o .NET Framework Class Library. Na tabela de membros de uma classe, o seguinte Biblioteca de classes portátil ícone aparecer próximo ao suporte para membros.

Suporte portátil Library

Você também pode examinar o Informações sobre a versão seção de um tópico de referência para uma anotação indicando que um tipo ou membro é suportado no Biblioteca de classes portátil project.

Criando um Biblioteca de classes portátil projeto

Para criar um Biblioteca de classes portátil projeto, crie um novo projeto em 2010 de Visual Studio e selecione o Biblioteca de classe portátil modelo sob Visual C# ou Visual Basic. Se você não vir o modelo, certifique-se de que você tenha instalado o Ferramentas de biblioteca portátil.

Selecione a biblioteca portátil <>>projeto

Selecionando as plataformas de destino

Por padrão, o Biblioteca de classes portátil projeto destina-se as seguintes plataformas:

  • .NET Framework 4

  • Silverlight 4

  • Silverlight para o telefone do Windows 7

O projeto faz referência apenas os assemblies que são suportados nessas plataformas. Para selecionar as plataformas de destino, Solution Explorer, com o botão direito do Biblioteca de classes portátil nome do projeto e selecione Propriedades.

A página de propriedades do projeto especifica as plataformas que atualmente são o alvo.

Propriedades do projeto

Para adicionar ou remover as plataformas de destino, clique em alteração.

Alterar <>>alvo

Quando você altera as plataformas de destino, os assemblies referenciados no projeto serão alterado para coincidir com o conjunto de módulos (assemblies) que são suportados para sua seleção. Se o seu projeto faz referência a assemblies não são suportados por uma das plataformas selecionadas, você deve remover a referência ao assembly ou alterar as plataformas de destino. No Solution Explorer, os assemblies que não são suportados são marcados com um ponto de exclamação (!). A ilustração a seguir mostra um aviso para assemblies não são suportados quando o XNA Framework é adicionado às plataformas de destino.

Aviso

Usando oBiblioteca de classes portátil

Depois de criar seu Biblioteca de classes portátil de projeto, basta adicionar uma referência a ele partir de outros projetos que dependem do Biblioteca de classes portátil project. Você pode referenciar o projeto ou a conjuntos específicos que contêm as classes que você deseja acessar.

Criando uma dependência.

Para executar um Biblioteca de classes portátil aplicativo, uma atualização para o.NET Framework 4 deve ser instalado na máquina. Esta atualização é instalada automaticamente com o SP1 de 2010 Visual Studio, para que você possa executar o Biblioteca de classes portátil o aplicativo sem modificações adicionais no computador que você usou para desenvolver o aplicativo. Para executar o aplicativo em um computador diferente, você pode instalar o atualização manualmente.

Quando você implanta um.NET Framework 4 os aplicativos que referenciem um Biblioteca de classes portátil assembly, você deve especificar uma dependência na.NET Framework 4 update. Ao especificar essa dependência, verifique se a atualização é instalada com o seu aplicativo. Para criar uma dependência no Solution Explorer, clique no nó do projeto para o projeto que você deseja publicar. (Esse é o projeto que faz referência a Biblioteca de classes portátil projeto.) Sobre o projeto menu, clique em Propriedadese, em seguida, clique no Publicar guia. Sobre o Publicar página, clique em pré-requisitos. Selecione o.NET Framework 4 atualização como um pré-requisito.

Implantando com o Silverlight

Quando você implanta um Biblioteca de classes portátil o assembly com um aplicativo do Silverlight, você deve garantir que a versão mínima do tempo de execução necessária para o aplicativo estiver definido como a versão 4.0.60129.0 ou posterior. Você pode definir o minRuntimeVersion , incluindo o valor do parâmetro <param name="minRuntimeVersion" value="4.0.60129.0" /> a página da Web que hospeda o aplicativo baseado no Silverlight.

<div id="silverlightControlHost">
    <object data="data:application/x-silverlight-2," 
           type="application/x-silverlight-2" width="100%" height="100%">
    <param name="source" value="ClientBin/SilverlightApplication.xap"/>
    <param name="onError" value="onSilverlightError" />
    <param name="background" value="white" />
    <param name="minRuntimeVersion" value="4.0.60129.0" />
    <param name="autoUpgrade" value="true" />
    <a href="https://go.microsoft.com/fwlink/?LinkID=149156&v=4.0.50826.0" 
             style="text-decoration:none">
      <img src=https://go.microsoft.com/fwlink/?LinkId=161376
             alt="Get Microsoft Silverlight" style="border-style:none"/>
    </a>
  </object>
   <iframe id="_sl_historyFrame" 
              style="visibility:hidden;height:0px;width:0px;border:0px">
   </iframe>
</div>

API de diferenças aBiblioteca de classes portátil

Para fazer Biblioteca de classes portátil assemblies compatíveis com todas as plataformas suportadas, alguns membros foram ligeiramente alterados da Biblioteca de classes portátil. Para obter detalhes sobre os membros que foram alterados e como eles foram alterados, consulte Diferenças de API na biblioteca de classe portátil.

Consulte também

Outros recursos

Diferenças de API na biblioteca de classe portátil

Histórico de alterações

Date

History

Motivo

Março de 2011

Tópico adicional.

Aprimoramento de informações.