Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Como usar o Svcutil.exe para baixar documentos de metadados

.NET Framework (current version)
 

Você pode usar Svcutil.exe para baixar metadados de serviços em execução e salvar os metadados em arquivos locais. Para esquemas de URL HTTP e HTTPS, Svcutil.exe tenta recuperar metadados usando WS-MetadataExchange e XML Web Service Discovery. Para todos os outros esquemas de URL, Svcutil.exe usa apenas WS-MetadataExchange.

Por padrão, Svcutil.exe usa as associações definidas na MetadataExchangeBindings classe. Para configurar a associação usada para WS-MetadataExchange, você deve definir um ponto de extremidade do cliente no arquivo de configuração para Svcutil.exe (svcutil.exe.config) que usa o IMetadataExchange contrato e que tem o mesmo nome do esquema de identificador de recurso uniforme (URI) do endereço de ponto de extremidade de metadados.

System_CAPS_cautionCuidado

Quando em execução Svcutil.exe ao obter metadados para um serviço que expõe dois serviços diferentes contratos que contêm uma operação de mesmo nome, Svcutil.exe exibe um erro dizendo que "Não é possível obter metadados de..." Por exemplo, se você tiver um serviço que expõe um contrato de serviço chamado ICarService que tem uma operação Get (Car c) e o mesmo serviço expõe um contrato de serviço chamado IBookService que tem uma operação Get (catálogo b). Para contornar esse problema, siga um destes procedimentos:

  • Renomear uma das operações

  • Definir o Name para um nome diferente.

  • Defina um dos namespaces as operações em um namespace diferente usando o Namespace propriedade.

Para baixar metadados usando Svcutil.exe

  1. Localize a ferramenta Svcutil.exe no seguinte local:

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

  2. No prompt de comando, inicie a ferramenta usando o seguinte formato.

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

    Você deve especificar o /t:metadata opção para baixar metadados. Caso contrário, a configuração e o código do cliente são gerados.

  3. O <url>argumento especifica a URL para um ponto de extremidade de serviço que fornece metadados ou um documento de metadados hospedado online. O <epr> argumento especifica o caminho para um arquivo XML que contém um WS-Addressing EndpointAddress para um ponto de extremidade de serviço que dá suporte a WS-MetadataExchange.

Para obter mais opções sobre como usar essa ferramenta para download de metadados, consulte Ferramenta Utilitário de Metadados ServiceModel (Svcutil.exe).

Exemplo

O comando a seguir baixa documentos de metadados de um serviço em execução.

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