Compartilhar via

Gerando um cliente WCF a partir de metadados de serviço

Este tópico descreve como usar as várias opções em Svcutil.exe para gerar clientes de documentos de metadados.

Os documentos de metadados podem estar em um armazenamento durável ou ser recuperados online. A recuperação online segue o protocolo WS-MetadataExchange ou o protocolo DISCO (Microsoft Discovery). Svcutil.exe emite as seguintes solicitações de metadados simultaneamente para recuperar metadados:

  • Solicitação WS-MetadataExchange (MEX) para o endereço fornecido.

  • Solicitação MEX para o endereço fornecido com /mex anexado.

  • Solicitação DISCO (usando o DiscoveryClientProtocol dos serviços da Web ASP.NET) para o endereço fornecido.

Svcutil.exe gera o cliente com base no WSDL (Linguagem de Descrição dos Serviços Web) ou no arquivo de política recebido do serviço. O nome principal do usuário (UPN) é gerado concatenando o nome do usuário com "@" e, em seguida, adicionando um nome de domínio totalmente qualificado (FQDN). No entanto, para usuários que se registraram no Active Directory, esse formato não é válido e o UPN gerado pela ferramenta causa uma falha na autenticação Kerberos com a seguinte mensagem de erro: Falha na tentativa de logon. Para resolver esse problema, corrija manualmente o arquivo cliente que a ferramenta gerou.

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

Tipos de referência e compartilhamento

Opção Descrição
/reference:<caminho do arquivo> Os tipos de referência no assembly especificado. Ao gerar clientes, use essa opção para especificar assemblies que possam conter tipos que representam os metadados que estão sendo importados.

Forma curta: /r
/excluirTipo:<tipo> Especifica um nome de tipo totalmente qualificado ou qualificado do assembly a ser excluído dos tipos de contrato referenciados.

Forma curta: /et

Escolhendo um serializador

Opção Descrição
/serializer:Auto Seleciona automaticamente o serializador. Isso usa o DataContract serializador. Se isso falhar, o XmlSerializer será usado.

Formulário Curto: /ser:Auto
/serializer:DataContractSerializer Gera tipos de dados que usam o DataContract serializador para serialização e desserialização.

Forma curta: /ser:DataContractSerializer
/serializer:XmlSerializer Gera tipos de dados que usam XmlSerializer para serialização e desserialização.

Forma curta: /ser:XmlSerializer
/importXmlTypes Configura o DataContract serializador para importar tipos não-DataContract como tipos IXmlSerializable.

Forma curta: /ixt
/dataContractOnly Gera código somente para DataContract tipos. Tipos ServiceContract são gerados.

Você deve especificar apenas arquivos de metadados locais para essa opção.

Forma curta: /dconly

Escolhendo um idioma para o cliente

Opção Descrição
/language:<language> Especifica a linguagem de programação a ser usada para geração de código. Forneça um nome de idioma registrado no arquivo Machine.config ou o nome totalmente qualificado de uma classe que herda de CodeDomProvider.

Valores: c#, cs, csharp, vb, vbs, visualbasic, vbscript, javascript, c++, mc, cpp

Padrão: csharp

Forma curta: /l

Para obter mais informações, consulte a classe CodeDomProvider.

Escolhendo um namespace para o cliente

Opção Descrição
/namespace:<string,string> Especifica um mapeamento de um esquema targetNamespace WSDL ou XML para um namespace CLR (Common Language Runtime). Usar um curinga (*) para o targetNamespace mapeia todos os targetNamespaces sem um mapeamento explícito para esse namespace CLR.

Para garantir que o nome do contrato de mensagem não colida com o nome da operação, qualifique a referência de tipo com dois-pontos duplos (::) ou certifique-se de que os nomes sejam exclusivos.

Padrão: Derivado do namespace de destino do documento de esquema para DataContracts. O namespace padrão é usado para todos os outros tipos gerados.

Forma curta: /n

Escolhendo uma associação de dados

Opção Descrição
/enableDataBinding Implementa a interface INotifyPropertyChanged em todos os tipos DataContract para habilitar a vinculação de dados.

Forma curta: /edb

Gerando configuração

Opção Descrição
/config:<configFile> Especifica o nome do arquivo para o arquivo de configuração gerado.

Padrão: output.config
/mergeConfig Mescla a configuração gerada em um arquivo existente, em vez de substituir o arquivo existente.
/noConfig Não gere arquivos de configuração.

Consulte também

  • Last updated on