Cómo: Crear y utilizar un ensamblado de metadatos

Seleccione idioma Seleccione idioma
Id. de artículo: 323491 - Ver los productos a los que se aplica este artículo
Expandir todo | Contraer todo

En esta página

Resumen

Este artículo describe qué metadatos los ensamblados y en qué escenarios puede utilizarlos. También se explica cómo utilizar la herramienta Soapsuds con el indicador nowrappedproxy para generar un ensamblado de datos de metadatos.

Requisitos

En la lista siguiente se describe el hardware, el software, la infraestructura de red y los service pack recomendados que se necesitarán:
  • Visual Studio .NET
  • Servicios de Microsoft Internet Information Server (IIS)
En este artículo se supone que está familiarizado con los temas siguientes:
  • Visual Studio .NET
  • Microsoft .NET framework
  • Microsoft .NET remoting

¿Qué son ensamblados de Meta datos?

Los ensamblados de datos de metadatos son ensamblados de .NET Framework que contienen sólo información de datos y el tipo de metadatos. Ensamblados de Meta datos son similares a bibliotecas de tipos en COM, pero los ensamblados de datos de metadatos no contienen ningún código de implementación.

Junto con una aplicación cliente distribuida, puede implementar los ensamblados de datos de metadatos que contienen suficiente información para esa aplicación de cliente para crear a un proxy remoto y utilizar a ese proxy remoto para invocar métodos en el ensamblado real, que puede residir en un equipo diferente.

La guía siguiente muestra cómo generar un ensamblado de datos de metadatos a partir de un componente sencillo basado en. NET.

Crear un componente de simple de .NET Framework

  1. En Visual Studio. NET, en el menú archivo , haga clic en nuevo y, a continuación, haga clic en proyecto . En Tipos de proyecto , haga clic en Proyectos de Visual C# . En plantillas , haga clic en Biblioteca de clases .
  2. Cambie el nombre a MyRemoteComp y, a continuación, haga clic en Aceptar .

    Se crea el proyecto de biblioteca de clase. se creará Class1 de clase en el espacio de nombres MyRemoteComp en Class1.cs de forma predeterminada.
  3. Copie y pegue el código siguiente en Class1 :
    public string SayHello(string sName)
    {
        return "Hi, " + sName;		
    }
    					
  4. En el menú Generar , haga clic en Generar solución para generar la biblioteca de clase. El ensamblado se denomina MyRemoteComp.dll.

Utilice la herramienta Soapsuds para generar el ensamblado de datos de metadatos

Esta sección explica cómo utilizar la herramienta Soapsuds (Soapsuds.exe) y es indicador de nowrappedproxy para crear el ensamblado de datos de metadatos. El archivo de ensamblado simple que creó en los pasos anteriores se utiliza como entrada:
  1. En el menú Inicio , seleccione programas , haga clic en Visual Studio.NET , haga clic en Herramientas de Visual Studio .NET y a continuación, haga clic en Visual Studio .NET .
  2. En el símbolo del sistema de Visual Studio .NET, cambie al directorio donde se creó el ensamblado de biblioteca de clase simple. De forma predeterminada, el ensamblado es en el directorio \bin\debug del project. Escriba el comando dir y, a continuación, observe que el ensamblado denominado MyRemoteComp.dll aparece en la lista de archivos.
  3. Ejecutar la herramienta Soapsuds contra el ensamblado. Para ello, escriba el comando siguiente (como una línea de comandos) en el símbolo del sistema de Visual Studio .NET:

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


    Ahora tiene un segundo archivo .dll de ensamblado denominado Myremotecomp.metaonly.dll. Esto es el ensamblado de datos de metadatos.
Puede utilizar este ensamblado de datos de metadatos en el desarrollo de cliente remoto y la implementación. Al desarrollar el cliente remoto, agregue una referencia a este ensamblado de datos de metadatos en lugar de una referencia al ensamblado que contiene el código de implementación. Si está desarrollando en Visual Studio. NET, siga estos pasos para agregar la referencia:
  1. En el menú proyecto , haga clic en Agregar referencia .
  2. Haga clic en Examinar , busque el ensamblado de datos de metadatos y, a continuación, haga clic en Abrir .

    El ensamblado aparece bajo Componentes seleccionados .
  3. Haga clic en Aceptar .
