Delen via

Procedure: Svcutil.exe gebruiken om metagegevensdocumenten te downloaden

  • Artikel

U kunt Svcutil.exe gebruiken om metagegevens te downloaden van actieve services en om de metagegevens op te slaan in lokale bestanden. Voor HTTP- en HTTPS-URL-schema's probeert Svcutil.exe metagegevens op te halen met WS-MetadataExchange en XML-webservicedetectie. Voor alle andere URL-schema's gebruikt Svcutil.exe alleen WS-MetadataExchange.

Standaard gebruikt Svcutil.exe de bindingen die in de MetadataExchangeBindings klasse zijn gedefinieerd. Als u de binding wilt configureren die wordt gebruikt voor WS-MetadataExchange, moet u een clienteindpunt definiëren in het configuratiebestand voor Svcutil.exe (svcutil.exe.config) die gebruikmaakt van het IMetadataExchange contract en die dezelfde naam heeft als het URI-schema (Uniform Resource Identifier) van het adres van het metagegevenseindpunt.

Let op

Wanneer u Svcutil.exe uitvoert om metagegevens op te halen voor een service die twee verschillende servicecontracten weergeeft die elk een bewerking van dezelfde naam bevatten, wordt er Svcutil.exe een foutbericht weergegeven met de tekst 'Kan geen metagegevens verkrijgen van ....' Als u bijvoorbeeld een service hebt waarmee een servicecontract ICarService wordt weergegeven dat een bewerking Get(Car c) heeft en dezelfde service een servicecontract met de naam IBookService een bewerking Get(Book b)bevat. Ga op een van de volgende manieren te werk om dit probleem te omzeilen:

  • Wijzig de naam van een van de bewerkingen.
  • Stel de Name naam in op een andere naam.
  • Stel een van de naamruimten van de bewerkingen in op een andere naamruimte met behulp van de Namespace eigenschap.

Metagegevens downloaden met Svcutil.exe

  1. Zoek het hulpprogramma Svcutil.exe op de volgende locatie:

    C:\Program Files\Microsoft SDK's\Windows\v1.0.\bin

  2. Start het hulpprogramma bij de opdrachtprompt met behulp van de volgende indeling.

    svcutil.exe /t:metadata  <url>* | <epr>

    U moet de optie voor het /t:metadata downloaden van metagegevens opgeven. Anders worden clientcode en -configuratie gegenereerd.

  3. Het <url>argument geeft de URL op naar een service-eindpunt dat metagegevens of een metagegevensdocument biedt dat online wordt gehost. Het <epr> argument geeft het pad op naar een XML-bestand dat een WS-Adressering EndpointAddress bevat voor een service-eindpunt dat WS-MetadataExchange ondersteunt.

Zie het Hulpprogramma voor metagegevens voor metagegevens downloaden (Svcutil.exe) voor meer opties over het gebruik van dit hulpprogramma voor het downloaden van metagegevens.

Opmerking

Met de volgende opdracht worden metagegevensdocumenten gedownload van een actieve service.

svcutil /t:metadata http://service/metadataEndpoint

Zie ook