Compartilhar via

Considerações para classes personalizadas da serviço Web cliente proxy

  • Artigo

No Distributed sistema Designers, pontos de extremidade consumidor em aplicativos representam pontos de conexão configuráveis para pontos de extremidade do provedor.Quando uma instância de uma definição de sistema composta desses aplicativos for implantada, pontos de extremidade consumidor nesses aplicativos são configurados com os endereços de pontos de extremidade quaisquer provedor conectados.Para obter mais informações, consulte Visão geral dos pontos de extremidade em aplicativos e Visão geral dos sistemas de aplicativos.

Para pontos de extremidade de serviço Web consumidor, é necessário o uso de "dinâmicos" Web cliente classes de proxy de serviço que recuperar as URLs conectados Web serviço provedor de pontos de extremidade de entradas do arquivo de configuração da aplicativo apropriado em time de execução.

Observação:

Para um aplicativo que ofereça suporte a implementação, o Visual Studio gera um arquivo de configuração para o aplicativo durante a implementação do diagrama de aplicativo.O arquivo de configuração é incluído sistema autônomo parte do projeto de aplicativo no gerenciador de soluções.Para obter mais informações, consulte Como: Implementar Applications on aplicativo Diagrams.

Por padrão, Designer de Aplicativos gera referências da Web para esses pontos de extremidade de serviço Web consumidor nos aplicativos ASP.NET, Windows e Office.Essas referências da Web, em seguida, criar as classes de proxy dinâmica apropriado com o correspondente arquivo de configuração entradas.

Observação:

Se você usar referências da Web estáticas em um aplicativo ou em uma biblioteca de classes referenciadas, essas referências da Web não são detectadas pelo Designer de Aplicativos e não são visualizadas sistema autônomo pontos de extremidade de serviço Web consumidor, mesmo que eles podem função corretamente.É recomendável que você use referências Web dinâmicas, sempre, mesmo se você não for para a URL do serviço Web alterar a implantação.

As seções a seguir contêm obter mais informações sobre como usar classes de proxy cliente de serviço Web personalizadas em vez de classes de proxy dinâmico:

  • Representing Custom Web Service Client Proxy Classes as Web Service Consumer Endpoints

  • Configuration File Entries for Custom Web Service Proxy Client Classes Used with Windows and Office Applications

  • Configuration File Entries for Custom Web Service Proxy Classes Used with ASP.NET Applications

  • Migrating Web References and Custom Proxy Classes from Visual Studio .NET 2003

Representando classes personalizadas da Web Service cliente proxy sistema autônomo pontos finais de consumidor de serviço Web

Designer de Aplicativos suporta o design de pontos de extremidade de serviço Web consumidor que são implementados por referências da Web.No entanto, você também pode fazer engenharia reversa e visualize classes de proxy personalizado criada manualmente sistema autônomo pontos de extremidade consumidor do serviço Web, contanto que sistema autônomo entradas apropriadas existem no arquivo de configuração do aplicativo de consumidor (App.config ou Web.config).

Um ponto de extremidade do consumidor de serviço Web aparece no aplicativo de consumidor para cada entrada de arquivo de configuração do Designer de Aplicativos identifica sistema autônomo que representa uma configuração de URL do serviço da Web para uma classe de proxy personalizado.Além disso, se a URL do serviço Web na entrada do arquivo de configuração corresponder a URL de uma empresa de provedor de serviços da Web existente no diagrama de aplicativo, uma conexão aparece entre o ponto de extremidade de consumo e o ponto de extremidade de provedor de serviços da Web.Se nenhum ponto de extremidade de provedor de serviços Web correspondente existe, mas a URL pode ser usada para localizar um arquivo WSDL válido para o serviço da Web, acrescentando "? wsdl"ou"? Discoteca" a URL, em seguida, um serviço Web externo é adicionado ao diagrama de aplicativo e está conectado ao serviço da Web ponto de extremidade de consumo.Se um arquivo WSDL não puder ser localizado usando a URL do serviço Web ponto de extremidade de consumo permanece desconectado.

As entradas do arquivo de configuração que representam as configurações de URL de serviço Web e da forma que o aplicativo Designer identifica-los diferem entre aplicativos ASP.NET e aplicativos Windows ou do Office.sistema autônomo diretrizes a seguir descrevem sistema autônomo você pode garantir que sistema autônomo classes de proxy personalizado são representados corretamente sistema autônomo pontos de extremidade de serviço Web consumidor em cada tipo de aplicativo.

Observação:

