COMO: Criar e usar um assembly de metadados

Traduções deste artigo Traduções deste artigo
ID do artigo: 323491 - Exibir os produtos aos quais esse artigo se aplica.
Expandir tudo | Recolher tudo

Neste artigo

Sumário

Este artigo passo a passo descreve quais metadados são assemblies e em quais cenários você pode usá-los. Este artigo também explica como usar a ferramenta Soapsuds com o sinalizador nowrappedproxy para gerar um conjunto de dados meta.

Requisitos

A lista a seguir descreve o hardware recomendado, software, infra-estrutura de rede e service packs que você precisa:
  • O Visual Studio .NET
  • Microsoft Internet Information Services (IIS)
Este artigo pressupõe que você esteja familiarizado com os seguintes tópicos:
  • O Visual Studio .NET
  • Microsoft .NET framework
  • Microsoft .NET remoting

O que são conjuntos de dados de Meta?

Assemblies de dados de Meta são assemblies do .NET Framework que contêm somente informações meta de dados e o tipo. Conjuntos de dados de Meta são semelhantes às bibliotecas de tipos COM mas meta dados assemblies não contêm qualquer código de implementação.

Juntamente com um aplicativo cliente distribuído, você pode implantar conjuntos de dados de meta que contém informações suficientes para esse aplicativo cliente criar um proxy remoto e usar esse proxy remoto para chamar métodos no assembly real, que pode residir em um computador diferente.

O guia a seguir demonstra como gerar um conjunto de dados meta de um componente simples baseado em. NET.

Criar um simples .NET Framework Component

  1. No Visual Studio. NET, no menu arquivo , clique em novo e, em seguida, clique em Project . Em Project Types , clique em projetos translation from VPE for Csharp Visual . Em modelos , clique em Class Library .
  2. Altere o nome para MyRemoteComp e, em seguida, clique em OK .

    O projeto de biblioteca de classe é criado. Classe Class1 no namespace MyRemoteComp é criado no Class1.cs por padrão.
  3. Copiar e colar o código a seguir em Class1 :
    public string SayHello(string sName)
    {
        return "Hi, " + sName;		
    }
    					
  4. No menu Build , clique em Build Solution para criar a biblioteca de classes. O assembly é denominado MyRemoteComp.dll.

Usar a ferramenta Soapsuds para gerar o conjunto de dados de Meta

Esta seção explica como usar a ferramenta Soapsuds (Soapsuds.exe) e é nowrappedproxy sinalizador para criar o conjunto de dados de meta. O arquivo de assembly simples que você criou nas etapas anteriores é usado como entrada:
  1. No menu Iniciar , aponte para programas , clique em Microsoft Visual Studio. NET , clique em Visual Studio .NET Tools e clique em Visual Studio .NET Command Prompt .
  2. No Visual Studio .NET prompt de comando, mude para o diretório onde você criou seu assembly de biblioteca de classe simples. Por padrão, o assembly está no diretório \bin\debug do project. Digite o comando dir e, em seguida, observe que o assembly chamado MyRemoteComp.dll aparece na lista de arquivos.
  3. Execute a ferramenta Soapsuds contra seu assembly. Para fazer isso, digite o seguinte comando (como uma linha de comando) no Visual Studio .NET prompt de comando:

    soapsuds.exe - inputassemblyfile:myremotecomp
    -outputassemblyfile:myremotecomp.metaonly.dll - nowrappedproxy


    Agora você tem uma segunda .dll assembly chamado Myremotecomp.metaonly.dll. Este é o conjunto de dados de meta.
Você pode usar este conjunto de dados meta no desenvolvimento de cliente remoto e na implantação. Quando você desenvolve o cliente remoto, adicione uma referência a esse conjunto de dados meta em vez de uma referência para o assembly que contém o código de implementação. Se você estiver desenvolvendo no Visual Studio. NET, execute estas etapas para adicionar a referência:
  1. No menu Project , clique em Add Reference .
  2. Clique em Procurar , localize seu conjunto de dados de meta e, em seguida, clique em Abrir .

    Seu conjunto aparece em Componentes selecionados .
  3. Clique em OK .
Agora você pode fazer referência e usar a classe em seu código cliente.

Uso alternativo de - nowrappedproxy

Você pode usar um conjunto de dados meta depois que os clientes também são compilados. Nesse cenário, você deve gerar um arquivo de conjunto de dados de meta que tem o mesmo nome do assembly de entrada original. Para fazer isso, execute a ferramenta Soapsuds digitando o seguinte comando (como uma linha de comando) no Visual Studio .NET prompt de comando:

soapsuds.exe - inputassemblyfile:myremotecomp
-outputassemblyfile:metaonly/myremotecomp.dll - nowrappedproxy


Este comando cria o novo arquivo de conjunto de dados de meta no \bin\debug\metaonly de project no diretório e fornece o novo arquivo de conjunto de dados de meta o mesmo nome que o arquivo de assembly de entrada. É útil dar esse novo arquivo um nome significativo temporariamente, enquanto estiver manipulando o arquivo antes da implantação. Quando você implanta o novo conjunto de dados de meta, altere o nome para o nome original.

Você pode implantar esse novo assembly para clientes remotos que já foram compilados contra o assembly de entrada original. Essa configuração de implantação, quando o aplicativo cliente carrega o assembly, o cliente procura o arquivo de assembly original pelo nome, mas o cliente encontra o conjunto de dados meta com o mesmo nome. O cliente requer somente as meta dados e digite informações contidas no arquivo de assembly para chamar os métodos remotos, portanto, o conjunto de dados meta é suficiente para essa finalidade.

Solução de problemas

  • Quando você executa o comando Soapsuds.exe, verifique se que você não incluir a extensão de nome de arquivo .dll quando você especifica o arquivo de assembly de entrada.
  • Você pode abreviar argumentos Soapsuds.exe, conforme descrito no artigo da MSDN (Microsoft Developer Network) que listados na seção "Referências".
  • Tenha cuidado ao você alterar o nome do arquivo de saída assembly após foi gerado. Como com qualquer assembly do .NET Framework, o nome do arquivo .dll é uma parte dos dados meta. Ocorrerá um erro quando o assembly é carregado se o nome for diferente do nome que aparece nos metadados.

Referências

Para obter mais informações sobre a ferramenta Soapsuds, visite o seguinte site da MSDN:
Soapsuds Tool (Soapsuds.exe)
Para obter informações adicionais, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
323490INFO: Configurar o .NET Remoting, quando o cliente remoto é um aplicativo ASP.NET ou o cliente é outro componente remotos que é hospedado pelo IIS

Propriedades

ID do artigo: 323491 - Última revisão: quinta-feira, 22 de abril de 2004 - Revisão: 3.4
A informação contida neste artigo aplica-se a:
  • Microsoft Visual Studio .NET 2003 Professional Edition
  • Microsoft Visual Studio .NET 2002 Professional Edition
  • Microsoft .NET Framework 1.1
  • Microsoft .NET Framework 1.0
Palavras-chave: 
kbmt kbhowtomaster KB323491 KbMtpt
Tradução automática
IMPORTANTE: Este artigo foi traduzido por um sistema de tradução automática (também designado por Machine Translation ou MT), não tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplicações (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em português a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradução automática não é sempre perfeita, podendo conter erros de vocabulário, sintaxe ou gramática. A Microsoft não é responsável por incoerências, erros ou prejuízos ocorridos em decorrência da utilização dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualizações freqüentes ao software de tradução automática (MT). Obrigado.
Clique aqui para ver a versão em Inglês deste artigo: 323491

Submeter comentários

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com