Compartilhar via

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

  • Artigo

No aplicativo Designer, você pode definir os aplicativos ASP.NET que expõem serviços de Web com base em arquivo .asmx, o conteúdo do documento da Web ou ambos, adicionando ou usando pontos de extremidade apropriados.Quando você adiciona um aplicativo Web de serviço Web ASP.NET ou um aplicativo Web ASP.NET para o diagrama de aplicativo Web, a definição de aplicativo Web possui um serviço Web padrão ou ponto de extremidade de provedor de conteúdo da Web, respectivamente.No entanto, você pode adicionar ou remover pontos de extremidade de provedor de qualquer tipo em um aplicativo ASP.NET.Você também pode substituir serviço Web pontos de extremidade de provedor em aplicativos ASP.NET.

Para obter mais informações, consulte os seguintes tópicos:

As seções a seguir contêm mais informações sobre aplicativos ASP.NET no diagrama de aplicativo:

  • Definir serviços da Web em aplicativos ASP.NET

  • Definição de aplicativos da Web do ASP.NET

  • Implementação de aplicativos da Web

  • Implementação de aplicativos de consumidor do serviço Web

Definir serviços da Web em aplicativos ASP.NET

Um serviço Web em um aplicativo ASP.NET é representado por um ponto de extremidade de provedor de serviços Web.Um ponto de extremidade do consumidor de serviço Web em todos os aplicativos representa um ponto de conexão para um serviço da Web.Você pode definir, revisar e edição operações dos serviços da Web em aplicativos ASP.NET.

Definir, revisão e operações de edição

No Designer de Aplicativos, definir, exibir e edição as operações e parâmetros para cada serviço Web em um aplicativo ASP.NET por meio de seu ponto de extremidade de provedor de serviços Web correspondente.

Dica:

Designer de Aplicativos também suporta uma abordagem orientada por contrato em que você pode criar um ponto de extremidade de provedor de serviços Web em um aplicativo ASP.NET com assinaturas de operação predefinidas e tipos com base em um arquivo WSDL existente ou o arquivo .Discoteca.Para obter mais informações, consulte Web Service Endpoints Baseados em Arquivos WSDL.

Você pode definir uma ou mais operações usando os seguintes elementos:

  • Nome da operação e tipo de retorno, se apropriado.

  • Parâmetros de operação, incluindo seus nomes, tipos, se apropriado e modificadores que descrevem como passar cada parâmetro.

  • Comentários opcionais para cada operação ou parâmetro.

Para obter mais informações, consulte Como: Definir operações para serviços Web do ASP.NET.

Definindo operações na janela Detalhes do Serviço Web

No Designer de Aplicativos, você pode usar a janela Detalhes do Serviço Web para definir, exibir ou edição operações para um ponto de extremidade de provedor de serviços da Web em um aplicativo ASP.NET.Para serviço Web s nos aplicativos ASP.NET implementados, esta janela mostra serviço Web operações corretamente somente quando os correspondentes métodos da Web são totalmente declarados dentro de uma definição de classe único em um arquivo de código separados ou arquivo "code-behind".

A tabela a seguir descreve situações quando a janela Detalhes do serviço Web não mostrará corretamente as operações do serviço Web.

Cenário

Janela Detalhes do Serviço Web

O arquivo.asmx contém serviço Web classe definição in-line.

Não mostra todas as operações.

Métodos Web por atributos declarados nos métodos de uma interface implementada por uma classe de serviço Web.

- ou -

Uma classe estende uma classe básica que define métodos da Web.

Mostra somente as operações correspondentes aos métodos da Web declarados na classe referenciada pelo arquivo .asmx.

Arquivos code-behind que definem os serviços da Web que contém várias ligações.

Mostra somente as operações associadas à primeira vinculação.

Para obter mais informações, consulte Considerações sobre a engenharia de Reverse em soluções existentes.

Fazendo referência a tipos de operações e parâmetros

Fazendo referência a um tipo para uma operação ou o parâmetro é apropriado dependendo da linguagem de programação escolhida para o aplicativo.Ao definir uma operação ou o parâmetro, você pode escolher uma das seguintes ações:

  • Deixar o tipo sistema autônomo vazio ou conjunto padrão conforme apropriado.

  • escolher um tipo de lista do tipo IntelliSense.

  • Fazer referência a um tipo definido no Outros digite bibliotecas e projetos, se uma referência a essas bibliotecas ou projetos existir no projeto de aplicativo.

  • Fazer referência a um tipo que você pretende definir em uma posterior time.

