Generazione di un client WCF dai metadati del servizio

  • Articolo

In questo argomento viene illustrato come utilizzare le varie opzioni in Svcutil.exe per generare client da documenti dei metadati.

Questi documenti dei metadati possono essere salvati in modo permanente o recuperati in linea. Il recupero in linea segue il protocollo WS-MetadataExchange o il protocollo Microsoft Discovery (DISCO). Per recuperare metadati, Svcutil.exe genera contemporaneamente le richieste di metadati seguenti:

  • Richiesta WS-MetadataExchange (MEX) all'indirizzo fornito.

  • Richiesta MEX all'indirizzo fornito con /mex accodato.

  • Richiesta DISCO (utilizzando DiscoveryClientProtocol dai servizi Web ASP.NET) all'indirizzo fornito.

Lo strumento Svcutil.exe consente di generare il client in base al WSDL (Web Services Description Language) o al file dei criteri ricevuto dal servizio. Il nome dell’entità utente (UPN) viene generato concatenando il nome utente con "@" e aggiungendo quindi un nome di dominio completo (FQDN). Per utenti registrati su Active Directory, questo formato non è tuttavia valido e l’UPN generato dallo strumento provoca un errore di autenticazione Kerberos con il messaggio di errore seguente: Tentativo di accesso non riuscito. Per risolvere questo problema, è necessario correggere manualmente il file client generato da questo strumento.

svcutil.exe [/t:code]  <metadataDocumentPath>* | <url>* | <epr>

Riferimento e condivisione dei tipi

Opzione Descrizione
/reference:<percorso del file> Fa riferimento a tipi nell'assembly specificato. Quando si generano client, utilizzare questa opzione per specificare assembly che potrebbero contenere tipi che rappresentano i metadati importati.

Forma abbreviata: /r
/excludeType:<tipo> Specifica un nome tipo completo o un nome completo del tipo dell’assembly da escludere dai tipi di contratto a cui si fa riferimento.

Forma abbreviata: /et

Scelta di un serializzatore

Opzione Descrizione
/serializer:Auto Seleziona automaticamente il serializzatore. Utilizza il serializzatore DataContract. In caso di errore, viene utilizzato XmlSerializer.

Forma abbreviata: /ser:Auto
/serializer:DataContractSerializer Generare tipi di dati che utilizzano il serializzatore DataContract per la serializzazione e la deserializzazione.

Forma abbreviata: /ser:DataContractSerializer
/serializer:XmlSerializer Genera tipi di dati che utilizzano XmlSerializer per la serializzazione e la deserializzazione.

Forma abbreviata: /ser:XmlSerializer
/importXmlTypes Configura il serializzatore DataContract per importare tipi non DataContract come tipi IXmlSerializable.

Forma abbreviata: /ixt
/dataContractOnly Genera codice solo per i tipi DataContract. Vengono generati i tipi ServiceContract.

Per questa opzione è necessario specificare soltanto file di metadati locali.

Forma abbreviata: /dconly

Scelta di un linguaggio per il client

Opzione Descrizione
/language:<lingua> Specifica il linguaggio di programmazione da utilizzare per la generazione del codice. Fornire un nome di linguaggio registrato nel file Machine.config o il nome completo di una classe che eredita da CodeDomProvider.

Valori: c#, cs, csharp, vb, vbs, visualbasic, vbscript, javascript, c++, mc, cpp

Impostazione predefinita: csharp

Forma abbreviata: /l

Per ulteriori informazioni, vedere la classe CodeDomProvider.

Scelta di uno spazio dei nomi per il client

Opzione Descrizione
/namespace:<stringa, stringa> Specifica un mapping da un WSDL o XML Schema targetNamespace a uno spazio dei nomi Common Language Runtime (CLR). L’utilizzo di un carattere jolly (*) per targetNamespace consente di eseguire il mapping di tutti i targetNamespaces senza un mapping esplicito a quello spazio dei nomi CLR.

Per assicurarsi che il nome del contratto di messaggio non entri in conflitto con il nome dell'operazione, è necessario qualificare il riferimento al tipo con doppi due punti (::) o verificare che i nomi siano univoci.

Impostazione predefinita: derivata dallo spazio dei nomi di destinazione del documento dello schema per DataContracts. Lo spazio dei nomi predefinito viene utilizzato per tutti gli altri tipi generati.

Forma abbreviata: /n

Scelta di un data binding

Opzione Descrizione
/enableDataBinding Implementa l'interfaccia INotifyPropertyChanged su tutti i tipi DataContract per consentire il data binding.

Forma abbreviata: /edb

Generazione della configurazione

Opzione Descrizione
/config:<configFile> Specifica il nome file per il file di configurazione generato.

Impostazione predefinita: output.config
/mergeConfig Incorpora la configurazione generata in un file esistente, anziché sovrascrivere il file esistente.
/noConfig Non genera file di configurazione.

Vedi anche