Não seguir essas diretrizes pode produzir ainda classes de proxy personalizado que funcionem corretamente em time de execução; Entretanto, essas classes serão representadas sistema autônomo pontos de extremidade consumidor do serviço Web, não serão conectadas no diagrama de aplicativo, não serão validadas para implantação, não serão relatadas sistema autônomo pontos de extremidade no relatório de implantação e não estarão disponível para configuração de ponto de extremidade usando sistema autônomo ferramentas de implantação disponível.

arquivo de configuração Entradas para classes personalizadas da Web Service Proxy clientee usados com o Windows e aplicativos do Office

Para classes de proxy personalizado usados com aplicativos Windows e do Office, as configurações de URL de serviço Web devem aparecer em um applicationSettings entrada no arquivo app.config configuração do aplicativo cliente. Não é possível exibir ou edição essas configurações usando Editor de Configurações e Restrições, portanto, você deve criar ou edição essas configurações usando o Configurações painel acessada clicando com o botão direito do mouse o projeto de aplicativo Windows ou do Office e exibindo as propriedades do projeto.Você também deve designar essas configurações sistema autônomo WebServiceURL ou String Digite. Para obter mais informações, consulte Gerenciando definições de aplicativo.

Observação:

O WebServiceURL designação de tipo não aparece no arquivo de configuração do config.XML; no entanto, ele é armazenado em um arquivo de configurações associadas normalmente ocultas. Se você manualmente adiciona a configuração no arquivo de configuração do App.config, você deve adicionar o WebServiceURL ou String Digite a designação sistema autônomo uma configuração na Configurações painel.

No Configurações painel, você pode escolher Aplicativo or Usuário escopo para a configuração se você designar sistema autônomo WebServiceURL Digite. Alterar o escopo move a entrada para o applicationSettings ou userSettings seção do arquivo de configuração. No entanto, se você quiser designar a configuração sistema autônomo um String tipo, você deve escolher Aplicativo para o escopo.

Dica:

Ao especificar uma configuração de URL do serviço Web no arquivo de configuração.XML, especifique o local do serviço Web, não o local da descrição do serviço Web ou arquivo WSDL.Para baseado em arquivo Web services .asmx, a descrição do serviço Web costuma no mesmo local sistema autônomo o local do WSDL.Portanto, para serviços Web baseados em arquivos de .asmx, Designer de Aplicativos será presumir que o local do serviço Web é o mesmo que o local do arquivo WSDL.Se um arquivo WSDL for encontrado nesse local, um serviço Web externo está com engenharia reversa para o diagrama de aplicativo e conectado a um serviço da Web com engenharia reversa ponto de extremidade de consumo.Se não for encontrado um arquivo WSDL válido nesse local, somente serviço Web ponto de extremidade de consumo é com engenharia reversa.

O exemplo a seguir mostra sistema autônomo um applicationSettings entrada poderá ser exibida em um arquivo de configuração do config.XML de um projeto do Windows quando a configuração é designada sistema autônomo String tipo:

<applicationSettings>
   <WindowsApplicationName.MySettings>
      <setting name="WindowsApplicationName_Namespace_WebServiceProxyClassName" serializeAs="String"><value>http://WebServiceURL.asmx</value></setting>
   </WindowsApplicationName.MySettings>
</applicationSettings>

Para entradas com WebServiceURL tipo, o nome da configuração não precisa ser o nome de classe proxy. Uma entrada do arquivo de configuração que é definida dessa maneira e designada com o WebServiceURL ou String Digite o Configurações painel é tudo o que é necessário para criar um serviço Web ponto de extremidade de consumo em um aplicativo Windows ou do Office, mesmo que nenhuma classe de proxy personalizado é associado à entrada.Excluir um ponto de extremidade exclui a entrada, mas não exclui a classe de proxy personalizado associado.

Configuração entradas de arquivo para classes personalizadas da serviço Web Proxy usados com aplicativos ASP.NET