Puede hacer referencia y utilizar la clase en el código de cliente.

Uso alternativo de - nowrappedproxy

Una vez compilados los clientes, también se puede utilizar un ensamblado de datos de metadatos. En este escenario, debe generar un archivo de ensamblado de datos de metadatos que tiene el mismo nombre que el ensamblado de entrada original. Para ello, ejecute la herramienta Soapsuds escribiendo el comando siguiente (como una línea de comandos) en el símbolo del sistema de Visual Studio .NET:

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


Este comando crea el nuevo archivo de ensamblado de metadatos en \bin\debug\metaonly de project directorio y asigna el nuevo archivo de ensamblado de metadatos el mismo nombre que el archivo de ensamblado de entrada. Resulta útil dar a este nuevo archivo un nombre significativo temporalmente, mientras se está manipulando el archivo antes de la implementación. Al implementar el nuevo ensamblado de datos de metadatos, cambie el nombre al nombre original.

Puede implementar este nuevo ensamblado a clientes remotos que ya se han compilado con el ensamblado de entrada original. En esta configuración de implementación, cuando la aplicación cliente carga el ensamblado, el cliente busca el archivo de ensamblado original por nombre, pero el cliente busca el ensamblado de datos de metadatos por el mismo nombre. El cliente sólo requiere la meta datos y el tipo de información contenida en el archivo de ensamblado para invocar los métodos remotos, por lo que el ensamblado de datos de metadatos es suficiente para este propósito.

Solución de problemas

  • Cuando se ejecuta el comando Soapsuds.exe, compruebe que no incluya la extensión de archivo .dll cuando especifique el archivo de ensamblado de entrada.
  • Puede abreviar los argumentos Soapsuds.exe, como se describe en el artículo Developer Network (MSDN) que aparece en la sección "Referencias".
  • Tenga cuidado cuando cambie el nombre del archivo de ensamblado de salida después de haberse generado. Como con cualquier ensamblado de .NET Framework, el nombre del archivo .dll es una parte de los metadatos. Se producirá un error cuando el ensamblado se carga si el nombre es diferente del nombre que aparece en los metadatos.

Referencias

Para obtener más información acerca de la herramienta Soapsuds, visite el siguiente sitio Web de MSDN:
Soapsuds Tool (Soapsuds.exe)
Para obtener información adicional, haga clic en el número de artículo siguiente para ver el artículo en Microsoft Knowledge Base:
323490INFORMACIÓN: Configurar .NET Remoting cuando el cliente remoto es una aplicación ASP.NET o el cliente es otro componente remotos que está alojado por IIS

Propiedades

Id. de artículo: 323491 - Última revisión: jueves, 22 de abril de 2004 - Versión: 3.4
La información de este artículo se refiere a:
  • Microsoft Visual Studio .NET 2003 Professional
  • Microsoft Visual Studio .NET 2002 Professional
  • Microsoft .NET Framework 1.1
  • Microsoft .NET Framework 1.0
Palabras clave: 
kbmt kbhowtomaster KB323491 KbMtes
Traducción automática
IMPORTANTE: Este artículo ha sido traducido por un software de traducción automática de Microsoft (http://support.microsoft.com/gp/mtdetails) en lugar de un traductor humano. Microsoft le ofrece artículos traducidos por un traductor humano y artículos traducidos automáticamente para que tenga acceso en su propio idioma a todos los artículos de nuestra base de conocimientos (Knowledge Base). Sin embargo, los artículos traducidos automáticamente pueden contener errores en el vocabulario, la sintaxis o la gramática, como los que un extranjero podría cometer al hablar el idioma. Microsoft no se hace responsable de cualquier imprecisión, error o daño ocasionado por una mala traducción del contenido o como consecuencia de su utilización por nuestros clientes. Microsoft suele actualizar el software de traducción frecuentemente.
Haga clic aquí para ver el artículo original (en inglés): 323491

Enviar comentarios

 

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