Dela via

Generera en WCF-klient från tjänstmetadata

I det här avsnittet beskrivs hur du använder de olika växlarna i Svcutil.exe för att generera klienter från metadatadokument.

Metadatadokument kan finnas på ett beständigt lagringsutrymme eller hämtas online. Onlinehämtning följer antingen protokollet WS-MetadataExchange eller Microsoft Discovery (DISCO). Svcutil.exe utfärdar samtidigt följande metadatabegäranden för att hämta metadata:

  • WS-MetadataExchange (MEX) begäran till den angivna adressen.

  • MEX-begäran till den angivna adressen med /mex bifogad.

  • DISCO-begäran (med hjälp av DiscoveryClientProtocol från ASP.NET webbtjänster) till den angivna adressen.

Svcutil.exe genererar klienten baserat på WSDL (Web Services Description Language) eller principfilen som tas emot från tjänsten. Användarens huvudnamn (UPN) genereras genom att användarnamnet sammanfogas med "@" och sedan lägga till ett fullständigt kvalificerat domännamn (FQDN). Men för användare som har registrerat sig i Active Directory är det här formatet inte giltigt och det UPN som verktyget genererar orsakar ett fel i Kerberos-autentiseringen med följande felmeddelande: Inloggningsförsöket misslyckades. Lös problemet genom att manuellt åtgärda klientfilen som verktyget genererade.

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

Referens- och delningstyper

Alternativ Beskrivning
/reference:<filväg> Refererar till typer i den angivna sammansättningen. När du genererar klienter använder du det här alternativet för att ange sammansättningar som kan innehålla typer som representerar de metadata som importeras.

Kort formulär: /r
/excludeType:<type> Anger ett fullständigt kvalificerat eller sammansättningskvalificerat typnamn som ska undantas från refererade kontraktstyper.

Kort formulär: /et

Välja en serialiserare

Alternativ Beskrivning
/serializer:Automatisk Väljer serialiseraren automatiskt. Detta använder serialiseraren DataContract . Om detta misslyckas, så används XmlSerializer.

Kort formulär: /ser:Auto
/serializer:DataContractSerializer Genererar datatyper som använder serialiseraren DataContract för serialisering och deserialisering.

Kort formulär: /ser:DataContractSerializer
/serializer:XmlSerializer Genererar datatyper som använder XmlSerializer för serialisering och deserialisering.

Kort formulär: /ser:XmlSerializer
/importXmlTypes Konfigurerar DataContract-serialiseraren för att importera icke-DataContract-typer som IXmlSerializable-typer.

Kort formulär: /ixt
/dataContractOnly Genererar endast kod för DataContract typer. ServiceContract typer genereras.

Du bör endast ange lokala metadatafiler för det här alternativet.

Kort formulär: /dconly

Välja ett språk för klienten

Alternativ Beskrivning
/language:<language> Anger det programmeringsspråk som ska användas för kodgenerering. Ange antingen ett språknamn som är registrerat i filen Machine.config eller det fullständigt kvalificerade namnet på en klass som ärver från CodeDomProvider.

Värden: c#, cs, csharp, vb, vbs, visualbasic, vbscript, javascript, c++, mc, cpp

Standard: csharp

Kort formulär: /l

Mer information finns i CodeDomProvider klass.

Välja ett namnområde för klienten

Alternativ Beskrivning
/namnrymd:<string,string> Anger en mappning från ett WSDL- eller XML-schema targetNamespace till ett CLR-namnområde (Common Language Runtime). Använda ett jokertecken (*) används för att kartlägga alla targetNamespace utan en explicit mappning till det CLR-namnområdet.

För att säkerställa att namnet på meddelandekontraktet inte kolliderar med åtgärdsnamnet kvalificerar du antingen typreferensen med dubbla kolon (::) eller kontrollerar att namnen är unika.

Standard: Härledd från målnamnområdet för schemadokumentet för DataContracts. Standardnamnområdet används för alla andra genererade typer.

Kort formulär: /n

Välja en databindning

Alternativ Beskrivning
/enableDataBinding Implementerar INotifyPropertyChanged gränssnittet på alla DataContract typer för att aktivera databindning.

Kort formulär: /edb

Generera konfiguration

Alternativ Beskrivning
/config:<configFile> Anger filnamnet för den genererade konfigurationsfilen.

Standard: output.config
/mergeConfig Sammanfogar den genererade konfigurationen till en befintlig fil i stället för att skriva över den befintliga filen.
/noConfig Generera inte konfigurationsfiler.

Se även