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 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 XmlSerializerXmlSerializer 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 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:<linguaggio> |
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 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'associazione dati
| Opzione | Descrizione |
|---|---|
/enableDataBinding |
Implementa l'interfaccia INotifyPropertyChanged su tutti i tipi DataContract per consentire l'associazione dati. Forma abbreviata: /edb |
Generazione della configurazione
| Opzione | Descrizione |
|---|---|
/config:<file di configurazione> |
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. |
Vedere anche
Concetti
Utilizzo di metadati
Panoramica dell'architettura dei metadati