Ferramenta Editor de Configuração (SvcConfigEditor.exe)
O Editor de Configuração de Serviço (SvcConfigEditor.exe) do Windows Communication Foundation (WCF) permite que administradores e desenvolvedores criem e modifiquem definições de configuração para serviços WCF usando uma interface gráfica do usuário. Com essa ferramenta, você pode gerenciar configurações para associações, comportamentos, serviços e diagnósticos do WCF sem precisar editar diretamente os arquivos de configuração XML.
O Editor de Configuração de Serviço pode ser encontrado na pasta C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin.
O editor de configuração do WCF
O Editor de Configuração de Serviço vem com um assistente que o orienta em todas as etapas de configuração de um serviço ou cliente WCF. É altamente recomendável usar o assistente em vez do editor diretamente.
Se você já tiver alguns arquivos de configuração que estejam em conformidade com o esquema System.Configuration padrão, poderá gerenciar configurações específicas para associações, comportamento, serviços e diagnósticos com a interface do usuário. O Editor de Configuração de Serviço permite que você gerencie as configurações para arquivos de configuração WCF existentes, bem como arquivos executáveis, serviços COM+ e serviços hospedados na Web. Ao abrir um serviço hospedado na Web com o Editor de Configuração de Serviço, as seções de configuração própria do serviço e configurações herdadas de nós de nível superior são mostradas.
Como as <system.serviceModel> definições de configuração do WCF estão localizadas na seção do arquivo de configuração, o editor opera exclusivamente no conteúdo desse elemento e não acessa outros elementos no mesmo arquivo. Você pode navegar diretamente para os arquivos de configuração existentes ou selecionar um assembly que contenha um serviço, diretório virtual ou serviço COM+. O editor carrega o arquivo de configuração para esse serviço específico e permite que o usuário adicione novos elementos ou edite elementos existentes aninhados na <system.serviceModel> seção do arquivo de configuração.
O editor suporta IntelliSense e impõe a conformidade do esquema. A saída resultante é garantida para estar em conformidade com o esquema do arquivo de configuração e ter valores de dados sintaticamente corretos. No entanto, o editor não garante que o arquivo de configuração seja semanticamente válido. Em outras palavras, o editor não garante que o arquivo de configuração possa funcionar com o serviço que ele configura.
Atenção
O editor não pode limpar um elemento de configuração do arquivo de configuração depois de modificá-lo. Por exemplo, se você usar o editor para definir o nome do ponto de extremidade como uma cadeia de caracteres não vazia e salvá-lo, o arquivo de configuração terá o seguinte conteúdo, conforme mostrado no exemplo a seguir.
<endpoint binding="basicHttpBinding" name="somename" />
Se você tentar remover o nome definindo-o como uma cadeia de caracteres vazia e salvar o arquivo, o arquivo de configuração ainda conterá o atributo name , conforme mostrado no exemplo a seguir.
<endpoint binding="basicHttpBinding" name="" />
Para limpar o atributo, você deve editar manualmente o elemento usando outro editor de texto.
Você deve ter especial cuidado com esse problema ao usar o issueToken elemento do clientCredential comportamento Endpoint. Especificamente, o address atributo de seu localIssuer subelemento não deve ser uma cadeia de caracteres vazia. Se você modificou o address atributo usando o Editor de Configuração e deseja removê-lo completamente, deverá fazê-lo usando uma ferramenta diferente do Editor. Caso contrário, o atributo contém uma cadeia de caracteres vazia e seu aplicativo lança uma exceção.
Usando o Editor de configuração
O Editor de Configuração de Serviço pode ser encontrado no seguinte local de instalação do SDK do Windows:
C:\Arquivos de Programas\Microsoft SDKs\Windows\v6.0\Bin\SvcConfigEditor.exe
Depois de iniciar o Editor de Configuração de Serviço, você pode usar o menu Arquivo/Abrir para procurar o serviço ou assembly que deseja gerenciar. Você pode abrir arquivos de configuração diretamente, procurar serviços WCF /COM+ e abrir arquivos de configuração para serviços hospedados na Web.
A interface do usuário do Editor de Configuração de Serviço é dividida nas seguintes áreas:
Painel de Exibição em Árvore, que exibe elementos de configuração em uma estrutura de árvore à esquerda. Você pode executar operações na árvore clicando com o botão direito do mouse nos nós.
Painel de Tarefas, que exibe tarefas comuns para elementos atuais no canto inferior esquerdo da janela
Painel de detalhes, que exibe as configurações detalhadas do nó de configuração selecionado na Visualização em árvore à direita.
Abrindo um arquivo de configuração
Inicie o Editor de Configuração de Serviço usando uma janela de comando para navegar até o local de instalação do WCF e digite
SvcConfigEditor.exe.No menu Arquivo, selecione Abrir e clique no tipo de arquivo que deseja gerenciar.
Na caixa de diálogo Abrir, navegue até o arquivo específico que deseja gerenciar e clique duas vezes nele.
O visualizador segue automaticamente o caminho de mesclagem de configuração e cria uma exibição da configuração mesclada. Por exemplo, a configuração real de um serviço não hospedado é uma combinação de Machine.config e App.config. Todas as alterações são aplicadas ao arquivo ativo no SvcConfigEditor. Se quiser editar um arquivo específico no caminho de mesclagem de configuração, abra-o diretamente.
Nota
O Editor de Configuração recarrega o arquivo de configuração atualmente aberto quando este foi modificado fora do Editor. Quando isso acontece, todas as alterações que não são salvas de forma durável dentro do Editor são perdidas. Se o recarregamento acontecer de forma consistente, a causa mais provável é um serviço que acessa constantemente o arquivo de configuração, por exemplo, um software antivírus em execução em segundo plano. Para resolver isso, certifique-se de que o Editor de configuração é o único processo que pode acessar o arquivo quando ele é aberto.
Serviços
O nó Serviços exibe todos os serviços atualmente atribuídos no arquivo de configuração. Cada subnó na árvore corresponde a um subelemento do <services> elemento no arquivo de configuração.
Ao clicar no nó Serviços , você pode exibir ou executar tarefas na Página de Resumo do serviço no Painel de Detalhes .
Criando uma nova configuração de serviço
Você pode criar uma nova configuração de serviço das seguintes maneiras:
Usando um assistente: clique no link Criar um novo serviço... no Painel de Tarefas ou na Página de Resumo para iniciar o assistente. Você também pode fazer isso no menu Arquivo ->Adicionar Novo Item.
Criar manualmente: você pode clicar com o botão direito do mouse no nó Serviços e escolher Novo Serviço.
Criando uma nova configuração de ponto de extremidade de serviço
Você pode criar uma nova configuração de ponto de extremidade de serviço das seguintes maneiras:
Criar usando um Assistente: clique no link Criar um Novo Ponto de Extremidade de Serviço... no Painel de Tarefas ou na Página de Resumo para iniciar o assistente. Você também pode fazer isso no menu Arquivo ->Adicionar Novo Item.
Criar manualmente: Depois de criar um Serviço, você pode clicar com o botão direito do mouse no nó Pontos de Extremidade e escolher "Novo Ponto de Extremidade de Serviço".
Editando uma configuração de serviço
Clique em um nó Serviço .
Edite as configurações nas grades de propriedades.
Editando uma configuração de ponto de extremidade de serviço
Clique em um nó Ponto de extremidade de serviço.
Edite as configurações nas grades de propriedades.
Adicionando um endereço base
Clique no nó Host .
Clique no botão Novo... na seção Endereços base .
Digite o URI do endereço base na caixa de diálogo.
Clique em OK.
Nota
Não é possível editar o valor de <baseAddressPrefixFilters> dentro desta ferramenta. Para adicionar ou modificar esse elemento, você deve usar um editor de texto ou Visual Studio.
Cliente
O nó Cliente exibe todos os pontos de extremidade do cliente no arquivo de configuração. Cada subnó na árvore corresponde a um subelemento do <client> elemento no arquivo de configuração.
Ao clicar no nó Cliente, você pode exibir ou executar tarefas na Página de Resumo do cliente no Painel de Detalhes.
Criando uma nova configuração de ponto de extremidade do cliente
Você pode criar uma nova configuração de ponto de extremidade do cliente das seguintes maneiras:
Criar por Assistente: Clique no link Criar um Novo Cliente... no Painel de Tarefas no canto inferior esquerdo da janela ou na Página de Resumo para iniciar o assistente. Você também pode fazer isso no menu Arquivo ->Adicionar Novo Item. O assistente solicita que você aponte para o local da configuração de serviço, a partir do qual a configuração do cliente é gerada. Em seguida, você pode escolher o ponto de extremidade de serviço ao qual se conectar.
Criar manualmente: clique com o botão direito do mouse no nó Pontos de extremidade em Cliente e escolha Novo ponto de extremidade do cliente.
Editando uma configuração de ponto de extremidade do cliente
Clique em um nó Ponto de extremidade do cliente.
Edite as configurações nas grades de propriedades.
Ponto final padrão
Pontos de extremidade padrão são pontos de extremidade especializados que têm um ou mais aspetos do endereço, contrato e vinculação definidos como valores padrão.
Essas definições de configuração são armazenadas no nó Ponto de extremidade padrão. O nó Ponto de extremidade padrão exibe todas as configurações de ponto de extremidade padrão no arquivo de configuração. Cada subnó na árvore corresponde a um subelemento no <standardEndpoints> elemento no arquivo de configuração.
Ao clicar no nó Ponto de extremidade padrão, você pode exibir ou executar tarefas na página de resumo do ponto de extremidade padrão no Painel de detalhes.
Criando uma nova configuração de ponto de extremidade padrão
Você pode criar uma nova configuração de ponto de extremidade padrão das seguintes maneiras:
Clique com o botão direito do mouse no nó Ponto de extremidade padrão e selecione Nova configuração de ponto de extremidade padrão... Selecione o tipo de associação na caixa de diálogo e clique em OK.
Selecione o nó Ponto de extremidade padrão e clique em Nova configuração de ponto de extremidade padrão... no Painel de Tarefas no canto inferior esquerdo da janela.
A caixa de diálogo Criando um novo ponto de extremidade padrão exibe e lista todos os tipos de ponto de extremidade padrão registrados.
Exibindo e editando uma configuração de ponto de extremidade padrão
Você pode abrir uma configuração de ponto de extremidade padrão para visualização e edição das seguintes maneiras:
Clique para expandir o nó Ponto de extremidade padrão e clique no respetivo subnó de ponto de extremidade.
Clique no nó Ponto de extremidade padrão e clique no respetivo ponto de extremidade no painel Detalhes.
Os atributos para o ponto de extremidade são mostrados no painel direito para edição.
Excluindo uma configuração de ponto de extremidade padrão
Você pode excluir uma configuração de ponto de extremidade padrão das seguintes maneiras:
Clique para expandir o nó Ponto de extremidade padrão e clique com o botão direito do mouse no respetivo subnó de ponto de extremidade. Use o comando de contexto Delete Standard Endpoint Configuration para excluir o ponto de extremidade.
Clique no nó Ponto de extremidade padrão. No painel de tarefas, clique em Excluir configuração de ponto de extremidade padrão.
Se o ponto de extremidade padrão estiver em uso, uma mensagem de aviso será exibida quando você tentar excluí-lo: O ponto de extremidade padrão está em uso. Se você excluí-lo agora, certifique-se de excluir todas as suas referências em outras partes da configuração (por exemplo, no ponto de extremidade do serviço ou no ponto de extremidade do cliente). Caso contrário, a configuração será inválida e não poderá ser aberta da próxima vez. Tem certeza de que deseja excluir o ponto de extremidade padrão?"
Enlace
As configurações de vinculação são usadas para configurar associações em pontos de extremidade. Essas definições de configuração são armazenadas no nó Vinculação . Os pontos de extremidade fazem referência a configurações de vinculação por nome e vários pontos de extremidade podem fazer referência a uma única configuração de vinculação.
O nó Ligações exibe todas as configurações de vinculação no arquivo de configuração. Cada subnó na árvore corresponde a um subelemento no <bindings> elemento no arquivo de configuração.
Ao clicar no nó Ligações, você pode exibir ou executar tarefas na Página de Resumo da Vinculação no Painel de Detalhes.
Criando uma nova configuração de vinculação
Você pode criar uma nova configuração de vinculação das seguintes maneiras.
Clique com o botão direito do mouse no nó Ligações e selecione Nova Configuração de Vinculação... Selecione o tipo de associação na caixa de diálogo e clique em OK.
Selecione o nó Ligações e clique em Nova Configuração de Vinculação... no Painel de Tarefas no canto inferior esquerdo da janela.
Na página de resumo do serviço ou do cliente, clique em Clique para Criar no campo Configuração de Vinculação para criar uma configuração de vinculação para o ponto de extremidade correspondente.
Adicionando extensões de elemento de vinculação a uma vinculação personalizada
Selecione a associação à qual você deseja adicionar um elemento de extensão.
Clique em Adicionar.
Na lista de extensões disponíveis, selecione a extensão de elemento de vinculação que você deseja adicionar. Para selecionar vários itens, pressione a tecla CTRL simultaneamente.
Clique em Adicionar.
Ajustando a posição da extensão em uma associação personalizada
Uma associação personalizada é uma coleção de elementos de ligação que formam uma pilha. Cada elemento de ligação na pilha tem suas próprias definições de configuração. A ordem das extensões do elemento de vinculação em uma associação personalizada indica suas posições na pilha. Os elementos na parte superior da pilha são aplicados primeiro. Para alterar a encomenda:
Selecione o nó de vinculação personalizado.
Selecione um elemento de extensão de vinculação na seção Posição de extensão do elemento de vinculação.
Use o botão Para cima ou Para baixo no lado esquerdo da lista para alterar a posição do elemento selecionado.
Editando a configuração de extensões de elemento de vinculação em uma associação personalizada
Selecione o nó de ligação na árvore.
Selecione a associação personalizada que contém o elemento que você deseja editar.
Selecione a extensão do elemento de vinculação que deseja editar. As configurações do elemento aparecem no painel direito, onde podem ser editadas.
Diagnóstico
O nó Diagnóstico exibe todas as configurações de diagnóstico no arquivo de configuração. Ele permite que você ative ou desative contadores de desempenho, habilite ou desabilite o WMI (Instrumentação de Gerenciamento do Windows), configure o rastreamento WCF e configure o log de mensagens WCF. As configurações no nó Diagnóstico correspondem à <system.diagnostics> seção e <diagnostics> à seção no <system.serviceModel> arquivo de configuração.
Ao clicar no nó Diagnóstico, você pode exibir ou executar tarefas na Página de Resumo do diagnóstico no Painel de Detalhes.
Configurando contadores de desempenho e WMI
Clique no nó Diagnóstico .
Clique em Alternar Contadores de Desempenho. O contador de desempenho tem três estados: Off (padrão), ServiceOnly e All. Clicar no link alterna a configuração entre esses três estados.
Configurando o provedor WMI
Clique no nó Diagnóstico .
Para habilitar o provedor WMI, clique no link Habilitar provedor WMI.
Ativando o rastreamento WCF
Você pode criar um arquivo de rastreamento WCF com propriedades padrão ou configurar um arquivo de rastreamento personalizado.
Clique no nó Diagnóstico .
Clique em Ativar rastreamento.
Clique no link Nível de rastreamento para ajustar o nível de rastreamento. Há seis níveis de rastreamento: Desativado, Crítico, Erro, Aviso, Informações e Detalhado. A opção Activity Tracing and Propagate Activity permite que você use o recurso de rastreamento de atividades do WCF.
Clique no nome do ouvinte de rastreamento para especificar o arquivo de rastreamento e as opções.
Habilitando o log do WCF
Você pode criar um arquivo de rastreamento WCF com propriedades padrão ou configurar um arquivo de rastreamento personalizado.
Clique no nó Diagnóstico .
Clique em Ativar Registo de Mensagens.
Clique no link Nível de log para ajustar o nível de log. Há três níveis de log: Malformado, Serviço e Transporte.
Clique no nome do ouvinte para especificar o arquivo de log e as opções.
Nota
Se desejar que os logs de rastreamento e mensagens sejam liberados automaticamente quando o aplicativo for fechado, habilite a opção Liberação automática .
A página Resumo do diagnóstico permite realizar as tarefas mais comuns na configuração do diagnóstico. No entanto, se quiser editar manualmente as configurações de Ouvintes e Fontes, expanda o nó Diagnóstico e edite as configurações no nó Registro de Mensagens, Ouvintes e Fontes.
Habilitando o rastreamento personalizado do WCF ou o registro de mensagens
Clique no nó Diagnóstico e expanda-o.
Clique com o botão direito do mouse no nó Ouvintes e selecione Novo Ouvinte.
Digite o nome do arquivo de rastreamento no campo InitData . Você pode clicar no botão "..." para navegar até um caminho.
Clicar na linha TypeName exibe um "..." botão. Clique neste botão para abrir o Navegador do tipo ouvinte de rastreamento, que você pode usar para localizar ouvintes de rastreamento pré-configurados que já estão instalados.
Observe a seção Fonte . Clique em Adicionar nesta seção para abrir uma caixa de diálogo com um menu suspenso, que lista as fontes de rastreamento disponíveis. Selecione uma fonte de rastreamento e clique em OK.
Para editar as configurações do Log de Mensagens, clique no nó Log de Mensagens . Você pode editar as configurações na grade de propriedades.
Avançado
Comportamentos
O nó Comportamentos exibe os comportamentos atualmente definidos no arquivo de configuração.
As configurações de comportamento são usadas para configurar comportamentos de pontos de extremidade e serviços. Essas definições de configuração são armazenadas no nó Avançado em Comportamentos de Serviço e Comportamentos de Ponto de Extremidade. Os comportamentos de serviço são usados pelos serviços; enquanto os comportamentos de ponto final por endpoints.
Comportamentos são uma coleção de elementos de extensão que para uma pilha. O elemento na parte superior da pilha é aplicado primeiro. Cada elemento de extensão pode ter sua própria configuração.
Criando uma nova configuração de comportamento
Você pode criar uma nova configuração de comportamento de duas maneiras.
Clique com o botão direito do mouse em um dos nós de comportamento e selecione "Nova configuração de comportamento...
Selecione um dos nós de comportamento e clique em Nova Configuração de Comportamento... no Painel de Tarefas no canto inferior esquerdo da janela.
Adicionando extensões de elemento de comportamento a um comportamento
Selecione um dos nós de comportamento.
Selecione o comportamento que deseja editar.
Clique em Adicionar.
Na lista de extensões disponíveis, selecione a extensão do elemento de comportamento que deseja adicionar.
Clique em Adicionar.
Ajustando a posição de extensão em um comportamento
Os comportamentos são coleções de elementos que formam uma pilha. Cada elemento na pilha tem sua própria configuração. A ordem das extensões do elemento de comportamento em um comportamento indica suas posições na pilha. Os elementos na parte superior da pilha são aplicados primeiro. Para alterar a encomenda:
Selecione um dos nós de comportamento.
Selecione o comportamento que deseja editar.
Selecione um elemento de extensão de comportamento na seção Posição de extensão do elemento de comportamento.
Use o botão Para cima ou Para baixo no lado esquerdo da lista para alterar a posição do elemento selecionado.
Editando a configuração de extensões de elemento de comportamento
Selecione um dos nós de comportamento na árvore.
Selecione o comportamento que contém o elemento que você deseja editar.
Selecione a extensão do elemento de comportamento que deseja editar. As configurações do elemento aparecem no painel direito, onde podem ser editadas.
Mapeamento de Protocolo
Esta seção permite que você defina tipos de vinculação padrão para diferentes protocolos, como http, tcp, MSMQ ou net.pipe, por meio do mapeamento definido entre esquemas de endereço de protocolo e as possíveis associações. Você também pode adicionar novos mapeamentos a outros protocolos.
Extensões
Novas extensões de ligação, extensões de elemento de ligação, extensões de ponto de extremidade padrão e extensões de comportamento podem ser registradas para uso na configuração do WCF. As extensões são pares nome/tipo. O nome define o nome da extensão na configuração, enquanto o tipo implementa a extensão. Existem quatro tipos de extensões:
As extensões de vinculação definem um tipo de vinculação inteiro. Exemplo:
basicHttpBinding.As extensões de elemento de vinculação definem um elemento de uma ligação. Exemplo:
textMessageEncoding.As extensões de ponto de extremidade padrão definem um ponto de extremidade padrão inteiro. Exemplo:
discoveryEndpoint.As extensões de elemento de comportamento definem um elemento de um comportamento. Exemplo:
clientVia.
As extensões que foram registradas na configuração podem ser usadas como qualquer outro componente WCF do mesmo tipo.
Adicionando uma nova extensão
Selecione um dos nós de extensão nos nós avançados:
Clique em Novo.
Insira um nome e um tipo.
Clique em OK.
A extensão agora aparece no lugar apropriado no Editor. Por exemplo, se você adicionar uma extensão de elemento de comportamento, ela aparecerá na lista de extensões disponíveis.
Ambiente de hospedagem
Esta seção permite definir configurações de instanciação para o ambiente de hospedagem de serviço.
Criando um arquivo de configuração usando o assistente
Uma maneira de criar um novo arquivo de configuração é usar o Assistente para Novo Elemento de Serviço. O assistente localiza os tipos de serviço instalados e outros elementos compatíveis com o WCF no computador, incluindo COM+ e diretórios virtuais hospedados na Web, e os carrega para tornar a criação da configuração muito mais simplificada.
Criando um arquivo de configuração
Inicie o Editor de Configuração de Serviço usando uma janela de comando para navegar até o local de instalação do WCF e digite
SvcConfigEditor.exe.No menu Arquivo, selecione Abrir e clique em Executável, Serviço COM+ ou Serviço WebHosted, dependendo do tipo de arquivo de configuração que você deseja criar.
Na caixa de diálogo Abrir, navegue até o arquivo específico para o qual deseja criar um arquivo de configuração e clique duas vezes nele.
No menu Arquivo, aponte para Adicionar Novo Item e clique em Serviço. O Assistente para Novo Elemento de Serviço é aberto.
Siga as etapas no assistente para criar o novo serviço.
Nota
Se você quiser usar o NetPeerTcpBinding do arquivo de configuração gerado pelo assistente, você precisa adicionar manualmente um elemento de configuração de ligação e modificar o mode atributo de seu security elemento para "None".
Configurando o COM+
O Editor de Configuração de Serviço permite criar um novo arquivo de configuração para um aplicativo COM+ existente ou editar uma configuração COM+ existente. O nó Contrato COM só é visível quando a <comContract> seção existe no arquivo de configuração.
Criando uma nova configuração COM+
Antes de criar uma nova configuração COM+, verifique se o aplicativo COM+ está instalado nos Serviços de Componentes e registrado no GAC (Global Assembly Cache).
Selecione o menu Arquivo ->Integrar ->COM+ Application. Esta operação fecha o arquivo aberto atual. Se houver dados não salvos no arquivo atual, uma caixa de diálogo Salvar será exibida. O Assistente de Integração COM+ é então iniciado.
Na primeira página, selecione o aplicativo COM+ na árvore. Se você não conseguir encontrar seu aplicativo COM+ na árvore, verifique se ele está instalado nos Serviços de Componentes e registrado no GAC (Global Assembly Cache).
Na página seguinte, selecione qual(is) método(s) você deseja expor como serviços WCF. Todos os métodos suportados no aplicativo COM+ são exibidos e selecionados por padrão.
Escolha um método de hospedagem.
Configure outras configurações de acordo com os guias do assistente.
O Service Configuration Editor utiliza ComSvcConfig.exe em segundo plano para gerar o arquivo de configuração. Depois que isso for concluído, você poderá exibir um resumo e sair do assistente. O arquivo de configuração gerado é aberto para que você possa editá-lo diretamente.
Editando uma configuração COM+ existente
Selecione o menu Arquivo ->Open ->COM+ Service...
Selecione o serviço COM+ que deseja editar na lista.
Edite as definições de configuração no nó Contratos COM.
Nota
Você também pode abrir e editar diretamente um arquivo de configuração que contenha contratos COM.
Segurança
Não é garantido que um arquivo de configuração de serviço gerado pelo Editor de configuração seja seguro. Consulte a documentação de segurança para saber como proteger seus serviços WCF.
Além disso, o Editor de configuração só pode ser usado para ler e gravar elementos de configuração WCF válidos. A ferramenta ignora elementos compatíveis com o esquema e definidos pelo usuário. Ele também não tenta remover esses elementos do arquivo de configuração ou determinar seus efeitos sobre os elementos WCF conhecidos. É da responsabilidade do utilizador determinar se estes elementos representam uma ameaça para a aplicação ou para o sistema.