Quando você define as operações e parâmetros usando a janela Detalhes do serviço Web, suporte a IntelliSense está disponível para fazer referência a tipos para Visual Basic e Visual translation from VPE for Csharp.Depois que o aplicativo é implementado, você pode definir novos tipos ou redefinir tipos existentes.Para obter mais informações, consulte Como: Definir a operação e tipos de parâmetros para serviços Web do ASP.NET.

Definição de aplicativos da Web do ASP.NET

Designer de Aplicativos, um ponto de extremidade de provedor de conteúdo da Web em um aplicativo ASP.NET representa um ponto de conexão com a qual conteúdo da Web for exposto, por exemplo, arquivos HTML ou ativo servidor Pages (arquivos .aspx).Um ponto de extremidade de consumidor de conteúdo da Web em qualquer aplicativo representa um ponto de conexão de cliente para conteúdo da Web.

Pontos de extremidade de conteúdo da Web não oferecem suporte a geração de código ou a sincronização, nem eles gerar e sincronizar com entradas do arquivo de configuração (config) de aplicativo.No entanto, você pode usar esses pontos de extremidade para requisitos de documentos e conjunto restrições sobre o suporte de conteúdo Web para um site hospedado em um servidor Web.

Para obter mais informações, consulte os seguintes tópicos:

Implementação de aplicativos da Web

Ao implementar um aplicativo ASP.NET, o Visual Studio gera projeto correspondente com os arquivos de projeto apropriada.Você pode implementar aplicativos do ASP.NET sistema autônomo projetos da Web do ASP.NET Development servidor (arquivo baseados no sistema) ou sistema autônomo projetos da Web Serviços de Informações da Internet (Serviços de Informações da Internet) (baseado em HTTP).Para obter mais informações, consulte Tipos de aplicativo e protótipos para definir aplicativo s e Como: escolher o tipo de site da Web para aplicativos ASP.NET.

Todos sistema autônomo projetos de aplicativo ASP.NET inclui um arquivo de configuração Web.config sistema autônomo parte do projeto raiz no gerenciador de soluções.Para um aplicativo ASP.NET com um ou mais extremidades de provedor de serviços Web, o projeto também inclui um arquivo .asmx e um arquivo de classe de serviço Web, é um arquivo de código específico da linguagem de programação ou "arquivo code-behind", para cada ponto de extremidade de provedor de serviços da Web.

Na classe de serviço Web, uma vinculação WSDL com uma ligação única e uma única porta está associada a cada ponto de extremidade de provedor de serviços Web.Cada operação de serviço Web, junto com qualquer comentário é exibido sistema autônomo um método rotulado com o WebMethod atributo na classe de serviço Web. Para qualquer serviço Web pontos de extremidade de provedor criados a partir de um arquivo WSDL ou .Discoteca, arquivos de classe definindo quaisquer tipos XML complexos que suporte a serialização XML para operações no arquivo WSDL ou arquivos de esquema do XML relacionados também estão incluídas no projeto de aplicativo.Em seguida, você pode concluir implementação de cada operação, adicionando o código de corpo de método necessário.Para obter mais informações, consulte Web Service Endpoints Baseados em Arquivos WSDL.

Observação:

Qualquer descrições WSDL que você especificar na operação comentários também aparecem no arquivo WSDL.Você também pode personalizar a geração do arquivo WSDL.Para obter mais informações, consulte Geração de arquivo WSDL para serviços Web do ASP.NET.

Enquanto o código-fonte para um aplicativo implementado é considerado a definição do mestre, as alterações feitas para uma Web do ASP.NET serviço no Designer de Aplicativos, a janela Detalhes do serviço Web ou um editor de código sincronizar entre si quando o diagrama de aplicativo é em aberto.No entanto, um diagrama fechado serão sincronizados com alterações no código próximo time abre o diagrama.Para obter mais informações, consulte Como: Implementar Applications on aplicativo Diagrams.

Atribuições de porta dinâmico para aplicativos da Web do ASP.NET

Ao implementar um arquivo aplicativo ASP.NET com base em sistema, que gera um projeto ASP.NET Development servidor Web, um número da porta é atribuído ao site associado.Que arquivo baseado em sistema ASP.NET aplicativos são definidos para usar portas dinâmicas por padrão, pode alterar esse número da porta.

