Comment faire pour créer et utiliser un assembly de métadonnées

Traductions disponibles Traductions disponibles
Numéro d'article: 323491 - Voir les produits auxquels s'applique cet article
Agrandir tout | Réduire tout

Sommaire

Résumé

Cet article étape par étape décrit les métadonnées assemblys sont et dans les scénarios de pouvoir les utiliser. Cet article explique également comment utiliser l'outil Soapsuds avec l'indicateur nowrappedproxy pour générer un assembly de données de métadonnées.

Configuration requise

La liste suivante met en évidence le matériel recommandé, logiciel infrastructure réseau et service packs dont vous avez besoin :
  • Visual Studio .NET
  • Microsoft Internet Information Services (IIS)
Cet article suppose que vous êtes familiarisé avec les sujets suivants :
  • Visual Studio .NET
  • Microsoft .NET framework
  • Microsoft .NET remoting

Que sont les assemblys des données métafichier ?

Assemblys de données métafichiers sont des assemblys .NET Framework qui contiennent des métadonnées données et type informations uniquement. Métafichiers données assemblys sont similaires à taper bibliothèques COM, mais meta données assemblys ne contiennent pas n'importe quel code d'implémentation.

Et avec une application cliente distribuée, vous pouvez déployer les assemblys de données meta qui contiennent suffisamment d'informations pour cette application cliente créer un proxy distant et que proxy distant pour appeler des méthodes sur l'assembly réel, qui peut se trouver sur un autre ordinateur.

Le guide suivant explique comment générer un assembly de données de métadonnées à partir d'un simple composant basées sur .NET.

Créer un composant de Framework .NET simple

  1. Dans Visual Studio. NET, dans le menu Fichier , cliquez sur Nouveau , puis cliquez sur projet . Sous types de projets , cliquez sur projets Visual C# . Sous modèles , cliquez sur bibliothèque de classes .
  2. Modifier le nom à MyRemoteComp , puis cliquez sur OK .

    Le projet de bibliothèque de classe est créé. classe Class1 dans l'espace de noms MyRemoteComp est créé dans Class1.cs par défaut.
  3. Copiez et collez le code suivant dans Class1 :
    public string SayHello(string sName)
    {
        return "Hi, " + sName;		
    }
    					
  4. Dans le menu Générer , cliquez sur Générer la solution pour créer la bibliothèque de classe. L'assembly est nommé MyRemoteComp.dll.

Utilisez l'outil Soapsuds pour générer l'assembly de données META

Cette section explique comment utiliser l'outil Soapsuds (Soapsuds.exe) et il s'agit d'indicateur nowrappedproxy pour créer l'assembly données meta. Le fichier d'assembly simple créé à la procédure précédente est utilisé comme entrée :
  1. Dans le menu Démarrer , pointez sur programmes , cliquez sur Visual Studio .NET , cliquez sur Outils de Visual Studio .NET et puis cliquez sur invite de commande Visual Studio .NET .
  2. Dans le Visual Studio .NET invite de commandes, accédez au répertoire dans lequel vous avez créé votre assembly de bibliothèque de classe simple. Par défaut, l'assembly est dans le répertoire de \bin\debug du project. Tapez la commande dir et puis Notez qu'assembly nommé MyRemoteComp.dll apparaît dans la liste des fichiers.
  3. Exécutez l'outil Soapsuds par rapport à votre assembly. Pour cela, tapez la commande suivante (comme une ligne de commande) à le Visual Studio .NET invite de commandes :

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

    Vous disposez maintenant d'un deuxième .dll assembly nommé Myremotecomp.metaonly.dll. Ceci est l'assembly de données meta.
Vous pouvez utiliser cet assembly de données les métadonnées de développement de clients à distance et de déploiement. Lorsque vous développez le client distant, ajoutez une référence à cet assembly données méta au lieu d'une référence à l'assembly qui contient le code d'implémentation. Si vous développez dans Visual Studio .NET, procédez comme suit pour ajouter la référence :
  1. Dans le menu projet , cliquez sur Ajouter une référence .
  2. Cliquez sur Parcourir , localisez votre assembly de données de métadonnées et puis cliquez sur Ouvrir .

    Votre assembly apparaît sous les composants sélectionnés .
  3. Cliquez sur OK .
