Postupy: Stažení dokumentů metadat pomocí nástroje Svcutil.exe

  • Článek

Pomocí Svcutil.exe můžete stáhnout metadata ze spuštěných služeb a uložit metadata do místních souborů. V případě schémat ADRES URL HTTP a HTTPS se Svcutil.exe pokusí načíst metadata pomocí WS-MetadataExchange a zjišťování webové služby XML. Pro všechna ostatní schémata adres URL Svcutil.exe používá pouze WS-MetadataExchange.

Ve výchozím nastavení Svcutil.exe používá vazby definované ve MetadataExchangeBindings třídě. Chcete-li nakonfigurovat vazbu použitou pro WS-MetadataExchange, je nutné definovat koncový bod klienta v konfiguračním souboru pro Svcutil.exe (svcutil.exe.config), který používá IMetadataExchange kontrakt a který má stejný název jako schéma identifikátoru URI (Uniform Resource Identifier) adresy koncového bodu metadat.

Upozornění

Při spuštění Svcutil.exe získat metadata pro službu, která zveřejňuje dva různé kontrakty služeb, které každý obsahuje operaci se stejným názvem, Svcutil.exe zobrazí chybu s informací, že nejde získat metadata z ...... Například pokud máte službu, která zveřejňuje kontrakt služby, který má ICarService operaci Get(Car c) a stejná služba zveřejňuje kontrakt služby, který IBookService má operaci Get(Book b). Pokud chcete tento problém vyřešit, udělejte jednu z těchto věcí:

  • Přejmenujte jednu z operací.
  • Name Nastavte na jiný název.
  • Nastavte jeden z oborů názvů operací na jiný obor názvů pomocí Namespace vlastnosti.

Stažení metadat pomocí Svcutil.exe

  1. Vyhledejte nástroj Svcutil.exe v následujícím umístění:

    C:\Program Files\Microsoft SDKs\Windows\v1.0.\bin

  2. Na příkazovém řádku spusťte nástroj pomocí následujícího formátu.

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

    Je nutné zadat /t:metadata možnost stahování metadat. Jinak se vygeneruje kód klienta a konfigurace.

  3. Argument <url>určuje adresu URL koncového bodu služby, který poskytuje metadata nebo dokument metadat hostovaný online. Argument <epr> určuje cestu k souboru XML, který obsahuje WS-Adresování EndpointAddress koncového bodu služby, který podporuje WS-MetadataExchange.

Další možnosti použití tohoto nástroje ke stažení metadat naleznete v tématu ServiceModel Metadata Utility Tool (Svcutil.exe).

Příklad

Následující příkaz stáhne dokumenty metadat ze spuštěné služby.

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

Viz také