ASP.NET não fornece uma maneira de especificar uma entrada de arquivo de configuração representa uma URL de serviço Web.Portanto, o aplicativo Designer tenta corresponder aos nomes das entradas do arquivo de configuração com nomes de classe de proxy.As seguintes diretrizes se aplicam a entradas do arquivo de configuração para as classes de proxy personalizado usados com aplicativos ASP.NET:

  • Um serviço Web ponto de extremidade de consumo aparece somente se uma classe proxy com um nome correspondente for encontrada no projeto de aplicativo do consumidor ou em qualquer projeto referenciado ou assembly.

  • Se a classe de proxy personalizado for usada somente com aplicativos ASP.NET, a URL do serviço Web deve aparecer em um appSettings entrada no arquivo de configuração de Web.config do aplicativo ASP.NET. O nome da entrada do arquivo de configuração deve ser o nome de classe proxy totalmente qualificado.Você pode edição o appSettings entrada no arquivo Web.config usando Editor de Configurações e Restrições. Para obter mais informações, consulte Configurações e editor restrições e Aplicando as configurações.

  • Se a classe de proxy personalizado for usada com aplicativos Windows e do Office, bem sistema autônomo aplicativos ASP.NET, a URL do serviço Web deve aparecer em um applicationSettings entrada no arquivo de configuração de Web.config do aplicativo ASP.NET. O nome da entrada do arquivo de configuração deve ser o nome de classe proxy totalmente qualificado como prefixado o nome do projeto, que é o formato padrão usado por referências da Web geradas automaticamente.Você pode edição o applicationSettings entrada na Web. arquivo de configuração usando o editor de configuração e restrições. The applicationSettings seção não oferece suporte a sintaxe de pontos (.) para nomes de configuração; use caracteres de sublinhado (_).

O exemplo a seguir mostra como um appSettings entrada pode ser exibida no arquivo Web.config:

<appSettings>
   <add key="Namespace.WebServiceProxyClassName" value="https://localhost/WebServiceApplicationName/WebServiceName.asmx"/>
</appSettings>

O exemplo a seguir mostra sistema autônomo um applicationSettings entrada pode ser exibida no arquivo Web.config, que é o mesmo que a entrada usada no arquivo de configuração.XML, de um aplicativo Windows ou do Office:

<applicationSettings>
   <WindowsApplicationName.MySettings>
      <setting name="WindowsApplicationName_Namespace_WebServiceProxyClassName" serializeAs="String"><value>http://WebServiceURL.asmx</value></setting>
   </WindowsApplicationName.MySettings>
</applicationSettings>

Excluir um ponto de extremidade de serviço Web consumidor que representa uma classe de proxy personalizado remove a entrada de arquivo de configuração associada, mas não exclui a classe proxy associado.Excluir ou renomear a classe de proxy personalizado não remove a entrada do arquivo de configuração associada; no entanto, o ponto de extremidade de consumo correspondente é removido porque não há uma classe de proxy não está mais com um nome correspondente.Volta adicionando uma classe proxy com um nome correspondente ou renomear uma classe de proxy existente para corresponder à entrada do arquivo de configuração faz com que o ponto de extremidade reaparecer.

Migrando referências da Web e classes personalizadas da serviço Web cliente proxy do Visual Studio .NET 2003

As entradas de arquivo de configuração associada para as referências da Web que são adicionadas a projetos do Windows ou do Office usando o Visual Studio .NET 2003 são armazenadas em um appSettings seção em vez da applicationSettings seção. Ao atualizar um projeto Visual Studio.NET 2003 Windows ou o Office usando o Assistente de conversão, faz referência a Web e classes de proxy personalizado não a migrar do appSettings seção para o applicationSettings seção automaticamente. Para obter mais informações sobre o Assistente de conversão, consulte Assistente de conversão do Visual Studio.

No entanto, referências da migram automaticamente quando classes de proxy são regenerados, por exemplo, quando a correspondente da Web de serviços de alterar ou se você atualizar manualmente a referência da Web.Uma nova configuração aparece no applicationSettings seção para cada referência da Web e é usado por classes proxy atualizadas. Após o applicationSettings a seção é atualizada, os pontos de extremidade consumidor serviço de Web de correspondentes e conexões aparecem no diagrama de aplicativo. Para obter mais informações, consulte Como: Atualizar referências da Web a Web Services on aplicativo Diagrams.

Se você deseja exibir pontos de extremidade de serviço Web consumidor para classes de proxy personalizado, você deve migrar essas classes manualmente.Você pode executar essa tarefa, atualizando as classes de proxy para usar o applicationSettings seção e adicionar as configurações apropriadas usando o Configurações painel disponível através das propriedades de projeto de aplicativo do Windows ou do Office.Para obter mais informações, consulte Gerenciando definições de aplicativo.

Consulte também

Conceitos

Visão geral dos pontos de extremidade em aplicativos

Visão geral do ASP.NET Applications on aplicativo Diagrams

Referência

Web References e classes de proxy clientee serviço Web personalizadas em bibliotecas de classes

Tipos de aplicativo e protótipos para definir aplicativo s

Outros recursos

Definindo Applications on aplicativo Diagrams