Vous pouvez maintenant référencer et utiliser la classe dans votre code de client.

Autre utilisation des - nowrappedproxy

Vous pouvez utiliser un assembly de données méta une fois que vos clients sont compilés, également. Dans ce scénario, vous devez générer un fichier d'assembly de données de meta qui porte le même nom que l'assembly d'entrée d'origine. Pour ce faire, exécutez l'outil Soapsuds en tapant la commande suivante (comme une ligne de commande) à le Visual Studio .NET invite de commandes :

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

Cette commande crée le nouveau fichier assembly de données meta dans le \bin\debug\metaonly project répertoire et donne le nouveau fichier assembly de données méta le même nom que le fichier d'assembly entrée. Il est utile d'attribuer ce nouveau fichier un nom significatif temporairement, tandis que vous manipulez le fichier avant déploiement. Lorsque vous déployez le nouvel assembly données méta, modifier le nom le nom d'origine.

Vous pouvez déployer ce nouvel assembly aux clients distants qui ont déjà été compilées avec l'assembly d'entrée d'origine. Dans cette configuration de déploiement, lorsque l'application cliente charge l'assembly, le client recherche le fichier d'assembly d'origine par un nom, mais le client recherche l'assembly de données de métadonnées portant le même nom. Le client requiert des uniquement les méta données et type informations contenues dans le fichier d'assembly pour appeler les méthodes à distance, l'assembly de données de métadonnées est suffisante pour cela.

Résolution des problèmes

  • Lorsque vous exécutez la commande Soapsuds.exe, vérifiez que vous n'incluez pas l'extension de nom de fichier .dll lorsque vous spécifiez le fichier d'assembly entrée.
  • Vous pouvez abréger les arguments Soapsuds.exe, comme décrit dans l'article MSDN (Microsoft Developer Network) répertorié dans la section « Références ».
  • Soyez prudent lorsque vous modifier le nom du fichier d'assembly de sortie après que qu'il a été généré. Comme avec n'importe quel assembly .NET Framework, le nom du fichier .dll est une partie des données méta. Une erreur se produit lorsque l'assembly sera chargé si le nom est différent du nom qui apparaît dans les méta-données.

Références

Pour plus d'informations sur l'outil Soapsuds, reportez-vous au site Web MSDN suivant :
Soapsuds Tool (Soapsuds.exe)
Pour plus d'informations, cliquez sur le numéro ci-dessous pour afficher l'article correspondant dans la Base de connaissances Microsoft :
323490 INFO : Configuration .NET Remoting lorsque le client d'accès à distance est une application ASP.NET ou le client est un autre composant transférée distance qui est hébergé par IIS

Propriétés

Numéro d'article: 323491 - Dernière mise à jour: jeudi 22 avril 2004 - Version: 3.4
Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):
  • Microsoft Visual Studio .NET 2003 Professional
  • Microsoft Visual Studio .NET 2002 Professional Edition
  • Microsoft .NET Framework 1.1
  • Microsoft .NET Framework 1.0
Mots-clés : 
kbmt kbhowtomaster KB323491 KbMtfr
Traduction automatique
IMPORTANT : Cet article est issu du système de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis à votre disposition en complément des articles traduits en langue française par des traducteurs professionnels. Cela vous permet d?avoir accès, dans votre propre langue, à l?ensemble des articles de la base de connaissances rédigés originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne étrangère s?exprimant dans votre langue !). Néanmoins, mis à part ces imperfections, ces articles devraient suffire à vous orienter et à vous aider à résoudre votre problème. Microsoft s?efforce aussi continuellement de faire évoluer son système de traduction automatique.
La version anglaise de cet article est la suivante: 323491
L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Envoyer des commentaires

 

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