Condividi tramite


Generazione di un client WCF dai metadati del servizio

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