Dica:

Você pode exibir o número da porta na janela Propriedades, clicando com o botão direito do mouse o projeto de aplicativo ASP.NET em gerenciador de soluções.

Por exemplo, novos números de porta são atribuídos a aplicativos de ASP.NET baseados em sistema de arquivos em qualquer uma das seguintes condições:

  • Ao abrir uma solução que contém esses tipos de aplicativos ASP.NET, bem sistema autônomo implementados Web serviço consumidor aplicativos com referências a serviços Web expostos por esses aplicativos ASP.NET.

  • Ao utilizar o depurador do Visual Studio pela primeira vez em uma solução que contém esses tipos de aplicativos ASP.NET.

Se projetos de aplicativos de consumidor de serviço Web associados estiverem na mesma solução, elas são atualizadas automaticamente.No entanto, se eles não estiverem na mesma solução, por exemplo, se eles estiverem em soluções particionadas, suas referências da Web não serão atualizadas e aponte para serviços da Web inexistentes.

Observação:

Se você estiver usando o controle do código-fonte e projetos de aplicativos de consumidor de serviço Web associados são verificados no controle de código-fonte, você deve fazer check-out desses projetos para atualizar as referências da Web.

Para controlar a atribuição de números de porta, você pode conjunto o projeto de um aplicativo ASP.NET sistema-based de arquivo para não usar portas dinâmicas.

Observação:

Depois de especificar para não usar portas dinâmicas, iniciar o depurador do Visual Studio pode gerar um erro que a porta existente está em uso.Nesse caso, você deve alterar o número da porta manualmente para o projeto Web site.Quando você altera o número da porta, o Visual Studio gera um aviso que referências da Web existentes se tornarão inválidas.Se o diagrama de aplicativo estiver em aberto, as referências da Web são atualizadas.No entanto, se o diagrama de aplicativo não estiver em aberto, você deve excluir e adicione de volta essas referências da Web.

Para obter mais informações, consulte os seguintes tópicos:

Implementação de aplicativos de consumidor do serviço Web

Quando você implementar um aplicativo com um ou mais Web serviço ponto de extremidade de consumo s, uma referência da Web é gerada para cada serviço Web ponto de extremidade de consumo, se o arquivo WSDL usado para gerar a referência da Web está disponível.Este arquivo WSDL é especificado pela propriedade WSDL local no serviço Web ponto de extremidade consumidor.Quando a referência da Web é gerada, a URL do serviço Web no arquivo de configuração do aplicativo cliente também é gerada.

Observação:

Se um ASP.NET conectados serviço Web provedor de aplicativo é implementado ao mesmo time, o arquivo WSDL estará disponível durante a implementação.No entanto, se o conectados serviço Web provedor aplicativo não é implementado quando o ponto de extremidade de consumo é implementado, o ponto de extremidade de consumo exibe um aviso indicando que o ponto de extremidade de consumo não poderia ser implementado.Quando um serviço Web provedor de aplicativo é implementado, quaisquer pontos de extremidade consumidor conectadas são implementados automaticamente se o aplicativo do cliente for implementado.Para obter mais informações, consulte Solução de problemas aplicativo Diagrams.

Lida com a referência da Web Criando o cliente de serviço Web classe proxy e tipos de proxy para chamar operações de serviço Web e manipulando a comunicação de mensagens SOAP.Você também pode fazer engenharia reversa e visualizar personalizados da Web cliente classes de proxy de serviço, incluindo sistema autônomo classes de proxy personalizado e Web referências definidas em bibliotecas de classe, sistema autônomo pontos de extremidade consumidor do serviço Web.Para obter mais informações, consulte Creating an Proxy Serviço Web XML e Considerações para classes personalizadas da serviço Web cliente proxy.

Observação:

Você também pode ativar a documentação XML do Windows ou serviço Web aplicativo do cliente após a implementação para incluir comentários de operação em um arquivo XML.Este arquivo é gerado depois de criar o projeto de aplicativo.Para gerar o arquivo XML, você deve habilitar documentação XML do projeto Windows.Para projetos do Visual Basic Windows, consulte Como: Gerar documentação XML para um Projeto.Para projetos Visual translation from VPE for Csharp Windows, consulte Como: Definir propriedades de compilação (C#) e Compilação de página, Designer de projeto c (#).

Consulte também

Outros recursos

Definindo ASP.NET Applications on aplicativo Diagrams