Strumento del linguaggio di descrizione dei servizi Web (Wsdl.exe)

Lo strumento del linguaggio di descrizione dei servizi Web consente di generare codice per servizi Web XML e client di servizi Web XML da file di contratto WSDL, schemi XSD e documenti di individuazione DISCOMAP.

wsdl [options] {URL | path}

Note

Un file WSDL è un documento XML scritto in una grammatica XML denominata linguaggio di descrizione dei servizi Web (WSDL, Web Service Description Language). In questo file si definisce il comportamento di un servizio Web XML e si indicano ai client le modalità di interazione con il servizio.

Per ottenere documenti di individuazione per un servizio Web XML, è possibile utilizzare lo strumento di individuazione Servizi Web (Disco.exe). I file DISCOMAP, DISCO, WSDL e XSD prodotti da questo strumento possono essere utilizzati come input per Wsdl.exe.

Quando lo strumento Wsdl.exe viene utilizzato per creare una classe proxy, viene generato un singolo file di origine nel linguaggio specificato. Durante la generazione del codice sorgente per la classe proxy, viene determinato il tipo migliore da utilizzare per gli oggetti specificati nella descrizione del servizio. In alcuni casi viene utilizzato l'approccio del minimo comune denominatore per eseguire il cast di oggetti su un tipo. Di conseguenza, il tipo generato nella classe proxy potrebbe non corrispondere alle previsioni o ai desideri dello sviluppatore. Quando ad esempio viene rilevato un tipo ArrayList in una descrizione del servizio, viene creato un Object Array nella classe proxy generata. Per garantire il cast dell'oggetto su un tipo corretto, aprire il file contenente la classe proxy generata e modificare i tipi di oggetti non corretti nel tipo di oggetto previsto.

• L'opzione /parameters consente di specificare un file contenente elementi che corrispondono alla maggior parte delle opzioni del prompt dei comandi. Alcune di queste sono disponibili solo nei formati di file /parameters.

Il formato di file XML accettato dall'opzione /parameters è costituito da una serie di elementi all'interno di un elemento <wsdlParameters xmlns="https://microsoft.com/webReference/"> più esterno. Se si specificano valori al prompt dei comandi e si utilizza un file /parameters contenente opzioni o valori differenti, verranno utilizzati i valori specificati al prompt dei comandi. L'elemento <wsdlParameters xmlns="https://microsoft.com/webReference/"> deve contenere un'istanza di <nologo>, <parsableerrors> e <sharetypes>.

Diverse opzioni vengono passate come elementi figlio dell'elemento <webReferenceOptions>, che deve contenere un elemento <verbose>. Altri elementi figlio di <webReferenceOptions> comprendono:

• <style>: contiene "client", "server" o "serverInterface".

• <schemaImporterExtension>: contiene un numero qualsiasi di elementi <type>.

• <codeGenerationOptions>: può accettare un insieme delimitato da spazi delle seguenti stringhe:

• "properties"

• "newAsync"

• "oldAsync"

• "order"

• "enableDataBinding"

Per alcuni esempi di utilizzo dell'opzione /parameters, vedere la sezione relativa agli esempi.

Esempi

Il comando riportato di seguito consente di creare una classe proxy client in linguaggio C# per il servizio Web XML.

wsdl http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

Il comando riportato di seguito consente di creare una classe proxy client in linguaggio C# per un servizio Web XML disponibile all'URL specificato. La classe proxy client viene salvata nel file myProxyClass.cs.

wsdl /out:myProxyClass.cs http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

Il comando riportato di seguito consente di creare una classe proxy client in linguaggio Microsoft Visual Basic per un servizio Web XML disponibile all'URL specificato. La classe proxy client viene salvata nel file myProxyClass.vb.

wsdl /language:VB /out:myProxyClass.vb http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

• Nel codice di esempio riportato di seguito viene illustrato un file WSDL /parameters di base, contenente solo gli elementi obbligatori, che è possibile utilizzare insieme a un argomento URL al prompt dei comandi.

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
</wsdlParameters>

I documenti WSDL vengono aggiunti nel file WSDL /parameters mediante l'elemento <documents>, come illustrato nel seguente esempio di codice. Nell'elemento <documents> è possibile utilizzare un numero qualsiasi di elementi <document>.

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
</wsdlParameters>

Nel file WSDL /parameters riportato di seguito viene illustrato l'utilizzo degli elementi <codeGenerationOptions> e <style> all'interno di <webReferenceOptions>. In questo caso, nel file sono incluse le opzioni per attivare il nuovo stile di associazione dati (databinding) nel codice proxy, specificare un'estensione di importazione dello schema, impostare la modalità non dettagliata per l'output e richiedere la creazione di un proxy client.

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
  <webReferenceOptions>
    <verbose>false</verbose>
    <codeGenerationOptions>properties newAsync enableDataBinding</codeGenerationOptions>
    <schemaImporterExtension>
      <type>MyNamespace.MyCustomImporterExtension,ExtensionLibrary</type>
    </schemaImporterExtensions>
    <style>client</style>
  </webReferenceOptions>
</wsdlParameters>

Vedere anche

Riferimenti

Strumenti di .NET Framework
Strumento di individuazione Servizi Web (Disco.exe)
Prompt dei comandi di SDK

Concetti

Creazione di un proxy di servizio Web XML
Descrizione del servizio Web XML
Cenni preliminari sui servizi Web XML