Apostila Visual Studio - _pt-br

ÍNDICECONTROLE DE CÓDIGO FONTE PARA O VISUAL STUDIO......................................................................... 6 INTRODUÇÃO AO CONTROLE DE ORIGEM ................................................................................................................... 6 O QUE HÁ DE NOVO NO CONTROLE DE ORIGEM PARA O VISUAL STUDIO ................................................................. 13 EXECUÇÃO DE TAREFAS DE CONTROLE DE ORIGEM ............................................................................................... 14 COMO: ADICIONAR UM PROJETO AO CONTROLE DE ORIGEM .................................................................................. 14 COMO: ACOPLAR OU DESACOPLAR UMA SOLUÇÃO OU PROJETO ............................................................................ 15 COMO: ALTERAR O LOCAL DA PASTA DE TRABALHO ............................................................................................. 16 COMO CONECTAR OU DESCONECTAR UMA SOLUÇÃO OU UM PROJETO ..................................................................... 16 COMO: COPIAR UM ITEM SOB CONTROLE DE ORIGEM ............................................................................................. 17 COMO: EXCLUIR UM ITEM CONTROLADO POR ORIGEM ........................................................................................... 18 COMO ATIVAR RECUPERAÇÃO AUTOMÁTICA........................................................................................................... 19 COMO DESATIVAR A CRIAÇÃO DA PASTA <SOLUTIONNAME>.ROOT ........................................................................ 19 COMO: ATIVAR CHECK-INS AUTOMÁTICOS ........................................................................................................... 19 COMO: DESATIVAR CHECK-OUTS AUTOMÁTICOS ................................................................................................... 20 COMO: ATIVAR OU DESATIVAR CONTROLE DE ORIGEM.......................................................................................... 20 COMO: EXCLUIR UM ARQUIVO DE CONTROLE DE ORIGEM ...................................................................................... 21 COMO: MOVER UMA RAIZ DE LIGAÇÃO DE PROJETO .............................................................................................. 21 COMO: MOVER UM ITEM CONTROLADO POR FONTE ............................................................................................... 22 COMO: ABRIR UM PROJETO OU SOLUÇÃO DO CONTROLE DE ORIGEM ..................................................................... 22 COMO: RENOMEAR UM ITEM CONTROLADO POR ORIGEM ...................................................................................... 23 COMO: DEFINIR OPÇÕES DE PLUG-IN...................................................................................................................... 24 COMO: TROCAR PLUG-INS DE CONTROLE DE ORIGEM:............................................................................................. 25 COMO: EXIBIR UMA LISTA DE ARQUIVOS COM CHECK-OUT.................................................................................... 25 REFERÊNCIA A INTERFACE DO USUÁRIO DO CONTROLE DE ORIGEM........................................................................ 25 CAIXA DE DIÁLOGO CHANGE SOURCE CONTROL .................................................................................................... 26 CAIXA DE DIÁLOGO CHECK IN (CONTROLE DE CÓDIGO FONTE) ............................................................................. 27 CHECK-OUT PARA A CAIXA DE DIÁLOGO EDIT (CONTROLE DE ORIGEM).................................................................. 28 CAIXA DE DIÁLOGO GET (CONTROLE DE ORIGEM)................................................................................................... 29 JANELA DE CHECK-INS PENDENTES ......................................................................................................................... 30 GUIAS DE PLUG-IN PARA CONTROLE DE ORIGEM (CAIXA DE DIÁLOGO OPTIONS)..................................................... 31 CAIXA DE DIÁLOGO SOURCE CONTROL ................................................................................................................... 34 CAIXA DE DIÁLOGO UNDO CHECKOUT (CONTROLE DE CÓDIGO FONTE)................................................................. 35 CONFIGURAÇÕES DO VISUAL STUDIO .......................................................................................................... 36 COMO: ALTERAR CONFIGURAÇÕES SELECIONADAS ................................................................................................ 37 TRABALHANDO COM CONFIGURAÇÕES.................................................................................................................... 38 COMO: COMPARTILHAR CONFIGURAÇÕES ENTRE COMPUTADORES ....................................................................... 38 COMO: ESPECIFICAR CONFIGURAÇÕES PARA UMA EQUIPE ...................................................................................... 40 IMPORT AND EXPORT SETTINGS WIZARD................................................................................................................ 40 ESCOLHA CONFIGURAÇÕES PARA EXPORTAR, IMPORTAR E EXPORTAR CONFIGURAÇÕES ASSISTENTE .................... 41 NOMEIE O ARQUIVO DE CONFIGURAÇÕES, IMPORTAR E EXPORTAR CONFIGURAÇÕES ASSISTENTE ......................... 41 SALVAR CONFIGURAÇÕES ATUAIS, IMPORTAR E ASSISTENTE PARA EXPORTAÇÃO CONFIGURAÇÕES ....................... 41 ESCOLHA CONFIGURAÇÕES PARA IMPORTAR, IMPORTAR E ASSISTENTE CONFIGURAÇÕES EXPORTAÇÃO ............... 42 ESCOLHA UM COLEÇÃO DE CONFIGURAÇÕES PARA IMPORTAR, IMPORTAR E ASSISTENTE CONFIGURAÇÕES EXPORTAÇÃO .......................................................................................................................................................... 42 <TASK> COMPLETE, IMPORT AND EXPORT SETTINGS WIZARD ............................................................................... 43 WALKTHROUGHS VISUAL C# ........................................................................................................................... 44 EXPLICAÇÃO PASSO A PASSO: CRIANDO UM XML WEB SERVICES USANDO VISUAL BASIC OU VISUAL C# ........... 44 PASSO-A-PASSO: ACESSANDO UM XML WEB SERVICES UTILIZANDO VISUAL BASIC OU VISUAL C# ..................... 48 UM COMPONENTE COM VISUAL C# WALKTHROUGH: CRIAÇÃO .............................................................................. 53 TAREFAS COMUNS USANDO MARCAS INTELIGENTES EM CONTROLES FORMS WINDOWS FAZENDO WALKTHROUGH: ................................................................................................................................................................................ 57 COLEÇÕES DOS TIPOS PADRÃO COM O DESIGNERSERIALIZATIONVISIBILITYATTRIBUTE SERIALIZING WALKTHROUGH:..................................................................................................................................................... 58 WALKTHROUGH: DEPURAÇÃO CONTROLES FORMS DO WINDOWS PERSONALIZADOS EM TEMPO DE DESIGN ........... 61 CRIANDO UM CONTROLE DO WINDOWS FORMS QUE TAKES ADVANTAGE DOS RECURSOS DE TEMPO DE DESIGN VISUAL STUDIO WALKTHROUGH:............................................................................................................................ 64 UM CONTROLE COMPOSTO COM VISUAL C# WALKTHROUGH: CRIAÇÃO ................................................................. 84 UM COMPONENTE MULTITHREADED SIMPLE COM VISUAL C# WALKTHROUGH: CRIAÇÃO ..................................... 92 Visual Studio 1 WALKTHROUGH: INHERITING A PARTIR DE UM CONTROLE DO WINDOWS FORMS COM VISUAL C# ...................... 100 EXPLICAÇÕES PASSO-A-PASSO DO VISUAL STUDIO .............................................................................. 104 WALKTHROUGHS DE APLICATIVOS CLIENTE RICH ................................................................................................ 104 WALKTHROUGH: CRIANDO UM APLICATIVO CLIENTE RICH COM MFC ................................................................. 105 WALKTHROUGHS APPLICATION DE FORMULÁRIOS DA WEB ........................................................... 114 EXPLICAÇÃO PASSO A PASSO: CRIANDO UMA PÁGINA WEB BÁSICA NO VISUAL WEB DEVELOPER.......................................................................................................................................................... 115 PASSO-A-PASSO: ACESSO A DADOS BÁSICO EM PÁGINAS DA WEB................................................... 124 PASSO-A-PASSO: LIGAÇÃO DE DADOS PARA UM OBJETO CORPORATIVO PERSONALIZADO . 134 EXPLICAÇÃO PASSO A PASSO: DEPURAÇÃO DE PÁGINAS DA WEB NO VISUAL WEB DEVELOPER.......................................................................................................................................................... 141 PASSO-A-PASSO: CRIANDO E USANDO PÁGINAS MESTRAS DO ASP.NET NO VISUAL WEB DEVELOPER.......................................................................................................................................................... 148 PASSO-A-PASSO: PERSONALIZANDO UM SITE USANDO TEMAS NO VISUAL STUDIO.................. 159 EXPLICAÇÃO PASSO A PASSO: CRIANDO UMA PÁGINA WEB PARTS NO VISUAL WEB DEVELOPER.......................................................................................................................................................... 165 EXPLICAÇÃO PASSO A PASSO: CRIANDO UM SITE WEB COM ASSOCIAÇÃO E LOGIN DE USUÁRIO (VISUAL STUDIO) ............................................................................................................................. 175 PASSO-A-PASSO: CRIANDO E USANDO UM SERVIÇO DA WEB ASP.NET NO VISUAL WEB DEVELOPER.......................................................................................................................................................... 188 CRIANDO E ACESSANDO EXPLICAÇÕES PASSO A PASSO DE XML WEB SERVICES ..................... 196 EXPLICAÇÃO PASSO A PASSO: CRIANDO UM XML WEB SERVICES USANDO VISUAL BASIC OU VISUAL C#.............................................................................................................................................................. 197 PASSO-A-PASSO: CRIANDO UM XML WEB SERVICE USANDO C++ E O CLR .................................... 202 WALKTHROUGH: CRIANDO UM SERVIÇO DA WEB XML USANDO ATL SERVER.......................... 207 PASSO-A-PASSO: ACESSANDO UM XML WEB SERVICE USANDO C++ E O CLR............................... 211 PASSO-A-PASSO: ACESSANDO UM XML WEB SERVICE USANDO C++................................................ 215 PASSO-A-PASSO: CRIANDO UM APLICATIVO DISTRIBUÍDO ................................................................ 220 CONTROLE DE CÓDIGO FONTE PARA O VISUAL STUDIO..................................................................... 228 INTRODUÇÃO AO CONTROLE DE ORIGEM ............................................................................................................... 228 O QUE HÁ DE NOVO NO CONTROLE DE ORIGEM PARA O VISUAL STUDIO ............................................................... 235 EXECUÇÃO DE TAREFAS DE CONTROLE DE ORIGEM ............................................................................................. 236 COMO: ADICIONAR UM PROJETO AO CONTROLE DE ORIGEM ................................................................................ 236 COMO: ACOPLAR OU DESACOPLAR UMA SOLUÇÃO OU PROJETO .......................................................................... 237 COMO: ALTERAR O LOCAL DA PASTA DE TRABALHO ........................................................................................... 238 COMO CONECTAR OU DESCONECTAR UMA SOLUÇÃO OU UM PROJETO ................................................................... 238 COMO: COPIAR UM ITEM SOB CONTROLE DE ORIGEM ........................................................................................... 239 COMO: EXCLUIR UM ITEM CONTROLADO POR ORIGEM ......................................................................................... 240 COMO ATIVAR RECUPERAÇÃO AUTOMÁTICA......................................................................................................... 240 COMO DESATIVAR A CRIAÇÃO DA PASTA <SOLUTIONNAME>.ROOT ...................................................................... 241 COMO: ATIVAR CHECK-INS AUTOMÁTICOS ......................................................................................................... 241 COMO: DESATIVAR CHECK-OUTS AUTOMÁTICOS ................................................................................................. 242 COMO: ATIVAR OU DESATIVAR CONTROLE DE ORIGEM........................................................................................ 242 COMO: EXCLUIR UM ARQUIVO DE CONTROLE DE ORIGEM .................................................................................... 243 COMO: MOVER UMA RAIZ DE LIGAÇÃO DE PROJETO ............................................................................................ 243 COMO: MOVER UM ITEM CONTROLADO POR FONTE ............................................................................................. 244 COMO: ABRIR UM PROJETO OU SOLUÇÃO DO CONTROLE DE ORIGEM ................................................................... 244 COMO: RENOMEAR UM ITEM CONTROLADO POR ORIGEM .................................................................................... 245 COMO: DEFINIR OPÇÕES DE PLUG-IN.................................................................................................................... 246 COMO: TROCAR PLUG-INS DE CONTROLE DE ORIGEM:........................................................................................... 247 COMO: EXIBIR UMA LISTA DE ARQUIVOS COM CHECK-OUT.................................................................................. 247 REFERÊNCIA A INTERFACE DO USUÁRIO DO CONTROLE DE ORIGEM...................................................................... 247 Visual Studio 2 CAIXA DE DIÁLOGO CHANGE SOURCE CONTROL .................................................................................................. 247 CAIXA DE DIÁLOGO CHECK IN (CONTROLE DE CÓDIGO FONTE) ........................................................................... 249 CHECK-OUT PARA A CAIXA DE DIÁLOGO EDIT (CONTROLE DE ORIGEM)................................................................ 250 CAIXA DE DIÁLOGO GET (CONTROLE DE ORIGEM)................................................................................................. 251 JANELA DE CHECK-INS PENDENTES ....................................................................................................................... 252 GUIAS DE PLUG-IN PARA CONTROLE DE ORIGEM (CAIXA DE DIÁLOGO OPTIONS)................................................... 253 CAIXA DE DIÁLOGO SOURCE CONTROL ................................................................................................................. 256 CAIXA DE DIÁLOGO UNDO CHECKOUT (CONTROLE DE CÓDIGO FONTE)............................................................... 257 CONFIGURAÇÕES DO VISUAL STUDIO ........................................................................................................ 259 COMO: ALTERAR CONFIGURAÇÕES SELECIONADAS .............................................................................................. 260 TRABALHANDO COM CONFIGURAÇÕES.................................................................................................................. 261 COMO: COMPARTILHAR CONFIGURAÇÕES ENTRE COMPUTADORES ..................................................................... 261 COMO: ESPECIFICAR CONFIGURAÇÕES PARA UMA EQUIPE .................................................................................... 263 IMPORT AND EXPORT SETTINGS WIZARD.............................................................................................................. 263 ESCOLHA CONFIGURAÇÕES PARA EXPORTAR, IMPORTAR E EXPORTAR CONFIGURAÇÕES ASSISTENTE .................. 264 NOMEIE O ARQUIVO DE CONFIGURAÇÕES, IMPORTAR E EXPORTAR CONFIGURAÇÕES ASSISTENTE ....................... 264 SALVAR CONFIGURAÇÕES ATUAIS, IMPORTAR E ASSISTENTE PARA EXPORTAÇÃO CONFIGURAÇÕES ..................... 264 ESCOLHA CONFIGURAÇÕES PARA IMPORTAR, IMPORTAR E ASSISTENTE CONFIGURAÇÕES EXPORTAÇÃO ............. 265 ESCOLHA UM COLEÇÃO DE CONFIGURAÇÕES PARA IMPORTAR, IMPORTAR E ASSISTENTE CONFIGURAÇÕES EXPORTAÇÃO ........................................................................................................................................................ 265 <TASK> COMPLETE, IMPORT AND EXPORT SETTINGS WIZARD ............................................................................. 266 GERENCIAR SOLUÇÕES, PROJETOS E ARQUIVOS................................................................................... 267 INTRODUÇÃO AO SOLUÇÕES, PROJETOS, E ITENS ................................................................................................... 267 PROPRIEDADES DE PROJETO (VISUAL STUDIO) ..................................................................................................... 269 GERENCIANDO PROPRIEDADES DE PROJETO COM O DESIGNER DE PROJETO ........................................................... 269 GERENCIANDO PROPRIEDADES DE APLICATIVO ..................................................................................................... 269 COMO: ESPECIFICAR INFORMAÇÕES DE ASSEMBLY.............................................................................................. 269 COMO ALTERAR UM NOME DE CONJUNTO: ............................................................................................................ 269 COMO: ALTERAR O NAMESPACE PARA UM APLICATIVO ....................................................................................... 270 COMO: ALTERAR O TIPO DE APLICATIVO ............................................................................................................. 270 COMO: ALTERAR O OBJETO DE INICIALIZAÇÃO PARA UM APLICATIVO ................................................................ 271 COMO: ESPECIFICA UM ÍCONE DE APLICATIVO ..................................................................................................... 272 COMO: ATIVAR ESTILOS VISUAIS ........................................................................................................................ 272 COMO: ESPECIFICAR COMPORTAMENTO DE INSTÂNCIAS PARA UM APLICATIVO .................................................. 273 COMO: ATIVAR AUTENTICAÇÃO DE USUÁRIO PERSONALIZADA ........................................................................... 274 COMO: ESPECIFICAR O COMPORTAMENTO DE DESLIGAMENTO PARA UM APLICATIVO ......................................... 274 GERENCIANDO REFERÊNCIAS ................................................................................................................................ 275 REFERÊNCIAS DE PROJETO .................................................................................................................................... 275 SOLUCIONANDO PROBLEMAS DE REFERÊNCIAS QUEBRADAS ................................................................................. 276 COMO: ADICIONAR OU REMOVER REFERÊNCIAS NO VISUAL STUDIO .................................................................. 278 COMO: ADICIONAR OU REMOVER NAMESPACES IMPORTADOS............................................................................. 280 COMO: REMOVER REFERÊNCIAS NÃO USADAS ................................................................................................... 281 COMO: DEFINIR A PROPRIEDADE COPY LOCAL (COPIAR LOCALMENTE) DE UMA REFERÊNCIA ........................... 282 GERENCIANDO RECURSOS DE APLICATIVO ........................................................................................................... 283 COMO: ADICIONAR OU REMOVER RECURSOS....................................................................................................... 283 COMO: ADICIONAR OU REMOVER RECURSOS DE SEQÜÊNCIA DE CARACTERES ..................................................... 285 COMO: EDITAR RECURSOS .................................................................................................................................. 286 COMO: EDITAR RECURSOS QUE SÃO SEQÜÊNCIAS DE CARACTERES ..................................................................... 288 COMO: ASSOCIAR UM EDITOR COM UM TIPO DE RECURSO ................................................................................... 289 RECURSOS VINCULADOS VERSUS RECURSOS INCORPORADOS .............................................................................. 290 COMO: CRIAR RECURSOS INCORPORADOS ........................................................................................................... 291 COMO: IMPORTAR OU EXPORTAR RECURSOS ....................................................................................................... 291 GERENCIANDO DEFINIÇÕES DO APLICATIVO.......................................................................................................... 292 CONFIGURAÇÕES DE APLICATIVO.......................................................................................................................... 293 COMO: ADICIONAR OU REMOVER CONFIGURAÇÕES DE APLICATIVO ................................................................... 295 COMO: ACESSAR EVENTOS DE CONFIGURAÇÃO ................................................................................................... 296 GERENCIANDO PROPRIEDADES DE PROJETO C# E J#.............................................................................................. 297 COMO DEFINIR PROPRIEDADES DO PROJETO (C#, J#):............................................................................................ 297 COMO: DEFINIR O CAMINHO DE REFERÊNCIA (C#, J#)........................................................................................ 298 COMO: DEFINIR AS PROPRIEDADES DE COMPILAÇÃO (C#, J#) ............................................................................ 299 COMO: ESPECIFICAR EVENTOS DE COMPILAÇÃO ................................................................................................. 300 Visual Studio 3 COMO: ADICIONAR E REMOVER REFERÊNCIAS NO VISUAL STUDIO (C#, J#)........................................................ 300 LOCAL E PROJETOS DA WEB .................................................................................................................................. 301 PROPRIEDADES DE ARQUIVO ................................................................................................................................. 302 TIPOS DE ARQUIVOS E EXTENSÕES DE ARQUIVOS NO VISUAL BASIC, VISUAL C#, E VISUAL J#............................. 304 MODELOS DE PROJETO PADRÃO NO VISUAL STUDIO ............................................................................................. 310 COMO: RESTAURAÇÃO DE MODELOS DE PROJETO PADRÃO ................................................................................. 311 MODELO CLASS LIBRARY ..................................................................................................................................... 312 MODELO DE APLICATIVO DE CONSOLE .................................................................................................................. 312 MODELO EMPTY PROJECT ..................................................................................................................................... 312 MODELO DE BIBLIOTECA DE CONTROLES DA WEB ................................................................................................ 313 MODELO DE APLICATIVO WINDOWS ..................................................................................................................... 313 MODELO DE CONTROLE DE BIBLIOTECA DO WINDOWS ........................................................................................ 313 MODELO DE SERVIÇO DO WINDOWS ..................................................................................................................... 313 REFERENCIANDO NAMESPACES E COMPONENTES ................................................................................................. 313 REFERÊNCIAS DE PROJETO .................................................................................................................................... 314 SOLUCIONANDO PROBLEMAS DE REFERÊNCIAS QUEBRADAS ................................................................................. 314 CONVENÇÕES DE NOMENCLATURA PARA ARQUIVO DE RECURSO .......................................................................... 316 RECURSOS XML ................................................................................................................................................... 317 RECURSOS NÃO-XML........................................................................................................................................... 317 CONFIGURANDO APLICATIVOS USANDO PROPRIEDADES DINÂMICAS ..................................................................... 317 INTRODUÇÃO A PROPRIEDADES DINÂMICAS (VISUAL STUDIO).............................................................................. 317 PERSONALIZAR E AUTOMATIZAR O AMBIENTE DE DESENVOLVIMENTO .................................... 323 PERSONALIZAR O AMBIENTE DE DESENVOLVIMENTO ............................................................................................ 323 COMO: PERSONALIZAR AJUDA DINÂMICA ............................................................................................................. 324 COMO PERSONALIZAR BARRAS DE FERRAMENTAS VISUAL STUDIO (): .................................................................. 327 COMO INICIAR FERRAMENTAS NO VISUAL STUDIO: .............................................................................................. 329 COMO PERSONALIZAR A SEÇÃO DE NOTÍCIAS DA PÁGINA INICIAR:........................................................................ 331 COMO ALTERAR O ITEM EXIBIDO EM INICIAR BACKUP DO AMBIENTE DE DESENVOLVIMENTO DO:........................ 331 TRABALHANDO COM CONFIGURAÇÕES.................................................................................................................. 332 COMO: COMPARTILHAR CONFIGURAÇÕES ENTRE COMPUTADORES ..................................................................... 340 COMO: ALTERAR CONFIGURAÇÕES SELECIONADAS .............................................................................................. 342 COMO: ESPECIFICAR CONFIGURAÇÕES PARA UMA EQUIPE .................................................................................... 342 GERENCIAMENTO DE JANELA ................................................................................................................................ 343 TIPOS JANELA........................................................................................................................................................ 343 COMO: ORGANIZAR E ANCORAR JANELAS ........................................................................................................... 345 HOW TO: WINDOWS IDE DE LISTA E ARQUIVOS ACTIVE..................................................................................... 349 CAIXA DE DIÁLOGO DO WINDOWS VISUAL STUDIO ()........................................................................................... 350 CAIXA DE DIÁLOGO COLUNAS ............................................................................................................................... 351 CAIXA DE DIÁLOGO COLUNAS DE CLASSIFICAÇÃO ................................................................................................ 352 COMO: NAVEGAR DENTRO DO AMBIENTE DE DESENVOLVIMENTO INTEGRADO ................................................... 353 AUTOMAÇÃO E EXTENSIBILIDADE PARA VISUAL STUDIO...................................................................................... 353 ESTENDENDO O AMBIENTE VISUAL STUDIO .......................................................................................................... 353 O QUE HÁ DE NOVO NO EXTENSIBILIDADE E AUTOMAÇÃO DO VISUAL STUDIO 2005............................................. 354 NOVOS MEMBROS DE AUTOMAÇÃO PARA VISUAL STUDIO 2005 ........................................................................... 356 PRÁTICAS RECOMENDADAS PARA SEGURANÇA NA AUTOMAÇÃO .......................................................................... 368 O ESPECTRO DE AUTOMAÇÃO VISUAL STUDIO ...................................................................................................... 369 ESCOLHENDO A ABORDAGEM DE AUTOMAÇÃO ADEQUADA .................................................................................. 371 FUNCIONAL GRUPOS DE AUTOMAÇÃO ................................................................................................................... 372 ACESSANDO O MODELO DE AUTOMAÇÃO POR USANDO MACROS ........................................................................... 373 CRIANDO ADD-INS E ASSISTENTES ........................................................................................................................ 374 REFERÊNCIA CONJUNTOS DE AUTOMAÇÃO E O OBJETO DTE2............................................................................... 375 CONTROLAR PROJETOS E SOLUÇÕES...................................................................................................................... 376 CRIANDO E CONTROLLING AMBIENTE WINDOWS.................................................................................................. 377 COMO CRIAR E ANEXAR A OUTRA INSTÂNCIA DO VISUAL STUDIO: ....................................................................... 378 INTRODUÇÃO À EXTENSIBILIDADE DE PROJETO ..................................................................................................... 383 BEM-VINDO AO ASSISTENTE SUPLEMENTO, ASSISTENTE PARA ADICIONAR-IN VISUAL STUDIO ........................... 386 VISUAL STUDIO COMANDOS E OPÇÕES...................................................................................................... 389 JANELA DE COMANDO........................................................................................................................................... 391 JANELA IMMEDIATE .............................................................................................................................................. 393 LOCALIZAR / COMANDO CAIXA ............................................................................................................................. 395 COMANDOS GUIA, PERSONALIZAR CAIXA DE DIÁLOGO VISUAL STUDIO ()............................................................ 396 Visual Studio 4 Visual Studio 5 Controle de Código Fonte para o Visual Studio Sem sair do ambiente de desenvolvimento, você pode gerenciar seus projetos individuais e de equipe facilmente usando os recursos do controle de código fonte do Microsoft Visual Studio. O controle de código fonte do Visual Studio permite que você: • Gerencie o acesso ao banco de dados. O controle de código fonte do Visual Studio fornece suporte ao acesso de arquivos compartilhados e individuais. Também provê mecanismos para mesclagem de arquivos. Recuperar versões sucessivas de itens sob controle de versão. A maioria dos pacotes do controle de código fonte do Visual Studio armazenam dados que distinguem as diferentes versões de um item sob controle de versão. Manter o histórico detalhado dos itens sob controle de versão. Muitos pacotes fornecem mecanismos para armazenar e recuperar o histórico de um item, por exemplo, data e hora de criação. Trabalhar de modo colaborativo em projetos e soluções. Com o compartilhamento de arquivos, é possível que diferentes projetos e soluções compartilhem o mesmo item sob controle de versão. Alterações feitas em um item compartilhado são refletidas em todos os projetos e soluções. Automatizar as operações de controle de código fonte mais comuns. Por exemplo, um pacote do controle de de código fonte do Visual Studio pode definir uma interface de linha de comando que ofereça suporte a recursos importantes do controle de código fonte. Você pode usar essa interface em arquivos em lotes para automatizar as tarefas de controle de código fonte executadas regularmente. Recuperar exclusões acidentais. O controle de código fonte do Visual Studio fornece suporte a restauração da última versão do arquivo em que foi realizado o check-in. Economizar espaço em disco no pacote do controle de código fonte e no servidor associado. • • • • • • Introdução ao controle de origem O Visual Studio oferece suporte ao controle de origem usando a camada Visual Studio Integration Protocol (VSIP) no seu Integrated Development Environment (IDE). VSIP pode hospedar uma variedade de pacotes de controle de origem, geralmente implementados como plug-ins escritos para os protocolos apropriados. Um exemplo de um plug-in de controle de origem é o plug-in SourceSafe LAN suportado pelo Visual SourceSafe. Para obter detalhes do plug-in, consulte a ajuda do Visual SourceSafe. Observação O Visual Studio trata pacotes de controle de origem como plug-ins, embora eles possam ser implementados como outros tipos de módulos de software. Visual Studio 6 O controle de origem do Visual Studio é simplesmente um ambiente para plug-ins de controle de origem de terceiros. Por isso, sua funcionalidade só é ativada pela instalação de um plug-in. Para usar um plug-in de controle da origem de terceiros, você deve, geralmente, instalar o aplicativo de terceiros e/ou o(s) plug-in(s) de controle de origem nos computadores cliente e servidor para seu site. Depois de instalar como indicado pelas instruções de terceiros, sua funcionalidade estará disponível através do Visual Studio. As operações que estão ativas são variáveis, dependendo do plug-in de controle de origem. Você deve consultar a documentação de terceiros para detalhes operacionais de pacotes específicos. Consulte "Visão Geral (controle de origem)" na ajuda do Visual Studio para obter detalhes de design de controle de origem no Visual Studio. Esta seção da Ajuda também fornece todas as informações que serão necessárias para desenvolver um pacote de controle de origem de terceiros que seja compatível com Visual Studio. Noções básicas de controle de origem suportados pelo Visual Studio O suporte de controle de origem básico no Visual Studio inclui a configuração de plug-in de controle de origem e opções de ambiente, comutação de plug-in, acesso ao banco de dados, versionamento e manipulação de projetos do Visual Studio, soluções e arquivos e metadados associados. O controle de origem no Visual Studio também aplica protocolos do controle de acessos ao banco de dados, por exemplo, o estilo de trabalho Lock-Modify-Unlock, no qual um usuário que quer modificar um arquivo deve verificá-lo exclusivamente. É importante lembrar que você deve usar controle de origem em mecanismos do Visual Studio para interagir com um plug-in de controle de origem. Não use outras aplicações de cliente apresentadas por terceiros que forneçam o plug-in, por exemplo, Visual SourceSafe Explorer. O uso apropriado dos mecanismos de controle de origem no Visual Studio garante que somente arquivos corretos sejam adicionados ao controle de origem e que os arquivos de projeto e solução do Visual Studio sejam atualizados com os detalhes corretos do plug-in específico. Configuração de Plug-in de Controle de Origem e Comutação O controle de origem do Visual Studio suporta configuração e comutação de plug-in através da entrada Source Control na caixa de diálogo Options. Esta entrada é acessível selecionando-se Options no menu Tools do Visual Studio. Você usará a caixa de diálogo Options para selecionar o plug-in que você deseja utilizar para controle de origem, e configurar as opções de ambiente para o plug-in. Antes que você e sua equipe possam aproveitar as vantagens dos recursos de controle de origem no Visual Studio IDE, você deve: • • Determinar se qualquer plug-in de controle de origem está disponível. Se o plug-in de controle de origem que você deseja usar não estiver instalado em seu computador, instale o produto de terceiros que ofereça suporte ao plug-in e reinicie o Visual Studio para registrá-lo. Criar um banco de dados de controle de origem de acordo com a funcionalidade do determinado plug-in. Envie um link, com o local do banco de dados, para todos os membros da equipe. • • Acesso ao Banco de dados Comandos básicos de acesso ao banco de dados, por exemplo, Check Out e Add to Source Control, estão disponíveis no menu File do Visual Studio. No entanto, esses comandos são ativados somente depois que você tiver escolhido o plug-in de Visual Studio 7 por exemplo. renomeação e mudança de local. a cópia principal no banco de dados. que controlam o local da raiz virtual de um projeto da Web Criar arquivos de saída. Algumas operações de acesso são ativadas somente com o plug-in selecionado.csproj. vbproj. csproj. o controle de origem do Visual Studio apóia o conceito de uma raiz super-unificada. você pode usar um comando Add to Source Control depois de ter escolhido um plug-in. Quando você usa um dos comandos básicos de acesso ao banco de dados. Manipulação de arquivo pelo controle de origem Você pode adicionar os seguintes arquivos ao controle de origem do Visual Studio: • • • Arquivos de solução (*. Este tipo da raiz é um contêiner virtual e Visual Studio 8 .exe. a primeira coisa que um plug-in de controle de origem deve fazer é identificar uma raiz única para o item que está sendo adicionado.webinfo. A propagação da alteração do espaço para nome O controle de origem do Visual Studio oferece suporte à propagação de alteração do espaço para nome em plug-ins controle de origem. arquivos *. Entretanto. por exemplo. Propagação de alteração aplica-se a operações de exclusão. não. o plug-in que você tiver escolhido chama a correspondente funcionalidade de terceiros e/ou o ambiente para concluir a operação associada. Arquivos de opção de projeto de usuários. *.. usados para controlar comportamento em tempo de execução de um projeto do Visual Studio. ou arquivo no Solution Explorer do Visual Studio. por exemplo.vbproj. se uma solução contém arquivos ou projetos que residem em mais de uma unidade de disco. Arquivos de configuração de aplicativos com base em XML.controle de origem que deseja usar.dll e *. *. por exemplo. Para apoiar esta situação. Quando você solicitar uma operação para qual a propagação de alteração estiver ativada. arquivos *.suo). Esta raiz é um caminho ao diretório pai de todas as pastas de trabalho e arquivos que compõem a solução ou projeto.webinfo. arquivos *. Como Controle de Origem Trata Soluções e Projetos Quando você adiciona uma solução ou projeto ao controle de origem. Contudo. *. vbproj. quando você fizer o check-in no item e os outros usuários o recuperarem. enquanto outras operações estão somente disponíveis quando você também tiver selecionado um projeto do Visual Studio. não há nenhuma pasta física à qual uma raiz única pode fazer o mapa. você deve ter um item selecionado no Solution Explorer. Uma raiz única geralmente mapeia para um caminho físico no disco. solução.user.user Arquivos de informação da Web. e as cópias de outros usuários. Uma solução pode mapear a unidade de disco. Arquivos que você não pode adicionar ao controle de origem incluem o seguinte: • • • • Arquivos de opção de solução de usuário (*. para usar um comando Check In. *.SLN). Por exemplo.csproj. Arquivo de projeto. o plugin de controle de origem irá alterar a cópia de trabalho do item controlado por fonte. mas a raiz única de um controle de origem. assim. o modo design é limpo e significativo. Uma solução bem-formada é uma solução para a qual a estrutura hierárquica no disco combina com a sua estrutura no Solution Explorer. que você vê no Solution Explorer.root.suo) para a solução.sln para cada projeto adicional no banco de dados do controle de origem. Para mais informações. Muitas tarefas de controle de origem são mais fáceis de executar quando não há um mapeamento um-para-um entre os elementos individuais desse modo de visualização. consulte COMO: desativar a criação da pasta < nomedasolucao>. Modos de exibição de uma solução ou projetos Visual Studio fornece três modos diferentes de exibição de uma solução controlada por origem ou projeto: design. Quando você adiciona uma solução usando um plug-in de controle de origem com recursos avançados. é um retrato lógico do conteúdo de uma solução ou projeto. o plug-in cria uma pasta raiz vazia de solução no banco de dados. Se uma solução não é bem-formada. o plug-in de controle de origem cria uma pasta sob a pasta .sln) e arquivos de opção de solução de usuários (*. e físico. Contudo. controle de origem. O uso de solução raiz oferece os seguintes benefícios: • Menos prompt. Observação Quando você adicionar um projeto único ao controle de origem. as pastas para cada projeto adicional são criadas em paralelo com a pasta de solução. Finalmente.root. minimiza o número de avisos aos usuários quando você adiciona uma solução para controle de origem e executa outras tarefas. • Você pode desativar a criação de pasta < nomedasolucao >. Visual Studio 9 . necessariamente. Arquivos desnecessários estão ocultos e arquivos de vários locais físicos diferentes são colocados em um contêiner de projeto único. o plug-in do controle de origem cria uma pasta abaixo da pasta *. organizados do mesmo modo no disco como eles estão no Solution Explorer e no banco de dados. Por padrão. a pasta . Esta pasta conterá todos os itens em uma solução controlada por fonte. Encapsulamento do projeto. Todos os projetos em uma solução bem-formada são armazenados em subpastas da pasta solução no disco. o plug-in do controle de origem cria uma pasta para a solução e para o seu projeto inicial. Em seguida. essa pasta é < nomedasolucao >. A solução raiz minimiza o número potencial de ligações de controle de origem para uma solução e.todos os projetos e os arquivos em uma solução controlada por fonte estão localizados abaixo dele. Soluções no Visual Studio são bem-formadas ou não. mesmo quando uma ou mais projetos residam em diferentes partições ou computadores. Geralmente. A solução raiz garante que todos os projetos em uma solução possam ser identificados como pertencentes ao mesmo conjunto. O modo design de uma solução ou projeto. suas soluções e projetos não serão. mas isso não é recomendável. se você criar as suas soluções e projetos e os acrescentar ao controle de origem usando as configurações padrões do Visual Studio.root não será criada.root para conter as cópias principais de arquivo de solução (*. Se a solução é bemformada quando você a adiciona ao controle de origem.root. pelo menos. como uma casa com várias salas. um item pode ter várias ligações e requerer várias conexões com o banco de dados. que você vê no Windows File Explorer. físico e controle de origem de suas soluções controladas por fonte e projetos: • Primeiro. • • • Conexões de controle de origem e ligações O Visual Studio define uma conexão como uma ligação de dados ativa entre o Visual Studio e um servidor de banco de dados. pense em uma solução bem formada de controle de origem. Após adicionar o item. uma ligação de controle de origem. No entanto. Você instala um roteador atrás de um firewall para distribuir a alimentação de dados para outras salas e você paga um provedor de serviços de Internet para conectar sua casa com a Internet.O modo de controle de origem de uma solução ou projeto. você pode vê-la como uma casa na qual cada sala é unida à Internet diretamente. com vários projetos. o modo de exibição de controle de origem e design irá espelhar a hierarquia da solução no disco. Em seguida. A conexão estabelece um 'aperto de mão' entre a sua cópia de trabalho da solução no disco e a cópia mestra da solução no banco de dados. Como um exemplo de vínculos e conexões. crie uma solução em branco e adicione projetos a ela. Cada solução controlada por origem tem. Uma pasta controle de origem é criada para cada pasta que contém um arquivo solução ou projeto. você pode instalar uma linha de dados única de alta velocidade de uma sala à rua. uma conexão é criada através dessa ligação. O número de vínculos e conexões depende de como você cria a solução inicialmente e se seus projetos e arquivos estão todos salvos na mesma partição. Entretanto. que você vê em um aplicativo autônomo. necessariamente. Tarifas de Internet são mais caras do que as da casa de conexão única. quando você adicionar a solução ao controle de origem. Quando você constrói a casa. o plug-in de controle de origem copia o item e todo o seu conteúdo do disco para o banco de dados. é também um modo de exibição lógico de uma solução ou projeto. Se possível. O modo de exibição físico de uma solução ou projeto. Isso o ajuda a manter a relação lógica pai-filho entre uma solução e seus projetos no armazenamento. um reflexo do modo de exibição lógico. o plug-in de controle de origem vincula sua cópia de trabalho local de uma solução ou projeto à sua versão no banco de dados. Se uma solução controlada por origem não for bem formada. Quando você abre uma solução controlada por fonte. como Visual SourceSafe Explorer. Você pode pensar em vínculo de controle de origem como representação da linha de dados única criada para a casa. armazene todos os arquivos de uma solução ou projeto em uma unidade de disco. provavelmente não refletirá a estrutura hierárquica da lógica ou visão do controle de origem. o modo de exibição de controle de origem não é. Evite adicionar arquivos de link para uma solução ou projeto controlado por fonte origem. As diretrizes a seguir podem ajudá-lo a obter fidelidade organizacional entre o modos de exibição de design. Atribua a cada solução um nome exclusivo e descritivo que se diferencia do nome de cada um dos projetos contidos. Quando você adiciona uma solução ou projeto ao controle de origem. os custos de manutenção são Visual Studio 10 . uma segunda ligação será criada quando você adicionar um segundo projeto à solução. Ramificar em uma etapa. Soluções Single-Binding são mais gerenciáveis do que soluções Multiple-Binding. Se você criar um par de solução de multiprojeto em uma etapa e não selecionar a opção Create Directory for Solution na caixa de diálogo New Project (desativado por padrão). criando uma solução em branco antes de adicionar seus projetos. estruturas de projeto e informações do usuário são armazenados. ou ramificação. A tabela a seguir define alguns dos termos comuns. Banco de dados Local onde todas as cópias mestre. as duas versões sob controle de origem terão um histórico compartilhado até um determinado ponto e históricos divergentes após esse ponto.superiores. Vários projetos podem ser armazenados em um banco de dados. e vários bancos de dados podem ser usados. Ramificação Processo de criar uma nova versão. Você pode criar uma solução de multiprojeto com uma ligação única. Terminologia de controle de origem A documentação do Visual Studio usa um número de termos para descrever recursos e conceitos de controle de origem. uma solução e seu projeto compartilham uma ligação de controle de origem única. e mudar para um provedor de serviços de Internet diferente é muito mais difícil e demorado. Idealmente. Vinculação Informação que correlaciona uma pasta de trabalho de uma solução ou projeto no disco à pasta no banco de dados. histórico. Uma vez que uma ramificação tenha sido criada. Ligações adicionais são criadas para cada projeto adicional. Conectar-se ao banco de dados após a reconexão com a rede. Você também pode fazer isso. ao criar um par de solução de multiprojeto. Elas tornam mais fácil: • • • Desconectar do controle de origem para trabalhar off-line. Visual Studio) e um servidor de banco de dados do controle de origem. Versão base A versão do servidor de um arquivo do qual uma versão local é derivada. de um arquivo compartilhado ou projeto sob controle de origem. Conflito Duas ou mais alterações diferentes para a mesma linha do código em situações em que dois ou mais desenvolvedores tenham feito o check-out e editado o mesmo arquivo. Um projeto sempre está contido em um banco de dados. Outros termos Visual Studio 11 . selecionando a opção Create Directory for Solution na caixa de diálogo New Project. Conexão Uma ligação de dados ativa entre um cliente do controle de origem (por exemplo. Uma ligação é criada para o projeto inicial e para a solução. Uma cópia local é. Por padrão. é a raiz super-unificada de uma solução controlada por origem contendo projetos localizados em [SUR]:\C:\Solucao\Proj1 e [SUR]:\D:\Proj2. Arquivo compartilhado Um arquivo com versões que residem em mais de uma localidade de controle de origem. Por exemplo [SUR]: \. Raiz solução Uma pasta vazia em um banco de dados que contém todos os itens de uma solução controlada por origem. Com o controle de versão. Pasta de trabalho Local no qual as cópias locais de itens controlados por origem são armazenados. Por exemplo. inicialmente. Visual Studio 12 . chamada de uma cópia de trabalho.root. em oposição à cópia local de um arquivo em sua pasta de trabalho. C:\Solucao\Proj1 e C:\Solucao\Proj2. no controle de origem. C:\Solucao é a raiz unificada de uma solução controlada por origem contendo arquivos localizados em C:\Solucao. você pode retornar a qualquer ponto no histórico do arquivo e recuperar o arquivo como ele existia até esse momento. Mesclar Processo de combinar diferenças entre duas ou mais versões modificadas de um arquivo em uma nova versão de arquivo. Histórico Registro de alterações de um arquivo desde que ele tenha sido adicionado. geralmente no seu próprio computador. Cópia mestra A versão mais recente do check-in de um arquivo controlado por fonte. Mesclar pode afetar diferentes versões do mesmo arquivo ou alterações feitas a uma mesma versão do arquivo. essa pasta é < nomedasolucao >. Outros termos para cópia mestra são versão do servidor e versão do banco de dados. Cópia local Arquivo em uma pasta de trabalho do usuário para a qual são copiadas alterações antes que seja feito um check-in.normalmente usados para um banco de dados são repositório e armazenamento. Rótulo Nome definido pelo usuário anexado a uma versão específica de um item controlado por fonte. Outros termos para um arquivo compartilhado são cópia e atalho. Outro termo para uma pasta de trabalho é espaço de trabalho. Raiz unificada Um caminho para a pasta pai de todas as pastas de trabalho e arquivos em uma solução ou projeto controlado por origem. às vezes. Raiz Super-unificada Um contêiner virtual abaixo do qual todos os projetos e os arquivos em uma solução controlada por origem estão localizados. O que há de novo no controle de origem para o Visual Studio O Visual Studio tem dado suporte a controle de origem e integração de plug-ins de controle de origem há algum tempo. Melhorias na caixa de diálogo do Visual Studio para dar suporte a controle de origem Os seguintes aperfeiçoamentos de acesso a arquivo foram feitos nas caixas de diálogo do Visual Studio: • Agora você pode adicionar projetos ao controle de origem e abri-los facilmente usando a nova guia Source Control Stores na caixa de diálogo Open Project. e movimentações com o banco de dados. se você excluía. Você pode adicionar um arquivo existente do controle de origem a um projeto usando a caixa de diálogo Add Existing Item. Você pode adicionar automaticamente soluções e projetos ao controle de origem marcando a caixa de seleção Add to Source Control na caixa de diálogo New Project. Em versões anteriores. Melhorias nas operações básicas de controle de origem Visual Studio 13 . C#. • • Sincronização de exclusões. J# e projetos da Web e não possui suporte de todos os plug-ins de controle de origem. O recurso de abertura assíncrona marca projetos que ainda estão sendo baixados com uma ampulheta. Entretanto. a versão atual inclui um número de aperfeiçoamentos de integração. Para informações sobre novos recursos da parte de controle de origem do SDK do ambiente Visual Studio. Quando você fizer uma alteração você será solicitado a propagar a alteração. ele permanecia na sua pasta de trabalho mesmo após a sincronização. renomeações e movimentações Para oferecer suporte a propagação de alteração de namespace. consulte "Novidades para controle de origem" Alternância de plug-in Controle de origem agora permite alternar entre todos os tipos de plug-ins de controle de origem em Options no menu Tools. renomeava ou movia um item no servidor. renomeações. e marca projetos totalmente baixados para acesso assim que eles estiverem disponíveis. Esta alternância permite a substituição completa da interface do usuário e permite um plug-in por solução. enquanto outros usuários poderão sincronizar através de operações de recuperação. Isso significa que você pode abrir e começar a trabalhar em um projeto mesmo que o Visual Studio esteja ainda abrindo os outros projetos na solução. Melhorias no acesso ao projeto via aberturas assíncronas Controle de origem do Visual Studio foi aprimorado para abrir soluções de forma assíncrona e refletir o progresso de uma operação de abertura modificando os ícones no Solution Explorer. Observação Este recurso está apenas disponível para Visual Basic. a versão mais recente de controle de origem sincroniza exclusões. Você pode configurar o Visual Studio para fazer silenciosamente check-out de arquivos em edição e fazer automaticamente check-in das suas alterações quando você fechar a solução. Você tem uma opção para configurar o Visual Studio para automaticamente obter do controle de origem a última versão de todos os itens da solução quando você abrir uma solução . Se você tiver dúvidas sobre como fazer isso. Agora checkouts são automáticos e número de solicitações é reduzido. Para adicionar um projeto e solução ao controle de origem 1. como baixar em qualquer local. Observação Muitos desses procedimentos referem-se à seleção de comandos básicos de controle de origem do menu File do Visual Studio. Visual Studio 14 . Operações básicas de controle de origem como check in. Em versões anteriores do Visual Studio. Se uma solução já estiver sob controle de origem. 3. • • • Suporte ao Visual Web Developer O Visual Web Developer pode agora acessar recursos de controle de origem de projeto na Web. procure a Ajuda do Visual Studio. crie um novo projeto. 2. COMO: Adicionar um projeto ao controle de origem O controle de origem do Visual Studio permite adicionar um projeto e seu arquivo de solução ao controle de origem ao mesmo tempo. o local estava embutido em código para baixar em c:\inetpub\wwwroot. check out e exibição de histórico são amplamente específicas de plug-in. clique em Source Control. entretanto. embora essas operações possam fazer uso de alguns dos elementos de interface de usuário padrão suportados pelo pacote de controle de origem do Visual Studio. No menu File. Selecione a solução que contém o novo projeto. você pode adicionar um novo projeto a ela.Os seguintes aperfeiçoamentos foram feitos nas operações básicas de controle de origem do Visual Studio: • Você pode agora fazer um check-out de um arquivo de uma pasta de trabalho local sem precisar baixar pela rede a versão mais recente do arquivo no banco de dados. você pode acessar muitos dos comandos clicando com o botão direito do mouse em um item controlado por fonte no Solution Explorer. Consulte também Execução de Tarefas de Controle de Origem Esta seção descreve tarefas gerais de controle de origem que você pode executar no Visual Studio para qualquer plug-in. Alternativamente. No Visual Studio. Para tarefas de plug-in-específico. Fazendo check-in de uma solução automaticamente coloca qualquer novos projetos que esta contém sob controle de origem. você deve consultar a documentação do plug-in de controle de origem específico. Se você tiver dúvidas sobre como fazer isso. e em seguida. Clique em Add Solution to Source Control e selecione a base de dados de projeto à qual quer adicionar a solução usando os procedimentos do plug-in de controle de origem sendo utilizado. e desativando todos os comandos de controle de origem. tais como Check Out. há vários procedimentos na Ajuda do Visual Studio. abra uma solução existente no Solution Explorer. usando o procedimento de check-in específico para o plug-in de controle de origem em uso. Faça o check-out do arquivo de solução. 6. No Visual Studio. Para ligar uma solução ou projeto ao controle de origem 1. 5. Talvez você precise desacoplar um item se: • Você precisar religá-lo à versão de backup do banco de dados quando o servidor primário for desligado. No menu File. consulte COMO: conectar ou desconectar uma solução ou projeto. • • Desacoplar um item não o remove permanentemente do banco de dados. No menu File. Para mais informações. Visual Studio 15 . Você pode conectar a um servidor de backup. Desacoplar uma solução ou projeto controlado por origem remove o item do controle de origem. desassociando a cópia local da cópia mestre no banco de dados. Você desejar iniciar uma nova ramificação sem nenhum histórico de controle de origem em uma pasta de banco de dados diferente. clique em Source Control. No Visual Studio. Crie novos projetos conforme necessário na solução. Na maioria das situações. Faça o check-in da solução de volta no controle de origem. 4. e continuar trabalhando normalmente. abra o Solution Explorer e selecione uma solução ou projeto a ser ligado. Para obter mais informações de como excluir um item. clique em Source Control. Você desejar utilizar um outro plug-in de controle de origem . Para adicionar os projetos selecionados ao controle de origem 1. 3. depois em Change Source Control. clique em Add Selected Projects to Source Control Você será solicitado a decidir se deseja adicionar os projetos como subpastas da solução ou como pastas separadas. Check In. 2. consulte COMO: excluir um item controlado por origem. você deve adicionar os projetos à pasta da solução no banco de dados. Uma ligação associa a cópia local do item à cópia mestre no banco de dados. e Get. 2. religar a sua cópia da solução à cópia mestre do servidor no banco de dados de backup.4. COMO: acoplar ou desacoplar uma solução ou projeto Você deve ligar uma solução ou projeto ao controle de origem de maneira que este item tenha acesso aos comandos básicos de controle de origem. Use o procedimento de check-out específicos para o plug-in de controle de origem em uso. pois o controle de origem precisa incluir os novos detalhes do projeto nesse arquivo. COMO: alterar o local da pasta de trabalho Às vezes o Solution Explorer indica locais de pasta por um sublinhado ondulado. Ao realizar o check-out de um item desconectado. você pode reconectar a solução e sincronizar sua cópia local com a cópia mestre mais recente. 4. Para desacoplar uma solução ou projeto do controle de origem 1. 3. 3. abra o Solution Explorer e selecione uma solução ou projeto a ser desacoplado. torna-se editável. abra a janela Solution Explorer e selecione os itens a serem conectados. o único comando básico que você pode usar é o comando de check-out. a cópia local do item. Na caixa de diálogo Change Source Control. depois em Change Source Control. clique em Bind. Para corrigir caminhos inválidos. 2. contida na sua pasta de trabalho. Se você desconectar seu computador da rede ou perder a conexão por alguma outra razão. clique em Unbind. Uma conexão é criada automaticamente sempre que um item é vinculado ao controle de código fonte conforme descrito em Como vincular ou desvincular uma solução ou um projeto. Se a pasta ainda não existir. você deve alterar o local da pasta de trabalho. Na caixa de diálogo Change Source Control. Como conectar ou desconectar uma solução ou um projeto Conforme descrito em Introdução ao Controle de Código Fonte. abra o Solution Explorer. e clique em OK. Procedimentos Para conectar uma solução ou um projeto ao controle de código fonte 1. 2. por exemplo. você deve desconectar temporariamente os vínculos da solução a fim de editar os projetos e os arquivos nela contidos. Clique no botão de reticências (…) Digite um caminho válido. Quando você desconecta uma solução do controle de código fonte. http://<host local>/pasta1. No Visual Studio. Para alterar o local da pasta de trabalho 1. Pode-se criar uma conexão manualmente conforme descrito neste tópico. Selecione o banco de dados e local ao qual ligar. Essas entradas representam caminhos inválidos relativos à pasta de trabalho.3. No Visual Studio. o Visual Studio criará uma. 4. clique em Source Control. No menu File. Visual Studio 16 . 4. Clique em um caminho inválido na coluna Enter Working Copy Location Here. Quando for possível acessar o banco de dados novamente. uma solução no Visual Studio pode ter um ou mais vínculos com o controle de código fonte. e clique em OK. Clique em OK. No Visual Studio. abra a janela Solution Explorer e selecione os itens a serem desconectados. uma nova ramificação é criada no banco de dados. 6. abra o Solution Explorer. Na caixa de diálogo Change Source Control. clique em Source Control e depois em Change Source Control. e clique em Add. clique em Add e depois em Existing Item. Selecione o projeto. clique no nome de seu plug-in de controle de origem. 3. 7. No menu File. No menu File. Clique com o botão direito do mouse no projeto de destino no Solution Explorer. 3. clique em Add e depois em Existing Project. Na caixa de diálogo Change Source Control. Quando você copia um item. Clique em OK. 3. Visual Studio 17 . Para copiar um projeto sob controle de origem 1. 2. 3. 2. ou copiar um arquivo de um projeto sob controle de origem para outro. No Visual Studio. Este projeto deve estar no mesmo banco de dados que o projeto de origem. No menu File. Clique com o botão direito do mouse na solução de destino no Solution Explorer. Para copiar um arquivo sob controle de origem 1. junto com o histórico e outros metadados do item. Criar ramificações permite que sua equipe desenvolva duas versões de um produto simultaneamente e independentemente. clique em Disconnect. abra o Solution Explorer. 2. 5. No Visual Studio. Clique em OK. 4. 4. Na caixa de diálogo Add Existing Project. No Visual Studio. 1. clique em Source Control e depois em Change Source Control. não poderão ser criadas ramificações no projeto. 4. Clique em OK. Clique duas vezes no banco de dados contendo o projeto que você deseja copiar. Observação Se você copiar um projeto sob controle de origem para uma solução que não está sob controle de origem. No meu File . clique em Connect. Para desconectar uma solução ou projeto de controle de código fonte COMO: copiar um item sob controle de origem Você pode copiar um projeto de uma solução sob controle de origem para outra.2. Faça o check-out como apoiado pelo seu plug-in de controle de origem. Eles receberão uma mensagem notificando-os da exclusão. Caso contrário. depois clique Delete ou Remove. Notifique a exclusão a qualquer pessoa que possa ter feito o check-out do projeto ao qual o item excluído pertence. Para excluir um item controlado por origem 1. Para mais informações sobre propagação de modificação de espaço para nome. Na caixa de diálogo Source Control. consulte a documentação do produto de terceiros para seu plug-in. 4. Se houver suporte para a propagação de modificação de espaço para nome. Clique em OK. você terá de informar aos outros usuários para removerem manualmente suas cópias locais do item excluído. Visual Studio 18 . faça o check-in do item como apoiado pelo seu plug-in de controle de origem. Selecione o arquivo. 2. Na caixa de diálogo Add Existing Item. Se tiver clicado em Remove. COMO: excluir um item controlado por origem Quando você exclui um item controlado por origem. 3. clique em Delete na caixa de diálogo que aparece. permita que os outros usuários façam a atualização de suas cópias locais. Você será solicitado para fazer o check-out no item.4. como projetos C++. e clique em Add. Em Solution Explorer. 1. 2. 7. Para obter mais informações sobre como excluir permanentemente um item de controle de origem. Clique duas vezes no banco de dados que contém o arquivo que você deseja copiar. Clique com o botão direito do mouse no item que deseja excluir. consulte Introdução ao controle de origem. o Visual Studio exclui automaticamente a cópia local. 7. se o plug-in de controle de origem apoiar a propagação de modificação de espaço para nome. Se não houver suporte à propagação de modificação de espaço para nome. No Visual Studio. anteriormente. abra Solution Explorer. 5. ele o consultará para obter instruções sobre exclusão. A maioria dos plug-ins para controle de origem para o Visual Studio não exclui permanentemente itens de um banco de dados. clique no nome de seu plug-in de controle de origem. Observação O comando Remove só estará disponível para projetos a base de referência. 5. 6. 6. clique em Delete the item(s) locally and in the source control store. 4. Na caixa de dados Value. Clique em OK para aceitar a alteração do registro. 6. Marque a caixa de seleção Get everything when a solution or project is opened. Como desativar a criação da pasta <solutionname>. Visual Studio 19 . Para mais informações sobre a raiz unificada. em seguida. troque 0 por 1. Na área de trabalho do Windows.root vazia no banco de dados. Para desativar a criação automática da pasta < solutionname >. 5. consulte Introdução ao controle de código fonte. Na caixa de diálogo Options. clique em Run Digite Regedit e clique em OK.root 1. Clique em OK. COMO: Ativar Check-ins automáticos Você pode configurar o Visual Studio para que efetue automaticamente check-in nas suas alterações no controle de origem quando você fechar uma solução. clique em Options. 2. 4. No Visual Studio. Por exemplo. Além disso. Essa pasta irá conter a raiz unificada da solução.root irá alterar o comportamento do plug-in sempre que uma solução com vários projeto for adicionada ao controle de código fonte. clique em Source Control e em seguida clique em Environment.Como ativar recuperação automática Você pode configurar o Visual Studio para recuperar automaticamente a versão mais recente de um item sob controle de versão sempre que você abri-lo. o respectivo plug-in cria automaticamente uma pasta < solutionname >.root Quando você adiciona uma solução ao controle de código fonte. Selecione a chave DoNotCreateSolutionRootFolderInSourceControl e clique em Edit e depois em Modify. operações que adicionam projetos levarão mais tempo para concluir. Abra \SourceControl HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\ < número de versão >. no menu Tools. Isso garante que a cópia local permanecerá sincronizada com a cópia mestra. Procedimentos Para obter a versão mais recente automaticamente 1. Cuidado Desativar a criação automática da pasta < solutionname >. 2. você terá que responder a solicitações redundantes ao executar operações de controle de código fonte em vários projetos. 3. clique em Start e. 3. Se você não tiver nenhum plug-in de controle de origem compatível instalado em seu computador. Na caixa de diálogo Options. o controle de origem no Visual Studio não está ativado. mesmo se você esquecer fazer check-in manualmente. Marque a caixa de seleção Check in everything when closing a solution or project. 2. No Visual Studio. Entretanto. Clique em OK.Automatizar o processo de check-in garante que seus trabalhos mais recentes se tornem periodicamente disponíveis para outros membros da equipe. Clique em OK. 3. Para ativar checkins automáticos 1. clique em Options. Ela lista todos os plug-ins disponíveis na aba Plug-in Selection da entrada Source Control na caixa de diálogo Options. Procedimentos Para desativar check-outs automáticos 1. clique em Source Control. no menu Tools. no menu Tools. COMO: ativar ou desativar controle de origem O controle de origem no Visual Studio estará disponível somente se um plug-in válido de controle de origem estiver instalado e registrado para ser usado em seu computador. e depois clique em Environment. Na caixa de diálogo Options. Isso pode levar a situações em que soluções e projetos não podem ser acessados no controle de origem. No Visual Studio. 2. Você não verá nenhuma entrada Source Control no menu File. desmarque a caixa de seleção Check out automatically. clique em Options. O plug-in é registrado durante a instalação do software de terceiros. Na caixa Editing. 4. Cuidado Você pode usar um plug-in de controle de origem no Visual Studio e o aplicativo autônomo de controle de origem correspondente para gerenciar o mesmo projeto ou solução. clique em Environment. 3. clique em Source Control. 4. Esta seção descreve como você pode configurar o Visual Studio para desativar check-outs automáticos. O Visual Studio usa esse registro para localizar os plug-ins e as localidade de seus bancos de dados padrão sempre que você abrir a IDE do Visual Studio. Visual Studio 20 . fazer check-outs de itens de ambos os programas para a mesma pasta de trabalho não é recomendável. COMO: desativar check-outs automáticos O controle de origem no Visual Studio permite check-outs automáticos por padrão. o arquivo permanecerá no banco de dados. Para desativar completamente o controle de origem 1. No Visual Studio. clique em Options. Na caixa de diálogo Options . clicar em Source Control e então desmarcar Exclude from Source Control. COMO: excluir um arquivo de controle de origem Se a solução em você estiver trabalhando contém arquivos que não requerem controle de origem. Clique em OK. Visual Studio 21 . clique em Source Control. você pode acessar o menu File. Para mover uma raiz de ligação de projeto 1. 4. clique em Options. Um arquivo gerado é um que pode ser recriado inteiramente pelo Visual Studio. clique em Source Control. Observação Arquivos gerados são excluídos do controle de origem por padrão. clique em Exclude from Source Control. 2. No Visual Studio. de acordo com o conteúdo de outro arquivo do Visual Studio. no menu Tools. você pode utilizar o comando Exclude from Source Control para marcar adequadamente o arquivo. clique em Source Control. 3. No Visual Studio. Clique em OK. 4. 3. 2.Para ativar um determinado plug-in de controle de origem 1. clique em Plug-in Selection. Quando você fizer isso. Na caixa de diálogo Options. COMO: mover uma raiz de ligação de projeto Você talvez necessite mover a raiz de ligação de um projeto se alguns arquivos que você deseja adicionar ao projeto estiverem localizados fora da raiz do projeto. Para excluir um arquivo do controle de origem 1. No Visual Studio. Selecione None na caixa Current source control plug-in. clique em Plug-in Selection. no menu Tools. No menu File. Selecione o plug-in de controle de origem que deseja usar. Quando você estiver pronto para colocar o arquivo sob controle de origem. mas não é mais realizado check-in ou check-out do mesmo a partir do projeto que o contém. abra o Solution Explorer e selecione um projeto que contém arquivos que estejam fora da pasta da solução ou raiz do projeto. 2. abra Solution Explorer e selecione o arquivo a ser excluído. 3. abra o Solution Explorer. você deve religá-la a uma pasta de banco de dados.2. Se solicitado. 2. Com o projeto selecionado. Para mover um item controlado por origem 1. você não precisá abri-lo a partir do controle de origem novamente. 5. você move todo o histórico e metadados de controle de origem associados se o plug-in de controle de origem apoiar a propagação de modificação de espaço para nome. 3. Se você teve que desacoplar a solução juntamente com o projeto. COMO: abrir um projeto ou solução do controle de origem Quando você abre um projeto ou solução do controle de origem. depois em Change Source Control. Você pode continuar Visual Studio 22 . No menu File. 9. No Visual Studio. acesse novamente a caixa de diálogo Change Source Control e clique em Bind. clique em Source Control. consulte COMO: acoplar ou desacoplar uma solução ou projetos. faça logon no seu banco de dados de controle de origem.root é esta pasta. Na maioria dos casos. Tanto a origem quanto os itens de destino envolvidos em uma operação de mudança de local devem ser localizados no mesmo banco de dados de controle de origem. Para mais informações sobre propagação de modificação de espaço para nome. uma solução e seus projetos devem compartilhar uma vinculação de controle de origem. 8. o Visual Studio baixa a cópia mestra mais recente do item e de todos os arquivos contidos para a pasta de trabalho local. desacople a solução também. Selecione a pasta pai na qual todos os arquivos no projeto estão armazenados. COMO: mover um item controlado por fonte No Visual Studio. Para uma mudança de local ser ativada. Observação A operação de mudança só pode ocorrer entre dois projetos na mesma solução. Clique no item que você deseja mover e arraste-o para a solução ou projeto de destino no Solution Explorer. clique em Unbind. Depois que você recuperar uma cópia local do item. consulte Introdução ao controle de origem. Para mais informações. Quando você move um item. Na caixa de mensagem. 6. você pode mover um item controlado por origem de uma pasta de projeto ou solução para outro. ou entre duas soluções. clique em Unbind para confirmar que você deseja remover o projeto do controle de origem. Se a solução e o projeto compartilham uma ligação de controle de origem. 7. Na caixa de diálogo Change Source Control. 4. a pasta <nomesolução>. ele consultará você para obter instruções de renomeação. altere a pasta de destino. Para renomear um item de origem controlada 1. 2. o Visual Studio renomeia a cópia local automaticamente se o plug-in de controle de origem suporta propagação da alteração de namespace. clique Rename. clique em Open.proj) ou de solução (*. COMO: Renomear um item controlado por origem Quando você renomeia um item controlado por origem. Responda às perguntas conforme necessário. 4. Na caixa de diálogo Open Project . Cuidado Se você repetir um dos procedimentos neste tópico. Para abrir um projeto da Web do controle de origem 1. depois clique em Open. você criará várias pastas de trabalho e várias instâncias dos arquivos que elas contêm. clique em My <source control plugin> Stores. abra o Solution Explorer. 3. 5. Clique em Web Site. Caso contrário. clique em My <source control plug-in> Stores. 4. Na caixa de diálogo Open Web Site. selecione Close Solution if not already selected. 6. Procure e selecione o seu arquivo de projeto (*. 3. você será solicitado a substituir a cópia local de todos os arquivos e projetos na solução. Para abrir um projeto ou solução do controle de origem 1. consulte Introdução ao controle de origem. Visual Studio 23 . e depois clique em Open. no menu File. e depois clique em Open.a usar os comandos de controle de origem para o seu plug-in específico de controle de origem. Se você já tiver uma cópia local da solução ou do projeto que você está abrindo do controle de origem. Clique com o botão direito do mouse no arquivo a ser renomeado. Clique em Project/Solution. No Visual Studio. você será solicitado a substituir a cópia local de todos os arquivos e projetos na solução. clique em Open. No lado esquerdo da caixa. No Visual Studio.sln). no menu File. 5. Procure e selecione o projeto da Web. 2. altere a pasta de destino. Para mais informações sobre propagação de alterações de namespaces. 2. No Visual Studio. e depois clique em Open. Responda às perguntas conforme necessário. Se você já tiver uma cópia local do projeto da Web que você está abrindo do controle de origem. Notifique qualquer pessoa que possa ter efetuado check-out do item que você renomeou. Selecione Environment na caixa de diálogo Options. 3. no menu Tools. clique em Options e. O Visual Studio seleciona automaticamente as opções de controle de origem padrão para a função que você tiver selecionado. 7. Na caixa de diálogo Options. clique em Rename or move the item(s) locally and in the source control store. além de instruções sobre como configurá-las. marcando ou desmarcando as caixas de seleção do controle de origem. selecione a função para a qual você deseja definir as opções de controle de origem. e clique em OK. No Solution Explorer. 6. Digite um novo nome e pressione Enter. em seguida. Agora clique em Plug-in Settings na caixa de diálogo Options. 5. Na caixa de diálogo Source Control. Clique em OK. Efetue o check-out conforme o suporte de seu plug-in de controle de origem.3. Se houver suporte para propagação da alteração de namespace. em Source Control. Na caixa Source Control Environment Settings. Essas opções estão disponíveis através da Configuração Options no menu Tools do Visual Studio. Visual Studio 24 . você pode desejar alterar algumas das opções padrão de controle de origem antes de usar o banco de dados. COMO: definir opções de plug-in Dependendo da como você gerenciar seus itens em controle de origem. faça com que os outros usuários efetuem um get para atualizar suas cópias locais. assegure-se que seu plug-in é o indicado. Você será solicitado para fazer check-out do item. Se não houver suporte para a propagação da alteração do namespace. No Visual Studio. 8. Para definir opções de plug-in 1. 9. é necessário informar aos outros usuários para que renomeiem suas cópias locais manualmente para refletir a alteração do nome. Observação Consulte a documentação do plug-in de controle de origem em uso para uma lista completa das opções no nível do banco de dados e das mais avançadas. 6. 4. efetue o check-in do item conforme o suporte de seu plug-in de controle de origem. a caixa Source Control Environment Settings exibe a Opção Custom para indicar que você personalizou o perfil originalmente selecionado. 2. clique em Plug-in Selection. 5. Eles receberão uma mensagem notificando-os sobre a operação de renomeação. 7. Personalize o perfil. 4. Se você desmarcar qualquer uma das opções padrão. COMO: exibir uma lista de arquivos com check-out Você pode usar a janela Pending Checkins para exibir uma lista dos arquivos com check-out na solução atual. Para mudar o plug-in padrão de controle de origem 1. 2. Encaixe a janela conforme desejado. Você pode ou não ver essas caixas de diálogo no Visual Studio. Quando concluir todas as configurações do plug-in. Referência a Interface do Usuário do controle de origem Esta seção descreve as caixas de diálogo usadas pelo controle de origem no Visual Studio. 9. As caixas de diálogo a seguir são modelos que o desenvolvedor de plug-in pode adaptar conforme necessário. no menu View. Para exibir uma lista de arquivos modificados 1. Nessa aba.8. O controle de origem do Visual Studio permite que você faça um check-in de arquivos desta janela com um único clique de botão. Se você desejar fazer check-in de arquivos desta janela. o item do controle de origem. No Visual Studio. você pode trocá-los a qualquer momento. Na caixa de diálogo Options clique em Source Control. a menos que você remova. no menu Tools. 3. 2. selecione-os e clique no botão Check In. Lembre-se que projetos controlados por um plug-in de controle de origem não podem ser adicionados a uma solução gerenciada por um plug-in diferente. No Visual Studio. você não pode acrescentar o mesmo item ao controle de origem que usa outro plug-in. Clicando no botão Advanced tem-se acesso às configurações avançadas para a função que você está configurando. dependendo do plug-in que está sendo usado para controle de origem: • • • • Verifique em Verificar saída para editar Obter Desfazer Checkout Visual Studio 25 . primeiro. 3. clique em Pending Checkins. Selecione um plug-in e clique OK. clique em Options. depois em Plug-in Selection. clique em OK para sair da caixa de diálogo Options. você pode definir configurações para cada função do plug-in. Uma vez que você acrescenta uma solução ou projeto ao controle de origem que usa um plug-in. Como: Trocar plug-ins de controle de origem: Se você tiver instalado mais de um plug-in para controle de origem para o Visual Studio. você será solicitado a especificar outra. selecione um item no Solution Explorer. Procurar Permite que você procure uma nova localidade para o item especificado no servidor de controle de origem. Provedor Exibe o nome do plug-in de controle de origem. Vincular Associa os itens selecionados a uma localidade do servidor de controle de origem especificado. OK Aceita alterações feitas na caixa de diálogo. Utilize esse comando antes de desconectar seu computador do servidor de controle de origem. Colunas Identifica colunas para exibição e a ordem na qual elas são exibidas. Conectar Cria uma conexão entre itens selecionados e o servidor de controle de origem. por exemplo. Observação Esta caixa de diálogo também está disponível clicando com o botão direito do mouse sobre o item no Solution Explorer. Por exemplo. clique em Source Control e depois em Change Source Control. Se uma pasta recente do servidor ou do banco de dados não puder ser encontrada. desvincular.Caixa de diálogo Change Source Control Cria e gerencia as conexões e ligações que vinculam uma solução ou projeto localmente salvos a uma pasta no banco de dados. conectar ou desconectar um aplicativo da Web criado utilizando as FrontPage Server Extensions. Acesso à caixa de diálogo No Visual Studio. ao trabalhar off-line em seu laptop. Desconectar Desconecta a cópia local de uma solução ou projeto no seu computador da cópia mestre no banco de dados. Atualizar Visual Studio 26 . Conectado Exibe o status da conexão de uma solução ou projeto selecionado. Observação Não é possível usar o Visual Studio para vincular. No menu File. você pode usar este botão para criar um vinculo à pasta mais recentemente utilizada do servidor de controle de origem e banco de dados. Visual Studio 27 . Especifica que o item está incorretamente vinculado ou desconectado da pasta à qual ele pertence. Classificação Altera a ordem de classificação de colunas exibidas. Observação Se você desvincular um projeto da Web. Inválido Desconhecido Especifica que status do item sob controle de origem ainda não foi determinado. Servidor Binding Indica a ligação de um item a um servidor de controle de origem. Nome do servidor Exibe o nome do servidor de controle de origem ao qual a solução ou projeto correspondente está acoplada. Status Identifica o status de vinculação e conexão de um item. Solution/Project Exibe o nome de cada projeto e solução na seleção atual. As possíveis opções são: Opção Válido Descrição Especifica que o item está corretamente vinculado e conectado a pasta do servidor ao qual ele pertence. Especifica que o item não se encontra sob controle de origem. Check-ins também podem ser feitos a partir da janela Pending Checkins. Não controlado Desagrupar Exibe a caixa de diálogo Source Control que permite que você remova os itens selecionados do controle de origem e permanentemente disassocie-os das suas pastas. Caixa de diálogo Check In (Controle de Código Fonte) Verifica um arquivo.Atualiza as informações de conexão para todos os projetos listados nesta caixa diálogo. solução ou projeto alterado no banco de dados do controle de código fonte. será impossível revinculá-lo a seu servidor de controle de origem original até que você altere a localidade de sua cópia de trabalho. Use o comando Add to Source Control ao invés do comando Bind para este item. Flat View Exibe os arquivos onde está sendo feito o check-in como listas simples sob sua conexão com controle de código fonte.Acesso à caixa de diálogo No Visual Studio. Comments Especifica um comentário a ser associado com a operação de check-in. Observação Esta caixa de diálogo também é disponibilizada clicando-se com o botão direito no item na janela Solution Explorer. Tree View Exibe a pasta e a hierarquia dos itens nos quais você estiver realizando o check-in. Check-out para a caixa de diálogo Edit (controle de origem) Faz check-out de soluções. No menu File. Fazer check-out de um item pode copiar a cópia mestre atual para o seu computador local e remover o seu atributo de somente leitura. clique em Source Control depois em Check In. desmarque sua caixa de seleção. Columns Identifica as colunas a serem exibidas e a ordem na qual elas são exibidas. Name Exibe os nomes dos itens onde deve-se fazer o check-in. selecione um item na janela Solution Explorer. Options Exibe opções de check-in específicas de plug-ins de controle de código fonte quando a seta à direita do botão é selecionada. Visual Studio 28 . Sort Altera a ordem de classificação das colunas de exibição. Os itens aparecem com as caixas de seleção ao lado selecionadas. Don't show Check in dialog box when checking in items Impede que a caixa de diálogo seja exibidas durante operações de check-in. A menos que o pacote de controle de origem esteja configurado para dar suporte a checkouts compartilhados. Check In Realiza o check-in de todos os itens selecionados. Se você não desejar fazer check-in de um item específico. Opcionalmente você pode configurar o comando Check Out For Edit para fazer check-out somente da versão local. fazer check-out de um item também bloqueia o item de maneira que ele estará em somente leitura para outros usuários. projetos ou itens individuais do controle de origem. Opções Exibe opções de check-out específicas do plug-in de controle de origem quando a seta à direita do botão é clicada. Nome Exibe os nomes dos itens disponíveis para check-out. Classificação Altera a ordem de classificação das colunas exibidas. clique em Source Control. Verificar saída Faz check-out de todos os itens selecionados. No menu File. Se você não desejar fazer check-out de um item específico. Visual Studio 29 . Editar Permite que você modifique um item sem fazer seu check-out. Não caixa diálogo Show Check Out quando check-out itens Impede que a caixa de diálogo seja exibida durante operações de check-out. Exibir simples Exibe os itens do check-out em progresso como listas simples sob sua conexão de controle de origem. ou outra pasta que você especificar. Colunas Identifica as colunas para exibição e a ordem na qual elas são exibidas. Os itens que estão selecionados aparecem com caixas de seleção ao seu lado.Caixa de diálogo Access No Visual Studio. selecione um item no Solution Explorer. Comentários Especifica um comentário para associar à operação de check-out. Exibir árvore Exibe a hierarquia de pastas e arquivos para o item do check-out em progresso. O botão Edit aparece somente se você tiver o Visual Studio configurado para dar suporte à edição de arquivos com check-in. Observação Esta caixa de diálogo também está disponível clicando com o botão direito do mouse no item no Solution Explorer. Caixa de diálogo Get (controle de origem) Recupera uma cópia somente para leitura do item selecionado do banco de dados para sua pasta de trabalho. depois clique em Check Out For Edit. desmarque sua caixa de seleção. selecione um item no Solution Explorer. Ação Especifica a ação a ser executada nos itens a ser recuperados. Change type Identifica o tipo de alteração que foi feita para o item selecionado. Hora modificado Exibe o momento em que um item foi modificado pela última vez. no menu View. clique em Source Control. desmarque a caixa de seleção correspondente. Opções Exibe opções de recuperação específicas do plug-in do Source Safe quando a seta à direita do botão é clicada. Columns Visual Studio 30 . Observação Esta caixa de diálogo também está disponível clicando-se com o botão direito do mouse sobre o item no Solution Explorer. Nome Exibe os nomes dos itens a ser recuperados. Os itens aparecem com as caixas de seleção ao lado dos mesmos selecionadas.Acesso à caixa de diálogo No Visual Studio. Colunas Identifica colunas para exibição e a ordem na qual elas são exibidas. Exibir árvore Exibe a hierarquia de pastas e arquivos para os itens sendo recuperados. Se você não desejar recuperar um item específico. Você pode usar esta janela para fazer check-in de todos os arquivos com um único clique de botão. Caixa de diálogo de acesso No Visual Studio. depois em Get. clique em Pending Checkins. Exibir simples Exibe os arquivos sendo recuperados como listas simples sob suas conexões ao controle de origem. No menu File. Classificação Altera a ordem de classificação das colunas exibidas. Check In Efetua check-in dos itens selecionados. Janela de check-ins pendentes Exibe todos os arquivos com check-out na solução ou projeto atual. Identifica as colunas para exibição e a ordem na qual elas serão exibidas. Comments Especifica um comentário a ser associado com a operação de check-in. Flat View Exibe os arquivos que você está efetuando check-in na forma de listas simples em sua conexão de controle de origem. Name Exibe os nomes dos itens com check-in a ser efetuado. Os itens aparecem com as caixas de seleção ao seus lados selecionadas. Se você não desejar fazer o check-in de um item específico, desmarque sua caixa de seleção. Options Exibe opções de check-in específicas de plug-ins quando a seta à direita do botão é clicada. Sort Altera a ordem de classificação das colunas exibidas. Tree View Exibe a hierarquia das pasta e arquivos que você estiver efetuando check-in. Undo checkout Reverte o check-out de um item selecionado, o qual perde qualquer alteração feita desde o check out. Guias de plug-in para controle de origem (caixa de diálogo Options) Permitem a personalização de funções de controle de origem e configurações de plug-in no Visual Studio. As guias de plug-in fazem parte da caixa de diálogo Options do Visual Studio, localizada sob a entrada Source Control: • • Plug-in Selection Alterna entre os plug-ins de controle de origem. Environment Especifica as configurações de ambiente para as funções padrões definidas pelo Visual Studio. Por exemplo, se o usuário for um desenvolvedor independente, conflitos com outros usuários não são geralmente criados ao manter itens com check-out após um check-in. Para esta função, o Visual Studio seleciona automaticamente a opção Keep items checked out when checking in. Plug-in Settings Especifica opções para identificar o plug-in de controle de origem associado a um projeto ou solução. • Guia Access No Visual Studio, no menu Tools, clique em Options, e depois em Source Control. Opções são definidas para Plug-in Selection, Environment, e Plug-in Settings. Lista de elementos de interface do usuário, Selection Plug-in Altera o plug-in atual de controle de origem associado ao IDE do Visual Studio, e faz dele o plug-in padrão. O plug-in selecionado é refletido na entrada Source Visual Studio 31 Control no menu File do Visual Studio. Clique em OK para registrar sua alteração e alternar a operação para o plug-in escolhido por você. Observação Você pode usar esta parte da caixa de diálogo Options para desativar o controle de origem clicando em None na lista de plug-ins Lista de elementos de interface do usuário, Environment Permitir que itens a serem editadas checked-in Especifica que itens com check-in podem ser editados na memória. Se este item estiver selecionado, um botão Edit aparecerá na caixa de diálogo Check Out For Edit quando você tentar editar um item com check-in. Check in tudo ao fechar uma solução ou projeto Especifica que você irá fazer check-in de todos os itens ao fechar uma solução ou projeto. Itens Checked-in Contém configurações para salvar e editar itens com check-in. Não Mostrar caixa de diálogo check-out quando check-out itens Especifica que o Visual Studio deve exibir o comando Check Out Now no menu File. Nesse caso, uma caixa de diálogo de check-out não é exibida. Não Mostrar caixa de diálogo check-in ao verificar em itens Especifica que o Visual Studio deve exibir o comando Check In Now no menu File. Nesse caso, uma caixa de diálogo de check-in não será exibida. Não mostrar esta caixa de diálogo novamente Especifica que o Visual Studio não deve mostrar as configurações de ambiente de controle de origem. Edição Especifica a maneira com que itens devem ser manipulados na edição. As opções possíveis são: Opção Prompt for checkout Prompt for exclusive checkouts Check out automatically Do nothing Descrição Especifica que o Visual Studio deve emitir um prompt para um check-out. Especifica que o Visual Studio deve emitir um prompt para check-outs exclusivos. Indica que o Visual Studio deve fazer check-out de itens automaticamente. Especifica que o Visual Studio não deve fazer nada na edição. Obter tudo quando uma solução ou projeto for aberto Visual Studio 32 Recupera a versão mais recente de todos os itens quando você abre uma solução ou projeto. Manter itens check-out ao verificar na Especifica que itens em processo de check-in devem permanecer com checkout para você. Se você desejar alterar esta opção para um check-in específico, clique na seta de Options na caixa de diálogo Check In, e desmarque a opção Keep Checked Out. Redefinir Redefine confirmações. Salvar Especifica a maneira com que itens devem ser manipulados quando você os salva. As opções possíveis são: Opção Prompt for checkout Descrição Especifica que o Visual Studio deve emitir um prompt para check-out em uma operação de salvar. Especifica que o Visual Studio deve fazer check-out automaticamente em uma operação de salvar. Especifica que o Visual Studio deve apresentar um prompt Save as em uma operação de salvar. Check out automatically Save as Configurações de ambiente controle de origem Especifica o nome do plug-in de controle de origem para o qual você está definindo opções de ambiente. Lista de elementos de interface do usuário, Plug-in Settings Avançadas Permite que você defina opções adicionais para usar o plug-in de controle de origem . O botão Advanced só está disponível quando um plug-in de controle de origem válido está instalado no computador local. As configurações avançadas são específicas para o plug-in. Identificação de logon Especifica o nome de usuário para efetuar logon no plug-in de controle de origem. Se seu plug-in der suporte, esse nome será colocado automaticamente na caixa de diálogo de logon usada pelo plug-in de controle de origem para acessar o servidor. Para ativar essa opção, desative logons de usuário automáticos do seu plug-in de controle de origem, e reinicie o Visual Studio. Observação A identificação de logon somente pode ser editada quando um plug-in válido de controle de origem estiver instalado na máquina local. Visual Studio 33 Executar atualizações de status em segundo plano Atualiza automaticamente os ícones de controle de origem no Solution Explorer à medida que o status de item se altera. Se você tiver atrasos ao executar operações intensivas no servidor, especialmente quando abrir uma solução ou projeto do controle de origem, desmarcar esta opção pode melhorar o desempenho. Configurações plug-in Especifica o nome do plug-in de controle de origem para o qual você está fazendo configurações. Caixa de diálogo Source Control Permite que você remova itens do controle de código fonte e desfaça permanentemente a associação entre os itens e suas pastas. Esta caixa de diálogo é usada para propagar as operações excluir, renomear e mover. Acesso à caixa de diálogo No Visual Studio, clique em um item com o botão direito do mouse, em seguida, clique em Delete ou Rename. O conteúdo da caixa de diálogo varia dependendo do comando. Lista de elementos da interface do usuário para renomeações ou movimentações Make my current choice the default action for all future renames or moves Especifica que sua escolha será a ação padrão das operações posteriores de renomear ou mover. Você pode redefinir o padrão em Only rename or move item(s) locally Especifica que os itens devem ser renomeados localmente. Os itens renomeados ou movidos não mais estarão sob controle de versão. Rename or move the item(s) locally and in the source control store Especifica que os itens devem ser renomeados localmente e no banco de dados. A versão mais recente da solução ou projeto não refletirá a renomeação ou a movimentação até o próximo check-in. You are about to rename or move the following Lista os itens que você selecionou para serem renomeados ou movidos. Lista de elementos da interface do usuário para exclusões Delete the item(s) locally and in the source control store Especifica que os itens devem ser excluídos localmente e no banco de dados. A versão mais recente da solução ou projeto não refletirá a operação de exclusão até o próximo check-in. Make my current choice the default action for all future deletes Especifica que a sua escolha será a ação padrão das operações posteriores de exclusão. Only delete item(s) locally Visual Studio 34 Especifica que os itens devem ser excluídos localmente. Outros membros da equipe não são afetados por essa opção até o próximo check-in. Você precisará excluir manualmente os itens no banco de dados após o check-in. You are about to delete the following Lista os itens que você selecionou para exclusão. Caixa de diálogo Undo Checkout (Controle de Código Fonte) Reverte a opção de check-out do item selecionado na janela Solution Explorer. Você perderá qualquer alteração feita desde o último check-out. Acesso à caixa de diálogo No Visual Studio, selecione um item na janela Solution Explorer. No menu File, clique em Source Control e em seguida clique em Undo Checkout. Observação Esta caixa de diálogo também é disponibilizada clicando-se com o botão direito no item na janela Solution Explorer. Columns Identifica as colunas a serem exibidas e a ordem na qual elas são exibidas. Flat View Exibe os itens como listas simples sob a sua conexão com o controle de código fonte. Name Exibe os nomes dos itens para os quais será desfeito o check-out. Os itens aparecem com as caixas de seleção ao seu lado selecionadas. Se você não deseja desfazer o check-out de um item, desmarque sua caixa de seleção. Options Exibe opções para desfazer o check-out específicas de plug-ins de controle de código fonte quando a seta à direita do botão é selecionada. Sort Altera a ordem de classificação das colunas de exibição. Tree View Exibe a pasta e a hierarquia dos itens nos quais você está revertendo o check-out. Undo Checkout Reverte o check-out. Visual Studio 35 Configurações do Visual Studio Configurações no Visual Studio consistir de personalizações feitas para o ambiente de desenvolvimento integrado (IDE) com base em diferentes tipos de atividades de desenvolvimento e seus próprios personalizações. Essas personalizações incluir mostrar ou ocultar determinada layouts janela, colocação dos comandos de menu, nomes de menu, modelos disponíveis na caixa de diálogo Novo projetos, janelas de ferramentas, predefinidas combinações de teclas de atalho, e ajuda filtros, e assim por diante. Com configurações, você pode: • • • Criar uma cópia das suas configurações ativa para uso em uma segunda máquina Compartilhar suas configurações Ativa com outros desenvolvedores Permitir todos os membros da equipe para usar as mesmas configurações em Selecione áreas, como o editor, sem remover personalizações para outras áreas individuais Quais são configurações? Configurações são personalizações ao IDE, como layouts janela, padrões editor, e opções caixa diálogo disponíveis que você pode salvar, Exportar, importar, ou redefinir para facilitar o IDE para usar. As configurações Ativa consistem em duas partes: predefinidas personalizações do arquivo instalado.vssettings você selecionou na primeira vez você iniciou Visual Studio e qualquer personalização IDE subseqüentes que você fez. Configurações ativa são salvas por padrão no currentsettings.vssettings arquivo. Para obter mais informações sobre as configurações predefinidas disponíveis com Visual Studio, consulte os seguintes tópicos. Como configurações funcionam? Quando você inicia Visual Studio, primeiro é necessário para selecionar uma coleção configurações que contém configurações predefinidas projetadas para corresponder seus hábitos de desenvolvimento. Se você atualizar para outro edição do Visual Studio, você também terá a opção de aplicar configurações a outros edição na usando a My Previous Settings opção. A coleção configurações é o primeiro elemento de suas configurações ativa. Cada vez que fizer uma alteração em uma configuração controlada pelo Visual Studio, como alterar a cor do commented código no Editor, a alteração é automaticamente salvo para currentsettings.vssettings juntamente com as configurações predefinidas. O Visual Studio aplica suas configurações ativa automaticamente sempre que você iniciar o Visual Studio. Em alguns casos, você pode alterar as configurações aplicadas como parte de uma coleção predefinida Por exemplo, se uma coleção configurações simplificada caixa de diálogo Opções, ocultando páginas, você pode exibir essas páginas manualmente, selecionando Show all settings. Em outros casos, você não pode substituir a configuração predefinida sem aplicar uma coleção diferente. Para obter uma lista detalhada das personalizações incluídos no configurações predefinidas, consulte Configurações do Visual Studio. Para obter informações sobre como aplicar coleções configurações diferentes, consulte Como: Alterar configurações selecionadas. Visual Studio 36 Configurações podem ser aplicadas de duas maneiras: completamente você pode substituir as configurações Ativa com novas configurações ou você pode substituir uma parte de suas configurações ativa. Importar um arquivo que contém todas as categorias configurações possíveis.vssettings ou aplicar outra coleção configurações dois substituirão as configurações ativa completamente. Importar um arquivo que contém somente um subconjunto das categorias configurações ou unselecting categorias configurações em um arquivo.vssettings.vssettings só se aplica essas configurações que estiver selecionadas, deixando as configurações ativos para as categorias restantes intacto. Ajuda e Configurações Coleções configurações predefinidas também fornecer personalizações à Ajuda. Configurações especificam o padrão How Do I Página na Ajuda. Eu selecionado como pendente eu página filtros fazer o conteúdo que aparece no índice analítico e no índice,, bem como fornece conteúdo personalizado na caixa como guia. Você pode alterar o ativo How Do I página na lista drop-down como pendente eu outras páginas. Configurações e segurança Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança se você compartilhar suas configurações com outros usuários. Inversamente, se você pretende importar configurações fornecidas por outras pessoas, você precisará estar ciente das categorias dentro do arquivo configurações que podem ser uma questão de segurança. Um ícone aparece ao lado essas categorias com as possíveis questões de segurança. Essas categorias configurações incluem: • • Favoritos Importar e exportar configurações Como: Alterar configurações selecionadas Você pode aplicar um sub-set das configurações de uma coleção configurações diferentes para as configurações atuais para criar um ambiente de desenvolvimento mais personalizada. Para obter mais informações sobre configurações predefinidas, consulte Configurações do Visual Studio. Para alterar configurações selecione 1. 2. 3. 4. 5. No menu Tools, escolha Import and Export Settings. Na Welcome to the Import and Export Settings Wizard Página, clique em Import selected environment settings e clique em Next. Na página Save Current Settings, selecionar Yes, save my current settings, e clique em Next No Which collection of settings do you want to import, selecione uma coleção configurações na lista e clique em Next. No Which settings do you want to import, expanda a lista e selecione apenas a categorias ou itens de categoria que você deseja que se aplicam as configurações atuais. Clique em Finish. A Reset Complete página lista os erros associados a redefinindo as configurações com Details. 6. Visual Studio 37 Trabalhando com configurações Esta seção contém informações sobre a aplicação, exportar e importar configurações para personalizar o ambiente de desenvolvimento integrado (IDE) para melhor correspondência seu estilo de desenvolvimento. Você também pode encontrar informações gerais sobre como configurações funcionam e os tipos de itens que são personalizadas através das configurações. Além disso, aprender a especificar um conjunto de configurações de uso da equipe. COMO: Compartilhar configurações entre computadores Você pode exportar configurações para o editor, projetos, depuração, fontes e cores, e outras áreas IDE a um arquivo que você pode importar e usar em outro computador, como seu computador de desenvolvimento segundo ou computador um colega na. Exportar configurações para um arquivo Você pode optar por exportar todas ou algumas das suas configurações atuais a um arquivo.vssettings que você pode usar em um computador segundo ou compartilhar com outros desenvolvedores. Para exportar configurações 1. 2. 3. No menu Tools, escolha Import and Export Settings. Na Welcome to the Import and Export Settings Wizard Página, clique em Export selected environment settings e clique em Next. No Which settings do you want to export?, selecione as categorias você pretende exportar e, em seguida, clique em Next Configurações. Observação Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. 4. 5. 6. 7. No What do you want to name your settings file, digite um nome para o arquivo de configurações. Se você gostaria de salvar o arquivo em um local diferente, clique Browse ou digite um novo caminho para Store my settings file in this directory. Clique em Finish. Na página Export Complete, examine os erros associados à exportação as configurações com Details. Importar um arquivo.vssettings Após ter criado um arquivo.vssettings, você pode usar esse arquivo em outros computadores ao importar esse arquivo para outra instalação do Visual Studio. Você também pode importar arquivos de configuração criados por outros usuários e aplicar essas configurações para o Visual Studio. Se você está importando o arquivo configurações contém todas as categorias configurações possíveis, importar esse arquivo completamente substitui as configurações existentes. Importar o arquivo se um arquivo de configurações Visual Studio 38 contém apenas um subconjunto das categorias configurações, apenas aplica essas categorias e não afeta as configurações atuais para categorias não importadas. Um desenvolvedor na equipe por exemplo, tem exportadas todas as sua configurações para um arquivo para que outras pessoas na equipe podem utilizá-lo. Se você desejar se aplicar as configurações de fontes e cores e as configurações teclado desse arquivo, somente você pode limpar todos os outras categorias configurações e apenas aplicar as configurações selecionadas sem alterar as configurações atuais para as categorias restantes Para importar configurações 1. 2. 3. No menu Tools, escolha Import and Export Settings. Na Welcome to the Import and Export Settings Wizard Página, clique em Import selected environment settings e clique em Next. Logon Save Current Settings, optar Yes, save my current settings por criar um backup de suas personalizações IDE atuais; optar No, just import new settings, overwriting my current settings por continuar sem fazer o backup suas personalizações IDE atuais. No What collection of settings do you want to import?, selecione um arquivo na lista ou clique Browse para localizar um arquivo de configurações e clique em Next. No Which settings do you want to import?, selecione as configurações opções você pretende importar do arquivo.vssettings selecionado. Observação Algumas categorias configurações podem conter informações que podem ser uma questão de segurança. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. 6. 7. 8. Clique em Finish. Na caixa Save Current Settings de diálogo, decidir se deve ou não para salvar as configurações atuais. Na página Import Complete, examine os erros associados a importar as configurações em Details. 4. 5. Compartilhar um arquivo único.vssettings entre computadores Em vez de criar uma cópia das suas configurações atuais e usando a cópia em outro computador, você pode compartilhar um arquivo.vssettings único em um compartilhamento de rede. Essa técnica pode ser útil se você desejar as personalizações mesmas exatas disponíveis em todas as vezes em vários computadores. Quando você compartilhar um arquivo.vssettings único em vários computadores, personalizações feitas, independentemente do computador no qual você torná-los na, são salvas para o arquivo.vssettings. A lista Tarefas por exemplo, se você fechar a lista de tarefas em um computador, na próxima vez que você iniciar o Visual Studio em outros computadores, não será exibida. Para compartilhar um arquivo único configurações entre computadores 1. 2. No menu Tools, escolha Options Na pasta Environment, escolha Import and Export Settings. Visual Studio 39 3. 4. 5. Na Automatically save my settings to this file, digite uma pasta compartilhada ou clique Browse para localizar um compartilhamento de rede. Clique em OK. No segundo computador, repita as etapas 1 a 4. Como: Especificar configurações para uma equipe Quando estiver trabalhando em um grupo, ele pode ser útil para que cada desenvolvedor usar as configurações mesmas exatas em algumas áreas do ambiente de desenvolvimento integrado (IDE), como o editor. Você pode incentivar Essa consistência criando um arquivo.vssettings para um subconjunto de categorias configurações disponíveis que todos os desenvolvedores de seu grupo podem usar. Quando aplicado, essas configurações da equipe não seria substituem qualquer categoria não especificada no arquivo.vssettings, permitindo que desenvolvedores individuais para manter personalizações feitas para outras áreas do IDE. Para obter informações sobre como criar um arquivo.vssettings, consulte COMO: Compartilhar configurações entre computadores. O Visual Studio verifica que você estiver usando a versão mais recente do arquivo.vssettings de grupo sempre que você iniciar o Visual Studio. Quaisquer alterações feitas no arquivo.vssettings são aplicadas automaticamente. Para especificar um arquivo.vssettings para uso em um grupo 1. 2. 3. 4. 5. Partir do Tools menu, escolha Options. Na pasta Environment, escolha Import and Export Settings. Selecione Use team settings file. Insira um UNC ou caminho local, ou clique Browse para localizar o arquivo.vssettings de grupo. Clique OK para aplicar as configurações. Import and Export Settings Wizard Use este assistente para exportar configurações, importar configurações, ou substituir as configurações para usar uma coleção configurações predefinidas. Opção Exportar configurações de ambiente selecionada Importar configurações de ambiente selecionada Redefinir todas as configurações Descrição Salvar um subconjunto ou todas as suas configurações existentes para que você pode usar essas configurações em outro computador. Aplica as configurações em um arquivo você tiver recebido. Substitui existentes configurações com os do arquivo importado. Permite que você se reverter as configurações de volta para uma das configurações predefinidas disponíveis com o produto. Você pode acessar este assistente a partir do Tools Menu, escolhendo Import and Export Settings. Visual Studio 40 Escolha Configurações para exportar, importar e exportar configurações Assistente Use esta página do Assistente para configurações a importação e exportação para especificar algumas ou todas as suas configurações atuais ser exportados para um arquivo para uso em outros computadores. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. • COMO: Compartilhar configurações entre computadores Selecione para exportar todas as configurações, ou especificar um sub-set das configurações por categoria ou item de categoria. Observação Configurações que podem conter informações de identificação sobre você ou seu computador são marcadas com um gráfico de aviso. Essas configurações não são selecionados por padrão, mas são automaticamente selecionados se você escolher All Settings. Which settings do you want to export? Nomeie O arquivo de configurações, importar e exportar configurações Assistente Use esta página do Assistente para configurações a importação e exportação para especificar o nome e local do arquivo que irá conter as configurações exportadas. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. COMO: Compartilhar configurações entre computadores What do you want to name your settings file? Digite um nome personalizado para as configurações exportadas. Store my settings file in this directory. Especifica o diretório padrão no qual as configurações exportadas serão salvos. Clique Browse para especificar uma pasta personalizada. Salvar configurações atuais, importar e Assistente para exportação configurações Use esta página do Assistente para configurações a importação e exportação para salvar as configurações ativos antes de importar novas configurações. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. COMO: Compartilhar configurações entre computadores Yes, save my current settings Selecione esta opção para criar um backup das suas configurações atuais. Mais tarde você pode optar por importar essas configurações para retornar ao estado IDE atual. Visual Studio 41 Setting file name Store my settings file in this directory Digite um nome personalizado para as configurações atuais. Especifica o diretório padrão no qual as configurações atuais serão salvos. Clique Browse para especificar uma pasta personalizada. No, just import new settings, overwriting my current settings Selecione esta opção se você não quiser backup as configurações atuais. Se você está importando o arquivo configurações contém configurações para itens de categoria você ter personalizado, as configurações importadas substituirá as alterações. Escolha Configurações para importar, importar e Assistente configurações exportação Use esta página do Assistente para configurações a importação e exportação para especificar a coleção Configurações você pretende importar. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. • COMO: Compartilhar configurações entre computadores Selecione uma coleção na lista, ou clique Browse para localizar uma coleção diferente para importar. Which settings do you want to import? Description Exibe informações sobre a coleção configurações que são otimizadas para. Somente disponível para Default Settings. Escolha um coleção de configurações para importar, importar e Assistente configurações exportação Use esta página do assistente Importar e exportar configurações para especificar uma coleção configurações predefinidos ou uma coleção configurações personalizadas você deseja importar para uso no IDE. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. • Como: Alterar configurações selecionadas Lista as coleções configurações disponíveis. Clique Browse para navegar para uma coleção configurações que não aparece na lista. Which collection of settings do you want to import? Description Exibe informações sobre a coleção configurações que são otimizadas para. Para obter mais informações sobre coleções configurações predefinidas, consulte Configurações do Visual Studio. Visual Studio 42 Details Exibe informações sobre qualquer sucesso ou falhas. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings.<task> Complete. Import and Export Settings Wizard Esta página do importação e assistente exportar para configurações exibe informações sobre a tarefa configurações concluída com êxito ou não e todos os erros que foram encontrados. Visual Studio 43 . que o torna um bom local para iniciar o aprendizado sobre o produto ou uma área de um recurso específico. o projeto usa seu computador local. Implementar o XML Web Services. Digite o endereço do servidor Web no qual você irá desenvolver o XML Web Services e especifique TempConvert1 como o nome do diretório. tal como " http://MyServer/TempConvert1 ". " http://localhost ". Por padrão. Por padrão. Esta seção contém links para C# programação orientações e depuração orientações. Executar o XML Web Services no modo de depuração.NET no Visual Web Developer.Walkthroughs Visual C# As explicações passo a passo fornecem instruções passo a passo para cenários comuns. Criar projeto serviço XML da Web O Visual Studio fornece um modelo de projeto ASP. consulte Tour guiado da criação de sites no Visual Web Developer e Passo a passo: Criando e usando um serviço da Web do ASP. selecione o ícone ASP. escolha New Web Site.NET Web Service Project 1. Para concluir o explicação passo a passo. No menu File. voce desenvolve e constrói o projeto em um Visual Studio 44 . Implantar o XML Web Services. aplicativos da Web e XML Web Services estão localizados em um servidor Web e derivam seus nomes do diretório virtual especificado no servidor. Observação Você desenvolve XML Web Services em um servidor de desenvolvimento. 3. Na caixa de diálogo New Web Site. Explicação Passo a Passo: Criando um XML Web Services usando Visual Basic ou Visual C# Explicação passo a passo a seguir descreve o processo para criar um XML Web Services que converte temperaturas medidas em Fahrenheit para Celsius usando Visual Basic ou C# visual. Você durante esta explicação passo a passo. Para criar um ASP.NET Web Service para ajudá-lo a criar XML Web Services no Visual Basic e Visual C#. 2. Normalmente. você precisará ter acesso a uma máquina que atende aos requisitos para criar um projeto da Web. Observação Para alguns tipos de projeto.NET Web Service. você irá realizar as atividades a seguir: • • • • Criar um XML Web Services usando o modelo projeto serviço ASP. Por exemplo. Para obter mais informações. o servidor de desenvolvimento é sua máquina local. o caixa de texto Name está disponível porque especificando a localidade define em vez disso o nome do projeto.NET Web. WebService com o No arquivo código Service. Clique com o botão direito do mouse Service.32) * 5) / 9. consulte COMO: Usar o Atributo WebMethod.")] public double ConvertTemperature(double dFahrenheit) { return ((dFahrenheit . _ Description:="A temperature conversion service.")> _ Public Function ConvertTemperature(ByVal dFahrenheit As Double) _ As Double Return ((dFahrenheit . Para obter mais informações. Visual Studio 45 . Description="A temperature conversion service. Service. Clique OK para criar o projeto.Web. 3. se você estiver desenvolvendo diretamente no servidor que hospedará o XML Web Services. Substituia o código de atributo System. 4. consulte COMO: Usar o Atributo WebService. Para obter mais informações. localize o código para a declaração de classe seguinte código antes da declaração de classe (mostrada em negrito): Visual Basic <System.Web. Para obter mais informações.32) * 5) / 9 End Function [WebMethod(Description="This method converts a temperature in " + "degrees Fahrenheit to a temperature in degrees Celsius. e então você o implementa em outro servidor (o servidor se implementação) que irá hospedar o XML Web service usando um projeto de implementação. Para XML Web Services criados no Visual Studio.asmx em Solution Explorer e clique Set as Start Page no menu de atalho. Quando você criar um projeto XML Web Services no Visual Studio. O Visual Studio automaticamente cria os arquivos necessários e inclui as referências necessárias para suportar um XML Web Services.Services. Para adicionar um método de XML Web Service 1. 2.WebService( _ Namespace:="http://Walkthrough/XmlWebServices/".WebService( Namespace="http://Walkthrough/XmlWebServices/". A propriedade description desse atributo está incluída na página de ajuda de Service.servidor de desenvolvimento.asmx do XML Web Services que o Visual Studio criou para você contém esse código. adicione o seguinte código para declarar a função ConvertTemperature: Visual Basic <WebMethod(Description:="This method converts a temperature in " & _ "degrees Fahrenheit to a temperature in degrees Celsius. consulte COMO: Criar um Método de Serviço da Web XML. Entretanto.Services. um arquivo oculto code-behind associado ao arquivo. A propriedade description deste atributo está incluído na página ajuda de Service e na página de ajuda Service Methods.vb. como um namespace para o XML Web Service e uma descrição para o XML Web Service.Web.WebService Unindo o atributo WebService à classe Public se torna possível a inclusão de informação adicional sobre o XML Web Service.")] public class Service : System. Na classe Service.Services. o servidor de desenvolvimento e o servidor de implantação são os mesmos.")> _ Public Class Service [System.Web.Services. } Anexando o atributo WebMethod a um método Public expõe esse método como parte do XML Web Services. verá o criador de componente para Service1.asmx. Implementar o serviço da Web XML A próxima etapa é escrever o código para implementar a funcionalidade do XML Web Services que os clientes irão acessar. Para obter mais informações. 3. No menu Debug. Para obter mais informações. você pode executar uma variedade de tarefas. Antes de depuração.asmx em um navegador. escolher New Breakpoint. consulte XML Web Service Description. O Visual Studio cria o projeto e o implanta para o servidor de desenvolvimento designado. o processamento pára. No menu Debug. Após a conclusão. verifique as configurações de depuração. digite o número 212. Na página de ajuda Service. Para obter mais informações. consulte Como Depurar XML Web Services em Código Não Gerenciado. consulte HOW TO: definir depuração e configurações de versão. Salvar a solução. Depurar o XML Web Service O Visual Studio oferece vários métodos para criar e executar um XML Web Services a partir da IDE.NET. Quando o processamento atingir a função ConvertTemperature. No menu Debug. 5. clique Ok na janela Debugging Not Enabled para iniciar depuração. consulte Projetos Serviço da Web XML depuração preparação:. Para obter mais informações. enquanto ele é interrompido. clique no link ConvertTemperature. O XML Web Services responde retornando o valor convertido em um documento XML semelhante ao seguinte: Visual Studio 46 . Quando você abre um arquivo. tais como: • • • Iniciar (com depuração) Iniciar sem depuração Modo de Exibição no navegador Como um projeto Visual Studio. digite ConvertTemperature na caixa Function e clique OK para adicionar um ponto de interrupção na declaração de método ConvertTemperature. e clique no botão Invoke. o XML Web Services retorna uma página Service auxiliar que fornece informações sobre o XML Web Services.asmx a partir do servidor de implantação. Para obter mais informações. clique em Continue para continuar o processamento. Para usar um ponto de interrupção e iniciar o XML Web Services com depuração 1. O depurador Visual Studio realça a linha que contém o ponto de interrupção. o navegador padrão exibe o arquivo. Visual Studio automaticamente criou essas configurações e definiu as opções padrão apropriadas e outras configurações. consulte Explicação detalhada sobre o depurador e Exibindo Dados no Depurador. Na guia Function. clique em Start. este XML Web Services tem configurações separadas para as versões de lançamento e depuração. 4. 6. Nesta explicação passo a passo. então Break At Function. O Service Description link leva você para um documento XML que contém a descrição serviço formal do XML Web Services. 2.4. será colocado um ponto de interrupção no XML Web Services e usado o método Start (with Debugging). Este comando instrui o Visual Studio a executar o XML Web Services no depurador. Como você criou este projeto usando o modelo de projeto do serviço da Web ASP. Na caixa dFahrenheit. Para obter mais informações. você pode adicionar um projeto Web Setup ou copiar os arquivos necessários para o servidor de destino. selecione Content Files. Implantando o XML Web Service Para tornar seu XML Web Services disponível para outros. e clique OK. clique em Stop Debugging. e clique em Web Setup Project. GLOBAL.<?xml version="1. Clique no ícone ao lado da caixa suspensa Connect To para abrir a caixa de diálogo Open Web Site. clique Build. e no menu de atalho. o 7.asax. No Solution Explorer. Clique em OK. 4. 8.asmx. clique em Delete All Breakpoints. você deve implantá-lo em um servidor Web que seja acessível para os clientes que você queira dar suporte. No menu Debug. 5. Na caixa Name. clique com o botão direito do mouse no projetoTempConvert1WebSetup. e clique New Project. selecione Web Application Folder. e Web. Para obter mais informações. Nesta explicação passo a passo. Observação Por padrão.config. no menu Debug. copiando o projeto 1. No Solution Explorer. clique em Copy Web Site. digitar TempConvert1WebSetup. e o nó Setup and Deployment Projects. Isso cria um arquivo do Windows Installer no diretório de projeto local. Executar este arquivo instala o aplicativo da Web. Navegue para a localidade para a qual você deseja copiar o projeto. 2. 6.0" encoding="utf-8" ?> <double xmlns="http://Walkthrough/XmlWebServices/">100</double> Para interromper a execução do XML Web Services e retornar ao editor de código. o instalador usa o nome do projeto de implantação ao criar o diretório virtual em seu servidor de implantação. Para obter mais informações. você pode escolher como implantar este XML Web Services. Para implantar o XML Web Services. Selecionar o nó Other. 3. 2. clique com o botão direito do mouse em TempConvert1WebSetup. Para obter mais informações. Para distribuir o XML Web Services para um servidor que não seja o servidor de desenvolvimento. consulte File System Editor. No menu File. consulte COMO: Implantar Serviços da Web XML no Código Gerenciado. selecione o projeto TempConvert1. O grupo Content Files consiste dos seguintes arquivos para o XML Web Services: Service1. 7. No menu Project. Na caixa de diálogo Add Project Output Group. consulte Como adicionar e remover Outputs Project no File System Editor:. 3. aponte para Add. No Solution Explorer. aponte para Add. Para implantar o XML Web Services usando um projeto Web Setup 1. Visual Studio 47 . e clique Project Output. consulte COMO: Implantar Serviços da Web XML no Código Gerenciado. No painel esquerdo do File System Editor. 5. consulte Tour guiado da criação de sites no Visual Web Developer. que foi o nome dado ao XML Web Services criado no Explicação Passo a Passo: Criando um XML Web Services usando Visual Basic ou Visual C#. Finalmente. você vai criar um aplicativo simples da Web que acessa o XML Web Services TempConvert1. Para obter detalhes. Um XML Web Services criado a partir desta explicação passo a passo: Explicação Passo a Passo: Criando um XML Web Services usando Visual Basic ou Visual C# Criando um projeto cliente de XML Web Services Para concluir a explicação passo a passo.NET Visual Studio 48 . você deve fornecer o seguinte: • • o Nesta explicação passo a passo. para criar um aplicativo cliente que acesse esse XML Web Services. consulte Segurança de site ASP.4. Criar um aplicativo ASP. clicando no ícone de seta à direita. Durante o curso desta explicação passo a passo. Escrever código para acessar o XML Web Services. Você também precisará de permissões suficientes para ser capaz de criar projetos XML Web Services no computador onde seu servidor Web está. Implantar o aplicativo da Web. selecione os arquivos para copiar e movê-los para o painel Remote Web Site. No painel Source Web Site. Executar o aplicativo da Web no modo de depuração. você deve fornecer uma máquina que atenda aos requisitos para criar um projeto da Web. você irá realizar as atividades a seguir: • • • • • Criar um aplicativo cliente usando o modelo de projeto de aplicativo ASP.NET (Visual Studio).NET. Adicionar uma referência da Web para um XML Web Services. Para obter mais informações. basta substituir os nomes apropriados onde aparece o nome TempConvert1 ao longo desta explicação passo a passo. Observação Se você alterou o nome do XML Web Services temperatura de conversão ao criá-lo. consulte um destes procedimentos: • • • Passo-a-Passo: acessando um XML Web Services utilizando Visual Basic ou Visual C# Acessar um serviço da Web XML usando C++ Walkthrough: Acessar um serviço da Web XML usando C++ e o CLR Walkthrough: Passo-a-Passo: acessando um XML Web Services utilizando Visual Basic ou Visual C# A explicação passo-a-passo a seguir descreve o processo para acessar um XML Web Services de um aplicativo criado com Visual Basic ou Visual C#. Devido ao fato desta explicação passo a passo usar um aplicativo da Web para acessar um XML Web Services. Clique Copy Web Site para copiar o site. . Clique com o botão direito do mouse no botão adicionado. se você estiver desenvolvendo diretamente no servidor que hospeda o aplicativo da Web. Adicionar uma referência da Web ao seu projeto para o XML Web Services faz isso por gerar uma classe proxy que interfaceia com o XML Web Services e fornece uma representação local do XML Web Services. Tipicamente. Clique em OK para criar o projeto. selecione o ícone ASP. e clique em Properties no menu de atalho. A descrição de serviço descreve quais serviços estão disponíveis e como interagir com os serviços. O processo de descoberta de XML Web Services no Visual Studio envolve interrogar um site da Web seguindo um algoritmo predeterminado. escolha New Web Site. Adicionando uma referência da Web Descoberta de XML Web Services é o processo pelo qual um cliente localiza um XML Web Services e obtém sua descrição de serviço. Para obter mais informações. Button1. Por padrão. aplicativos da Web e XML Web Services estão localizados em um servidor Web e derivam seus nomes do diretório virtual especificado nesse servidor. Sem uma descrição de serviço. Da guia Web Forms da Toolbox. 7. No menu File. você desenvolve e compila o projeto em um servidor de desenvolvimento e depois você o implanta em outro servidor (o servidor de implantação) que hospeda o aplicativo da Web usando um projeto de implantação. e clique em Properties no menu de atalho. 8. Digite o endereço do servidor Web no qual você irá desenvolver o aplicativo da Web e especifique TempConvertClient1 como o nome do diretório. defina a propriedade Text como Convert. Na caixa de diálogo New Web Site.aspx e escolha View Designer para abrir o designer.aspx e organize-os ao seu gosto. uma Label e um Button para a superfície de design de Default. a caixa de texto Name está indisponível porque a especificação da localidade define o nome do projeto no lugar. clique com o botão direito do mouse em Default. desmarque a propriedade Text para fazer deste um rótulo em branco. Clique com o botão direito do mouse no rótulo adicionado. Seu aplicativo deve ter um meio para se comunicar com o XML Web Services e para localizá-lo em tempo de execução. A meta do processo é localizar a descrição de serviço. tal como " http://MyServer/TempConvertClient1 ". consulte Descoberta de XML Web Service.1. é impossível interagir com um XML Web Services programaticamente.NET Web Site. consulte Descrição de XML Web Service. 4. que é um documento XML que usa o WSDL (Web Services Description Language). Para obter mais informações. Entretanto. 6. 2. Por exemplo. " http://localhost ". Label1. o projeto usa sua máquina local. arraste uma Text Box. Para Visual Studio 49 . No Solution Explorer. 3. Por padrão. Observação Para alguns tipos de projeto. Na janela Properties. o servidor de desenvolvimento e o servidor implantação são os mesmos. Observação Você desenvolve aplicativos da Web em um servidor de desenvolvimento. 5. o servidor de desenvolvimento é sua máquina local. Na janela Properties. escolha Add Web Reference. } catch { Label1. 2.Service1 ws = new ConvertSvc. Label1. que é o namespace que você usará para essa referência da Web. No menu Website. Primeiro. o código da classe proxy gerado pelo Visual Studio lida com as comunicações entre seu aplicativo e o XML Web Services. System.obter mais informações. 3. . Você então irá exibir o valor retornado do XML Web Services no Label1. consulte Adicionando e Removendo Referências da Web.ConvertTemperature(dFahrenheit). Clique no link para o XML Web Services TempConvert1 na lista fornecida para recuperar informações sobre o XML Web Services. digite o URL para obter a descrição de serviço do XML Web Services que você deseja acessar.asmx.ToDouble(TextBox1. double dCelsius = ws.Text) dCelsius = ws. double dFahrenheit = Convert. fornecido em TextBox1.ConvertTemperature(dFahrenheit) Label1.". a próxima etapa consiste em criar uma instância da classe proxy do XML Web Services.ToString(). Adicionar uma referência da Web 1. chamando métodos na classe proxy.Click Dim ws As New ConvertSvc. Você pode acessar os métodos do XML Web Services da mesma maneira que você acessa quaisquer métodos de objeto. O Visual Studio baixa a descrição de serviço e gera uma classe proxy para interfacear entre seu aplicativo e o XML Web Services. renomeie a referência da Web para ConvertSvc.Text = "Conversion failed. } } 4.Text = "Conversion failed. Na caixa URL da caixa de diálogo Add Web Reference. Para obter mais informações. Acessar o XML Web Services 1. tal como http://localhost/TempConvert1/Service1. 2. Quando o aplicativo chama esses métodos. Clique duas vezes no botão Convert em WebForm1.ou Se o XML Web Services está na máquina local. e fará uma chamada para o método ConvertTemperature do XML Web Services usando a classe proxy.ToDouble(TextBox1." End Try End Sub // C# protected void Button1_Click (System. consulte Referências da Web e Gerando um Proxy de XML Web Service. você criará uma instância da classe proxy do XML Web Services.aspx para criar um método de tratamento de evento para este botão e para exibir o arquivo code-behind. Em seguida. Acessando o XML Web Services Quando você adiciona uma referência para o XML Web Services ao seu projeto.Text = dCelsius.EventArgs e) { try { ConvertSvc. clique no link Web services on the local machine no painel do navegador. Insira o código a seguir: ' Visual Basic Protected Sub Button1_Click(ByVal sender As Object.Object sender. Clique no botão Go para recuperar informações sobre o XML Web Services.Service Dim dFahrenheit As Double Dim dCelsius As Double Try dFahrenheit = Convert. Na caixa Web reference name.Service1().Text = dCelsius. você pegará um valor. Clique em Add Reference para adicionar uma referência da Web para o XML Web Services destino.Text).ToString() Catch Label1. _ ByVal e as EventArgs) Handles Button1. Visual Studio 50 . Antes da depuração. consulte Acessando um XML Web Services em Código Gerenciado. 5. Digite Button1_Click na caixa Function e clique em OK para colocar um ponto de interrupção no manipulador de eventos Button1_Click. consulte Depurando XML Web Services em Código Gerenciado. Usar um ponto de interrupção e iniciar o aplicativo da Web com depuração 1. 3. este aplicativo da Web tem configurações separadas para versões Release e Debug. Depurando o cliente de XML Web Services O Visual Studio oferece vários métodos para criar e executar um aplicativo da Web a partir do IDE. Salve a solução. Selecione Default. Depois que a página é exibida no navegador. enquanto interrompido. o Visual Studio automaticamente criou essas configurações e definiu as opções padrão apropriadas e outras configurações. O Visual Studio compila o projeto e o implanta no servidor de desenvolvimento designado.Observação O nome da classe de XML Web Services gerado ao adicionar uma referência da Web pode diferir daquele mostrado acima como Service1. Para obter mais informações. Este comando instrui o Visual Studio a executar o aplicativo da Web no depurador. o processamento pára. 4.aspx no servidor implantação. No menu Debug. 2. você colocará um ponto de interrupção no evento Button1_Click e usará o método Start (with debugging). Quando o processamento atinge o manipulador de eventos Button1_Click. clique em Start. depois clique em Ok na janela Debugging Not Enabled para iniciar a depuração. clique em New Breakpoint e em seguida escolha Break At Function. consulte Visão geral sobre pontos de interrupção. Nesta explicação passo a passo. Para obter mais informações. Para obter mais informações. consulte Configurações Debug e Release. verifique as configurações de depuração. O depurador do Visual Studio realça a linha que contém o ponto de interrupção e. No menu Debug.NET. Desde que você criou este projeto usando o modelo de projeto de aplicativo ASP.NET. Para obter mais informações. 3. tais como: • • • Start (with Debugging) Start without Debugging View in Browser Como um projeto do Visual Studio. consulte Preparação de Depuração: Aplicativos ASP. clique em Set as Start Page.aspx no Solution Explorer. você poderá executar uma Visual Studio 51 . No menu Website. Após a conclusão. o navegador padrão inicia e navega para o arquivo . digite o número 212 na caixa de texto e depois clique no botão Convert. Para obter mais informações. copiando o projeto 1. consulte File System Editor. o 7. clique com o botão direito do mouse no projeto TempConvertClient1WebSetup e. No Solution Explorer.variedade de tarefas. 3. 5. Nesta explicação passo a passo. clique em Continue para continuar o processamento. você deve implantá-lo em um servidor Web que seja acessível para os clientes que você deseja dar suporte. tais como WebForm1. O grupo Content Files consiste nos arquivos restantes para o aplicativo da Web. 2. Para obter mais informações. Para obter mais informações. clique em Build. Observação Por padrão. aponte para Add e depois clique em Project Output. consulte Implantando Aplicativos e Componentes. Para interromper a execução do aplicativo da Web e retornar ao editor de código. consulte Usando o Depurador e Ferramentas de Depuração para Inspeção de seu Programa. Implantar o aplicativo da Web usando um Web Setup Project 1. digite TempConvertClient1WebSetup e depois clique em OK. você pode adicionar um Web Setup Project ou copiar os arquivos necessários para o servidor de destino. aponte para Add e depois clique em New Project. selecione Web Application Folder. selecione o projeto TempConvertClient1. você pode escolher como implantar este aplicativo da Web. 6.config. Para obter mais informações. clique em Copy Web Site. Visual Studio 52 . No menu Project. 5. 4. clique em Stop Debugging. 6. No painel esquerdo do File System Editor.aspx e Web. 4. Na caixa Name. selecione Content Files. No menu Debug. no menu de atalho. Para obter mais informações. 8. Clique em OK. clique em Clear All Breakpoints. No Solution Explorer. Implantando o cliente Para tornar seu aplicativo da Web disponível para outros. Selecione o nó Other e depois o nó Setup and Deployment Projects e depois clique em Web Setup Project. no menu Debug. Executar este arquivo instala o aplicativo da Web. No Solution Explorer. clique com o botão direito do mouse em TempConvertClient1WebSetup. consulte Adicionando e Removendo Saídas de Projetos no File System Editor. Implantar o aplicativo da Web. No menu File. O XML Web Services responde retornando o valor convertido e o aplicativo define o texto do Label1 para 100. No menu Debug. 2. Para implantar o aplicativo da Web em um servidor que não seja o servidor de desenvolvimento. Isso cria um arquivo do Windows Installer no diretório do projeto local. o instalador usa o nome do projeto de implantação ao criar o diretório virtual em seu servidor de implantação. Na caixa de diálogo Add Project Output Group. Para alterar as configurações. se dois conjuntos de módulos (assemblies) fornecer componentes nomeado CDemo. clique com o botão direito do mouse CDemo. Visual Studio 53 . um Cliente. 3. Observe que a Default namespace caixa contém CDemoLib. e nome do projeto. selecione os arquivos para copiar e mova-os para o painel Remote Web Site. Por exemplo. Criando o projeto Para criar a biblioteca de classes CDemoLib e o componente CDemo 1.CDemo Feche a caixa de diálogo. clique com o botão direito do mouse CDemoLib e selecione Properties a partir do menu de atalho. Abre o editor de código. clicando no ícone da seta direita. Um cliente pode ou não pode estar no mesmo conjunto como um componente ele usa. Clique no ícone ao lado da caixa suspensa Connect To para abrir a caixa de diálogo Open Web Site. Clique Add para crate o componente. No Solution Explorer. Para obter mais informações.cs e escolha View Code a partir do menu de atalho. Os seguintes procedimentos criar no entre si. você pode especificar seu CDemo componente usando CDemoLib. Navegue para a localidade que você deseja copiar o projeto.. Isso define o espaço para nome raiz. e também garante que o componente padrão será no espaço para nome correto. 2. A raiz é usado para qualificar os nomes dos componentes no conjunto. No painel Source Web Site. consulte Configurações do Visual Studio. de forma a ordem na qual você realizá-las é importante. Observação Sempre especifique o nome de um novo projeto ao criá-la. Clique em Copy Web Site para copiar o site da Web. Um componente denominado CDemo é adicionado à sua biblioteca de classe. A partir do Project menu. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição.3. Na caixa Add New Item de diálogo. É conhecido como um aplicativo que usa código é um componente. selecione New e Project Para abrir caixa New Project de diálogo. Um componente com Visual C# Walkthrough: criação Componentes forneça reutilizáveis código sob a forma de objetos.cs na caixa Name. selecione Component Class e digite CDemo. escolha Add Component. No Solution Explorer. nome conjunto. 5. No menu File. Selecione o Class Library modelo de projeto a partir da lista de Visual C# tipos de projeto. escolha Import and Export Settings No menu Tools. e digite CDemoLib na caixa Name. 5. 4. criando objetos e chamar suas propriedades e métodos. 4. 2. Para adicionar código para o construtor e destruidor da classe CDemo 1. Porque e NextInstanceID variáveis de membros são declaradas static. com parâmetros diferentes. ClassInstanceCount ++. Código no construtor e o Finalize método da CDemo classe mantém uma contagem do número de CDemo objetos em execução no existência. todos os construtores ter o mesmo nome que a classe. 5.cs e escolha Delete. 3. Adicione variáveis de membros para manter uma execução o Code Editor public readonly int InstanceID. O componente pode ter vários construtores. ou na primeira vez um dos membros estático é acessado. Como um readonly membro. o InstanceCount Todas as instâncias do CDemo que acessar esses membros usará os mesmos locais de memória. e. private static int NextInstanceID = 0. InstanceID = NextInstanceID ++. Isso exclui a classe padrão que é fornecido com a biblioteca de classes. optar Save All por salvar o projeto. como ele não será ser usado nessa explicação passo a passo.Aviso imediatamente após public partial class CDemo. Observação O nível de acesso dos construtores determina os clientes serão capazes de criar instâncias da classe. incluindo a capacidade para usar designers. No Solution Explorer. private static long ClassInstanceCount = 0. Adicione o código a public CDemo() Seguir para incrementar a contagem instância quando um novo CDemo for criado. 6. 4. InstanceID pode ser definida somente no construtor. o : Component Esta seção designa a classe da qual a classe herda. Por padrão. Membros estático serão inicializados na primeira vez a CDemo classe é mencionado no código. clique com o botão direito do mouse Class1. A Component classe fornece vários recursos para o componente. e para definir o número de identificação de instância. No Visual C#. Nesse momento. 7. mas deve todas terão o mesmo nome que o componente. um componente herda da classe Component fornecida pelo sistema. Isso pode ser a primeira vez um CDemo objeto é criado. Adicionando Constructors e Destructors Construtores controlar a maneira como o componente foi inicializado. Observação Sempre adicionar seu código após a chamada para InitializeComponent. No total de ocorrências de um número de identificação para cada instância da CDemo classe. Observação Usuários familiarizados com será multithreading destacar bastante rightly que atribuir InstanceID e incrementando NextInstanceID deve ser uma operação atômico. a construtores padrão para a CDemo classe. o Finalize método controla a forma ele tears pressionada. Isso e outros problemas relacionados a Visual Studio 54 . No menu File. eles existem somente no nível de classe. os componentes constituintes ter sido inicializada. Localizar public CDemo() e public CDemo(IContainer container). e selecione Add Reference a partir do menu de atalho. Métodos podem ser criados no uma maneira semelhante. para permitir que clientes se recuperar o número de instâncias do CDemo. Adicione o seguinte método depois do fim do construtor: ~CDemo() { ClassInstanceCount --. No entanto. 4. } Este método é chamado e é signified pelo caractere til (~) na frente do nome de classe. 2.cs e selecione View Code a partir do menu de atalho. ele é uma boa idéia para adicionar uma using instrução ao aplicativo de teste para simplificar o uso de componente. o projeto teste cliente deve ter uma referência para o projeto de biblioteca de classes. public static long InstanceCount { get { return ClassInstanceCount. 6. uma propriedade estática que permite que o cliente para descobrir quantos CDemo objetos não estão na memória a qualquer dado momento. há bons motivos para recursos versão anterior. 3. Aparecerá CDemoLib sob o References nó para o CDemoTest projeto. clique com o botão direito do mouse Form1. é necessário um projeto que o utiliza. } } Teste o componente Para testar o componente. digite CDemoTest na caixa Name e clique em OK. mouse no References nó imediatamente abaixo CDemoTest. Visual Studio 55 . 3.segmentação está ilustrado no Um componente Multithreaded Simple com Visual C# Walkthrough: criação. Para adicionar uma referência para o projeto de biblioteca de classes 1. Na caixa Add Reference de diálogo. Para adicionar o projeto cliente CDemoTest como o projeto de inicialização para a solução 1. Ao implementar um destruidor você pode executar limpeza apenas antes o componente é removido da memória. aponte para Add e escolha New Project para abrir a Add New Project caixa de diálogo. Selecione o Windows Application modelo de projeto. Para usar o CDemo componente. No Solution Explorer. como você poderá ver posteriormente nessa explicação passo a passo. Adicionar uma propriedade à classe A CDemo classe tem apenas uma propriedade. 2. O gerenciador de memória chama o destruidor imediatamente antes ele finalmente reclaims memória ocupado pelo objeto CDemo. selecione a Projects guia. Clique duas vezes o CDemoLib projeto de biblioteca de classes. a destruidor. Para criar uma propriedade para a classe CDemo • Adicione a seguinte declaração propriedade à classe CDemo. Após adicionar a referência. Este projeto deve ser o primeiro projeto que inicia quando você pressiona o botão Executar. clique com o botão direito do mouse CDemoTest e clique na Set as Startup Project partir do menu de atalho. No menu File. Clique com botão direito no Solution Explorer. Na Solution Explorer. InstanceCount. Como você pode ter guessed já não acontecem bastante dessa maneira. Clique duas vezes no ícone do timer1 para criar um método tratamento de eventos do evento do componente Tick timer1. criando e liberar um grande número de CDemo objetos.cs[Design] para retornar para o designer. 4. Pressione F5 para iniciar a solução. ct < 1000.cs [Design] guia para retornar para o designer. e consultar o tipo componente como CDemo. Legenda do formulário em cada escala do timer. this. porque a variável cd sairá do escopo. Para adicionar código para criar objetos e versão CDemo 1. 5. Isso irá iniciar o cronômetro tão logo o formulário é criado. 3. Para adicionar uma usando instrução • Adicione a instrução a seguir using para a lista de using instruções na parte superior da para Form1. Quando o método tratamento de eventos-sai. Colocar o seguinte código no método tratamento de eventos. mesmo essa instância será lançado.Text = "CDemo instances: " + CDemo. int ct. exibirá a contagem instância atual para a CDemo classe.NET Framework. o Code Editor using CDemoLib. timer1. Você agora criará e usar um programa de teste para testar o componente. e adicione o código a seguir após a chamada para InitializeComponent()). 2.Ou seja. Clique Form1. for (ct = 0. Clique duas vezes no Form1. você pode usar o nome totalmente qualificado do componente CDemo—. ct++) cd = new CDemo().CDemo adicionando a referência à CDemoLib. O nome de classe é usado como um qualificador para a propriedade — estáticos InstanceCount não está há necessidade de criar uma instância do CDemo para acessar um membro estático. Quando o for loop for feito. Para executar e depurar o CDemoTest e CDemo projetos 1. a instância anterior será liberado. Noções básicas sobre vida útil de objeto O CDemoTest programa será ilustram vida útil de objeto do . Clique na Form1. haverá somente uma instância do CDemo Esquerda. CDemoLib. 6. Arraste até a Form1 superfície de design. Esse código pode aspecto estranhos para você. Adicionando a using instrução. Localizar o construtor para Form1 (public Form1(). o Button Colocar o seguinte código no método tratamento de eventos. Conforme cada instância do CDemo é criado.Enabled = true. você pode omitir o nome da biblioteca. CDemo cd. Visual Studio 56 . para criar um método tratamento de eventos para eventos do botão Click. e Button Um Timer na guia All Windows Forms do Toolbox O componente nonvisual Timer aparece em uma superfície de design separadas abaixo do formulário. O projeto cliente for iniciado. Isso é porque mais e mais dos Visual Studio é trocado Out. muitos controles oferecem marcas inteligentes que são menus contextuais que permitem a você para executar tarefas comuns como essas em um único gesto em tempo de criação. Encaixe um controle para seu pai. execute o projeto novamente. e aumentar o número de iterações no for loop para 10000. observando a legenda. 5. Repita a etapa 3. deixando mais espaço para instâncias de CDemo. Por que não elas foi finalizado? Além BRIEF. Em seguida. 4. Marcas inteligentes permanecem anexado a uma instância de controle para sua vida útil no designer e estão sempre disponíveis. A prioridade apenas é bumped backup se obtém o Sistema com memória insuficiente. Fechar o formulário para retornar ao ambiente de desenvolvimento. Na verdade. Em algum momento. Tarefas ilustradas nesta explicação passo a passo incluem: • Criar um Projeto Windows Forms Visual Studio 57 . Clique no botão Mais várias vezes. Essas tarefas são chamados verbos de marca inteligente. há várias tarefas você executará repetidamente. Este lenta esquema coleção lixo permite a alocação Objeto muito rápida. sempre que você repita a etapa 3. você provavelmente será capaz para alocar mais CDemo objetos antes a memória etapas Gerenciador no. 3. e Form1 será exibido. Para acelerar o desenvolvimento. com prioridade baixa. Observe que a legenda do formulário exibe " 0 ". Clique no botão. o número de instâncias irá descartar inesperadamente Isso significa o gerenciador de memória que tem recuperou a memória de alguns dos objetos. Alterar a orientação de um SplitContainer controle. instâncias CDemo: As instâncias de CDemo foram todos liberados pelo tempo procedimento tratamento de eventos do botão Click concluído. Você obterá farther neste momento antes o gerenciador de memória finalizes mais objetos. instâncias CDemo: 2. Fechar o formulário para retornar ao ambiente de desenvolvimento. Estes são alguns das tarefas realizadas normalmente você encontrará: • • • Adicionar ou remover uma guia na uma TabControl. o gerenciador de memória finalizes objetos em segundo plano. talvez precise ajustar o código de modo que ele usa mais memória. A legenda do formulário deve exibir " 1000". Tarefas comuns usando marcas inteligentes em controles Forms Windows fazendo Walkthrough: Como você construir formulários e controles para seu aplicativo do Windows Forms. e o número de CDemo instâncias não tiver diminuído. Observação Se você clicou mais de 10 vezes. Para usar marcas inteligentes 1. Visual Studio 58 . o Toolbox Clique o glifo de marca inteligente. Coleções dos tipos padrão com o DesignerSerializationVisibilityAttribute Serializing Walkthrough: Às vezes os controles personalizados será expor uma coleção como uma propriedade. Arraste até o formulário. o TabControl) que aparece na parte lateral do Clique o glifo de marca inteligente. Selecione o formulário no Windows Forms Designer. Observar que a SplitContainer barra divisora do controle agora é orientado horizontalmente. Arraste um SplitContainer controle de até seu formulário. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. Para alterar as configurações. 5. No menu de atalho que aparece ao lado o glifo. Criando o projeto A primeira etapa é para criar o projeto e configurar o formulário. 3. Para criar o projeto 1. Para obter detalhes. você terá uma compreensão da função executado por esses recursos importantes layout. 2. Observar se uma nova página guia foi adicionado ao TabControl. consulte Configurações do Visual Studio. consulte Como: Criar um projeto de aplicativos Windows. 6. o Toolbox Clique o glifo de marca inteligente. de um TabControl a Toolbox Observe o glifo de marca inteligente ( . Essa explicação passo a passo demonstra como usar a DesignerSerializationVisibilityAttribute classe para controlar como uma coleção é serializado em tempo de criação. Para obter mais informações. 2. Usando marcas inteligentes Marcas inteligentes estão sempre em tempo de criação em controles que oferecemlos disponíveis. selecione o Add Column item. 4. selecione o Horizontal splitter orientation item. escolha Import and Export Settings No menu Tools. No menu de atalho que aparece ao lado o glifo. Arraste um TableLayoutPanel controle de até seu formulário. Criar um projeto chamado " SmartTagsExample " aplicativo baseado no Windows. No menu de atalho que aparece ao lado o glifo. Aplicar o Content valor a sua propriedade coleção garante que a propriedade será ser serializado. selecione o Add Tab item.• • Usando marcas inteligentes Habilitando e desabilitando marcas inteligentes Quando você tiver terminado. Observar que uma nova coluna será adicionada para o TableLayoutPanel controle. o Code Editor C# // This field backs the Strings property. Para obter mais informações. Na janela Properties. Propriedade Multiline Dock ScrollBars ReadOnly 6.Padding. consulte COMO: Serializar coleções de tipos padrão com o DesignerSerializationVisibilityAttribute. será necessário: • Permissões suficientes para poder para criar e executar projetos aplicativo do Windows Forms no computador onde o Visual Studio está instalado. Alterar para true Fill Vertical true 2. escolha Import and Export Settings No menu Tools. Criar um controle que possui uma coleção Serializable A primeira etapa consiste em criar um controle que tenha uma coleção Serializable como uma propriedade. consulte Modelo de Biblioteca de Controle do Windows. Defina a Strings propriedade no SerializationDemoControl. Renomear UserControl1 para SerializationDemoControl. consulte Configurações do Visual Studio. private String[] stringsValue = new String[1]. Você pode editar o conteúdo da coleção usando este que você pode acessar a partir da Properties janela. 3.Windows. Coloca um TextBox controle no SerializationDemoControl. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. 4. Para obter mais informações.All para 10. defina o valor da propriedade System. Para obter mais informações. consulte Renomear identificadores como:. 7. Na janela Properties. Pré-requisitos A fim de concluir este explicação passo a passo. 5. Criar um Projeto Biblioteca de Controle do Windows chamado SerializationDemoControlLib. Para alterar as configurações. Observação O Content valor é usado para ativar a serialização de coleção. Selecione o TextBox controle.Forms.Para copiar o código contidas neste tópico como uma lista simples. C# Visual Studio 59 . Em declarar um campo denominado stringsValue na SerializationDemoControl matriz de seqüência. o Collection Editor Para criar um controle com uma coleção Serializable 1. defina as propriedades a seguir. Nome do projeto SerializationDemoControlTest. Local em seu formulário. Em nessa guia. Clique a Strings propriedade. do SerializationDemoControl A serialização uma propriedade da coleção Para testar o comportamento serialização do seu controle. i < this. Observação As seqüências que você digitou aparecem na TextBox. This property can also be edited // at design time with a CollectionEditor. O exemplo de código a seguir mostra um código semelhante ao que será exibida se você digitado seqüências " red ".stringsValue. no qual código emite. consulte A caixa de ferramentas com Components personalizado Walkthrough: Populating automaticamente. } this. ( botão para abrir Digitar várias seqüências no String Collection Editor. 3. o Collection Editor Você pode ver o estado coleção serializado olhando para um arquivo de designer especial.Length).// When the DesignerSerializationVisibility attribute has // a value of "Content" or "Visible" the designer will // serialize the property. clique no String Collection Editor. Para obter mais informações. na elipse seguida.Append("\r\n"). Separe-os. Na Toolbox. 5.ToString().stringsValue. consulte Caixa de diálogo Add New Project. pressionando a tecla ENTER no final de cada seqüência. for (int i = 0. " laranjas ".Designer. Abra o Form1 nó.cs ou Form1. localização na guia chamado SerializationDemoControlLib Components. StringBuilder sb = new StringBuilder(this.textBox1. o Windows Forms Designer Para serializar uma coleção 1. ) 2.Content )] public String[] Strings { get { return this. clique no Show All Files botão. Beneath é um arquivo chamado Form1. do SerializationDemoControl 1.Length. } set { this. sb.stringsValue. Abra a região denominada Windows Form Designer generated code e localize a seção rotulada serializationDemoControl1. [DesignerSerializationVisibility( DesignerSerializationVisibility. o Windows Forms Designer Abrir este arquivo no Code Editor. e " Amarelo ".stringsValue[i]). você encontrará o SerializationDemoControl. // Populate the contained TextBox with the values // in the stringsValue array. 3. Para obter mais informações. Adicionar um projeto do Aplicativo do Windows à solução. Sob este rótulo é o código que representa o estado de seu controle serializado. um SerializationDemoControl Localizar a Strings propriedade na janela Properties. Clique em OK Quando você tiver terminado inserir seqüências. você será colocar ele em um formulário e alterar o conteúdo da coleção com o Collection Editor.Text = sb. No Solution Explorer. As seqüências você digitou na etapa 5 aparecem em uma atribuição para a Strings propriedade.. 2. } } Observação As seqüências que você digitou aparecem na TextBox.vb. Este é o arquivo no qual emite código que representa o estado de seu formulário e seus controles filho Design-time. 4.stringsValue = value. i++) { sb.Append(this. Visual Studio 60 .Designer. Os tópicos a seguir descrevem como aprimorar a integração em tempo de criação do seu controles personalizados: • • • • Arquitetura Design-time Atributos do Windows Forms controles Visão geral da serialização designer Criando um controle do Windows Forms que Takes Advantage dos recursos de tempo de design visual studio Walkthrough: Walkthrough: depuração controles Forms do Windows personalizados em tempo de design Quando você cria um controle personalizado. Para obter detalhes. C# [DesignerSerializationVisibility(DesignerSerializationVisibility.C# this. Visual Studio 61 .NET Framework. emite nenhuma atribuição para a Strings propriedade.Hidden)] Observação Nesse caso. "yellow"}. "orange". exatamente como você deseja depurar as outras classes . Isso é especialmente verdadeiro se você estiver criando um designer personalizado para o controle personalizado.serializationDemoControl1. consulte Criando um controle do Windows Forms que Takes Advantage dos recursos de tempo de design visual studio Walkthrough:. o Windows Forms Designer Próximas etapas Depois que você sabe como serializar uma coleção de tipos padrão.Strings = new string[] { "red". A diferença é que você irá depurar uma instância separada do Visual Studio que esteja executando código do seu controle personalizado Tarefas ilustradas nesta explicação passo a passo incluem: • • • • • • Criar um Projeto Windows Forms para hospedar o controle personalizado Criar um Projeto Biblioteca de Controle Adicionar uma propriedade a seu controle personalizado Adicionando o controle personalizado ao formulário host Como configurar o projeto para design-time depuração Depuração seu controle personalizado em tempo de criação Quando você tiver terminado. considere integrar os controles personalizados mais profundamente para o ambiente em tempo de criação. você terá uma compreensão das tarefas necessárias para depuração o comportamento em tempo de criação de um controle personalizado. você geralmente achará necessário para depurar seu comportamento em tempo de criação. Você pode depurar os controles personalizados usando o Visual Studio. 2. Para criar o projeto Biblioteca de Controle 1. Ponto de Verificação Neste ponto. e excluir itens. Para alterar as configurações. você será capaz para ver o controle personalizado no Toolbox. Para obter detalhes. você verá seu controle listados como DebugControl com o ícone padrão ao lado dela. 4. consulte COMO: Remover. Adicionar uma propriedade ao seu controle personalizado Para demonstrar que o controle personalizado na código sendo executado em tempo de criação. Para obter detalhes. Usando a Solution Explorer. Aberto DebugControl no Code Editor. Para obter detalhes. Você usará este projeto para criar o aplicativo que hospeda o controle personalizado. Criando o projeto A primeira etapa consiste em criar o projeto de aplicativo. 3. [Browsable(true)] public string DemoString { get Visual Studio 62 . Para adicionar uma propriedade ao seu controle personalizado 1. excluindo o arquivo com um nome de base de código padrão do projeto controlar " " UserControl1. Para obter mais informações. Criar um Projeto Biblioteca de Controle A próxima etapa é para criar o projeto Biblioteca de Controle e configurar o controle personalizado. excluir. escolha Import and Export Settings No menu Tools.Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. Para verificar o seu andamento • Localizar o nova guia chamada DebugControlLibrary Components e clique para selecioná-lo. Dê o novo arquivo de origem uma nome de base de " DebugControl ". consulte Caixa de diálogo Add New Project. consulte Como: Criar um projeto de aplicativos Windows. Compilar uma solução. exclusão. consulte Configurações do Visual Studio. Adicionar um novo UserControl item para o projeto DebugControlLibrary. Para criar o projeto • Criar um projeto do Aplicativo do Windows chamado " DebuggingExample ". Adicione o seguinte código para a definição de classe: C# private string demoStringValue = null. consulte Como: Adicionar novos itens de projeto. Adicione um Windows Control Library projeto para a solução. será adicionar uma propriedade e definir um ponto de interrupção no código que implementa a propriedade. Para obter detalhes. Ao ser aberto. Nome do projeto " DebugControlLibrary ". { return this. 2. Na seção Start Action. Localizar a DemoString propriedade personalizada na janela Properties. Para adicionar o controle personalizado ao formulário host 1. Clique com o botão direito do mouse no projeto DebugControlLibrary no e selecione Properties. abra a DebugControlLibrary Components guia e arraste uma DebugControl instância para o formulário. marque Start external program.demoStringValue. } } 2. será depurar uma instância separada do Visual Studio que esteja executando código do seu controle personalizado. Quando você abre Form1 em uma instância do seu controle personalizado será criado e será iniciado executando. Configurando o Project para depuração de tempo de design Você para depurar comportamento em tempo de criação do seu controle personalizado. Depuração seu controle personalizado em tempo de design Agora você está pronto para depurar o controle personalizado à medida que ele é executado em modo de design. Compilar uma solução. 4. seu caminho será " 8\Common7\IDE\devenv. Também Observe que quando a DemoString propriedade está selecionada. portanto clique a elipse. você irá colocar uma instância da classe controle personalizado em um formulário host. o Code Editor Visual Studio 63 . 3. Quando você iniciar a sessão de depuração.exe. Para configurar o projeto para design-time depuração 1. Clique com o botão direito do mouse o DebugControlLibrary projeto e selecione Set as StartUp Project Para ativar essa configuração de depuração. Observação que você pode alterar seu valor como você faria qualquer outra propriedade. Clique OK para fechar a caixa de diálogo. No projeto " DebuggingExample ". 3.exe Visual Studio C:\Program Files\Microsoft ". selecione a Debug guia. } set { demoStringValue = value. abra Form1 no Windows Forms Designer. e irá usá-lo para carregar a solução " DebuggingExample ". 2. Abrir o DebugControl arquivo de origem no e colocar um ponto de interrupção no Set acessador da propriedade DemoString. o Solution Explorer Na folha DebugControlLibrary de propriedades. e se você instalado para o local padrão. ( ) botão para procurar por Visual Studio IDE O nome do arquivo executável é devenv. será criada uma nova instância do Visual Studio. o Forms Designer Para depurar o controle personalizado em tempo de criação 1. Na Toolbox. Não será depuração uma instância separada do Visual Studio. seqüência de caracteres de descrição da propriedade aparece na parte inferior da janela Properties. Adicionando seu controle personalizado ao formulário host Para depurar o comportamento em tempo de criação do seu controle personalizado. 5. existem muitas possibilidades para expandir o controle na interação com o Visual Studio IDE.sln " será listado como o arquivo mais recentemente usado. Você pode encontrar esses atributos no espaço para nome System. O MarqueeControl tipo implementa uma exibição semelhante a um letreiro digital theater. Você pode passo único através o acessador Propriedade exatamente como.2. a instância de depuração do Visual Studio obtém foco e a execução pára em seu ponto de interrupção. Observe que uma nova instância do Visual Studio é criado. Pressione F5 para iniciar a sessão de depuração. Para obter detalhes. Observe que quando você confirmar a alteração. Há vários atributos você pode aplicar a propriedades seu controle para manipular o controle personalizado na interação com o designer. 4.ComponentModel. chamado MarqueeControlRootDesigner. Você pode escrever um designer personalizado para o controle personalizado. Você pode distinguir entre as instâncias de duas maneiras: A instância de depuração tem a palavra Running em sua barra de título A instância de depuração tem o Start Botão em sua Debug barra de ferramentas desativado O ponto de interrupção é definido na instância de depuração. Essa explicação passo a passo ilustra como criar um designer personalizado para um controle personalizado. Você irá implementar um MarqueeControl tipo e uma classe designer associado. Na nova instância do Visual Studio. abra a solução " DebuggingExample ". descartando a instância do Visual Studio hospedado ou clicando no Stop Debugging botão na instância de depuração. você pode sair. • Você pode usar a DesignMode propriedade da classe Component para escrever código que será executada apenas em tempo de criação Para obter detalhes. Abrir Form1 em e selecione o DebugControl controle. O arquivo solução " DebuggingExample. Próximas etapas Agora que você pode depurar os controles personalizados em tempo de criação. consulte Criando um controle do Windows Forms que Takes Advantage dos recursos de tempo de design visual studio Walkthrough:. seria qualquer outro código seu Quando você tiver terminado com a sessão de depuração. A solução você pode localizar facilmente selecionando Recent Projects no File menu. com luzes animado e texto flashing. o o 3. consulte DesignMode. Visual Studio 64 . o Forms Designer Alterar o valor da propriedade DemoString. Isso permite total controle sobre a experiência de design usando a infra-estrutura extensível Designer expostos pelo Visual Studio. 6. • • Criando um controle do Windows Forms que Takes Advantage dos recursos de tempo de design visual studio Walkthrough: A experiência em tempo de design para um controle personalizado pode ser aperfeiçoada pela criação um designer personalizado associado. Para alterar as configurações. Com o designer personalizado. Para obter mais informações. você pode montar uma implementação personalizada MarqueeControl com luzes animado e flashing texto em várias combinações. escolha Import and Export Settings No menu Tools. Pré-requisitos A fim de concluir este explicação passo a passo.O designer para este controle interage com o ambiente de design para fornecer uma experiência Design-time personalizado. consulte COMO: Criar um controle de formulários do Windows que tira vantagem de recursos em tempo de criação. Você pode usar o controle montado em um formulário como qualquer outro controle Windows Forms. Tarefas ilustradas nesta explicação passo a passo incluem: • • • • • • • • • • • • • • Criando o projeto Criar um Projeto Biblioteca de Controle Referência a Project controle personalizado Definir um controle personalizado e seus designer personalizado Criando uma instância de seu controle personalizado Configurando o Project para depuração de tempo de design Implementar O controle personalizado Criando um controle filho para O controle personalizado Criar o controle filho MarqueeBorder Criando um designer personalizado para sombra e propriedades de filtro Tratamento alterações componente Adicionando verbos criador ao seu designer personalizado Criando um UITypeEditor personalizada Testando o controle personalizado no criador Quando você tiver terminado. será necessário: • Permissões suficientes para poder para criar e executar projetos aplicativo do Windows Forms no computador onde o Visual Studio está instalado. consulte Configurações do Visual Studio. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. Criando o projeto Visual Studio 65 . o controle personalizado será algo como o seguinte aspecto: Para a listagem código completo. O controle personalizado não terá um designer personalizado associado. J#). Nome do projeto " MarqueeControlLibrary ". 4. consulte Caixa de diálogo Add New Project. Para obter mais informações. Isso permite que você para criar uma experiência design exclusivo adequado especificamente para o controle personalizado. Para obter mais informações. consulte COMO: Remover. 3. criar uma nova pasta no projeto MarqueeControlLibrary. Referência a Project controle personalizado Você usará o MarqueeControlTest projeto para testar o controle personalizado. Certifique-se de usar a Projects guia na caixa Add Reference de diálogo em vez de referência montagem MarqueeControlLibrary diretamente. 2.vb ". Usando Solution Explorer. Clique com o botão direito do mouse na Design pasta e adicionar uma nova classe. consulte COMO: Adicionar e remover referências no Visual Studio (C#. Adicione um projeto Biblioteca de Controle do Windows para a solução. Para obter mais informações. Usando Solution Explorer. e ele fornece o controle uma grande quantidade de funcionalidade padrão. Para fazer referência o projeto de controle personalizado • No projeto MarqueeControlTest. adicione uma referência ao conjunto MarqueeControlLibrary Projeto. Dar o novo arquivo de origem uma nome de base de " MarqueeControl ".Design. Visual Studio 66 . excluir. Fornecer o arquivo de origem uma nome de base de " MarqueeControlRootDesigner ".A primeira etapa consiste em criar o projeto de aplicativo. O projeto teste tornará conhecer o controle personalizado quando você adiciona uma referência ao conjunto MarqueeControlLibrary Projeto. Você usará este projeto para criar o aplicativo que hospeda o controle personalizado. 6. Criar um Projeto Biblioteca de Controle A próxima etapa consiste em criar o projeto Biblioteca de Controle. então adicionar essa referência para o MarqueeControlTest projeto. Para criar o projeto Biblioteca de Controle 1. Será necessário para usar tipos de montagem System. Excluir controle padrão do projeto.cs " ou " UserControl1. 5. consulte Como: Criar um projeto de aplicativos Windows. Para criar o projeto • Criar um projeto do Aplicativo do Windows chamado " MarqueeControlTest ". Para obter mais informações. excluir o arquivo de origem nomeado " UserControl1. acordo com o idioma de escolha. Definir um controle personalizado e seus designer personalizado O controle personalizado será derivar a partir da UserControl classe.Nomeie a nova pasta " Design ". e excluir itens. consulte Como: Adicionar novos itens de projeto. Para obter mais informações. Adicionar um novo UserControl item para o MarqueeControlLibrary projeto. Você criará um novo controle personalizado e seu designer personalizado correspondente. Isso permite que o controle para conter outros controles. using System.MarqueeBorder". using System.Forms.Diagnostics. Coloque a definição para a MarqueeControlRootDesigner classe entre um espaço para nome chamado " MarqueeControlLibrary.Security.Design. using System.Forms.Windows.Design. Visual Studio 67 . Name = "FullTrust")] public class MarqueeControlRootDesigner : DocumentDesigner { 5.ComponentModel. Esta Declaração coloca o designer em um espaço para nome especial reservado para tipos relacionados design-.Drawing. importar os espaços para nome a seguir: C# using System.ComponentModel.SecurityAction. Além disso. Na parte superior do arquivo. será implementa a IRootDesigner interface. C# [Designer( typeof( MarqueeControlLibrary. Abrir o MarqueeControlRootDesigner arquivo de origem no Code Editor. typeof( IRootDesigner ) )] public class MarqueeControl : UserControl { 3.Forms. ToolboxItemFilterType.Design. using System. Este será útil para fins de depuração.ComponentModel.Design.WriteLine("MarqueeControlRootDesigner ctor").Deman d. using System. Na parte superior do arquivo. using System.ComponentModel. 2. Definir o construtor para a MarqueeControlRootDesigner classe. using System. Abrir o MarqueeControl arquivo de origem no Code Editor.Permissions.Windows.MarqueeControlRootDesigner ). importar os espaços para nome a seguir: C# using System.Windows.Require)] [ToolboxItemFilter("MarqueeControlLibrary. ToolboxItemFilterType. using System. usando a DesignerAttribute classe.Collections. 4. alterar da declaração do MarqueeControlRootDesigner para herdar da classe DocumentDesigner.Você associar o controle ao seu designer.Design. Inserir uma WriteLine instrução no corpo construtor. using System.Drawing.Forms. Para definir um controle personalizado e seu designer personalizado 1. using System. C# namespace MarqueeControlLibrary. Adicionar a declaração da MarqueeControl Classe.MarqueeText".Windows.Require)] [System.PermissionSet(System. using System. você irá colocar uma instância do seu controle no formulário no MarqueeControlTest projeto.Design { [ToolboxItemFilter("MarqueeControlLibrary. using System. o DesignerAttribute Isto associa o controle personalizado com seu designer. C# public MarqueeControlRootDesigner() { Trace. using System.Design.Collections. } Criando uma instância de seu controle personalizado Para observar o comportamento em tempo de design personalizado do seu controle. O designer personalizado porque você estiver desenvolvendo o comportamento Design-time inteiro do seu controle personalizado.Permissions.Design ".Security. 3. ele será necessário para depurar o controles e componentes. 3. 5. Criar o projeto. importar espaço para nome MarqueeControlLibrary: Visual Basic Imports MarqueeControlLibrary using MarqueeControlLibrary. 6. 2. Na seção Start Action. Clique com o botão direito do mouse o MarqueeControlLibrary projeto e selecione Properties. Alterar da declaração do DemoMarqueeControl para herdam a MarqueeControl classe. seu caminho será " . Aberto Form1 no Windows Forms Designer. o Toolbox Arraste até o formulário. você testará a associação entre o controle personalizado e o designer personalizado. ( ) botão para procurar por Visual Studio IDE O nome do arquivo executável é devenv. Localizar na guia " Meus Controles de usuário " na e abri-lo. Visual Basic Public Class DemoMarqueeControl Inherits MarqueeControl public class DemoMarqueeControl : MarqueeControl 4. consulte Walkthrough: depuração controles Forms do Windows personalizados em tempo de design. Para configurar o projeto para design-time depuração 1. 7. Para testar o ambiente de depuração e a associação de designer Visual Studio 68 .exe. Na caixa de diálogo ' páginas Propriedades MarqueeControlLibrary '. portanto clique a elipse. de um DemoMarqueeControl a Toolbox Criar o projeto. Dar o novo arquivo de origem uma nome de base de " DemoMarqueeControl ". Na parte superior do arquivo. marque Start External Program. 2.exe Visual Studio C:\Program Files\Microsoft. Não é uma maneira simples para instalar o seu projeto para permitir a depuração em tempo de criação. Após você ter determinado se o ambiente de depuração está configurada corretamente. " Clique OK para fechar a caixa de diálogo. Configurando o Project para depuração de tempo de design Quando você estiver desenvolvendo uma experiência Design-time personalizado.NET\Common7\IDE\devenv. Para obter mais informações. e se você instalado para o local padrão. Adicionar um novo UserControl item para o MarqueeControlTest projeto. 4.Para criar uma instância de seu controle personalizado 1. 5. Clique com o botão direito do mouse o MarqueeControlLibrary projeto e selecione Definir como Projeto iniciar para ativar essa configuração de depuração " ". Não será depuração uma instância separada do Visual Studio. Ponto de Verificação Você está pronto para depurar o comportamento em tempo de criação do seu controle personalizado. selecione a Configuration Properties página. respectivamente. Neste ponto. } } } 2.Controls ) { if( cntrl is IMarqueeWidget ) { IMarqueeWidget widget = cntrl as IMarqueeWidget. Os recursos de tempo de execução são implementadas pelo e MarqueeControlRootDesigner Classes.PerformLayout(). o DemoMarqueeControl Observe que a instância de depuração do Visual Studio obtém foco e a execução pára em seu ponto de interrupção. contém controles filho que implementa a IMarqueeWidget interface. Substituir o OnLayout método. e MarqueeText controles. foreach( Control cntrl in this. Start e Stop Enumerar cada controle filho e chamada ao MarqueeControlStartMarquee A aparência do e MarqueeText controles é dependente para o layout. widget. 3. Abrir o MarqueeControlRootDesigner arquivo de origem no e coloque um ponto de interrupção na instrução WriteLine. abra a solução " MarqueeControlTest ". que interrompe a animação.StopMarquee(). } } } Visual Studio 69 . widget. Aberto no designer.StartMarquee(). Na nova instância do Visual Studio. Observe que uma nova instância do Visual Studio é criado. e os recursos em tempo de criação são implementadas pelo MarqueeBorder o MarqueeBorderDesigner Para implementar o Controle Personalizado 1. } } } public void Stop() { // The MarqueeControl may contain any number of // controls that implement IMarqueeWidget. 4.Controls ) { if( cntrl is IMarqueeWidget ) { IMarqueeWidget widget = cntrl as IMarqueeWidget. // Repaint all IMarqueeWidget children if the layout // has changed. o Code Editor Pressione F5 para iniciar a sessão de depuração. Porque e StopMarquee métodos. Abrir o MarqueeControl arquivo de origem no Code Editor. que inicia a animação Letreiro digital.sln " será listado como o arquivo mais recentemente usado. 2. so find // each IMarqueeWidget child and call its StopMarquee // method. O arquivo solução " MarqueeControlTest.1. foreach( Control cntrl in this.Controls ) { if( cntrl is IMarqueeWidget ) { Control control = cntrl as Control. A solução você pode localizar facilmente selecionando Recent Projects no File menu. é um UserControl Ela expõe dois métodos: Start. Pressione F5 para continuar a sessão de depuração. so // find each IMarqueeWidget child and call its // StartMarquee method. e Stop. C# protected override void OnLayout(LayoutEventArgs levent) { base. em cada filho controlar que implementa IMarqueeWidget. foreach( Control cntrl in this. Implementar O controle personalizado O MarqueeControl com um pouco de personalização. Se o restante dessa explicação passo a passo será concentrar nos detalhes da implementação recursos do controle e o criador. o MarqueeBorder Isso é a extensão das personalizações MarqueeControl. control.OnLayout (levent). tudo está no lugar para que você possa desenvolver e depurar o controle personalizado e seu designer personalizado associado. Implementar e Stop Métodos. então MarqueeControl substitui o OnLayout método e chama PerformLayout em controles filho desse tipo. o Start C# public void Start() { // The MarqueeControl may contain any number of // controls that implement IMarqueeWidget. O memória flash luzes em seqüência. 2.Criando um controle filho para O controle personalizado O MarqueeControl: o MarqueeBorder controle e o MarqueeText controle. the control should call StartMarquee on all // its IMarqueeWidget child controls. O MarqueeText controle tem também e StopMarquee métodos em comum com o MarqueeBorder controle. A velocidade na qual o memória flash luzes é controlada pela propriedade chamado UpdatePeriod. chamado StartMarquee e StopMarquee. Adicione o seguinte código para a IMarqueeWidget interface para expor dois métodos e uma propriedade que manipulam a animação Letreiro digital: C# // This interface defines the contract for any class that is to // be used in constructing a MarqueeControl. em qualquer combinação. Dar o novo arquivo de origem uma nome de base de " IMarqueeWidget ". the control should call StopMarquee on all // its IMarqueeWidget child controls. Isso permite para descobrir os controles filho relacionados MARQUEE-e conceda a eles Tratamento especial. Dois métodos. Como o MarqueeBorder controle. mas quando vários IMarqueeWidget objetos estão presentes. Adicionar um novo item classe ao projeto MarqueeControlLibrary. para que eles apareçam para ser mover-se a borda. o StartMarquee Em tempo de criação. hospedará dois tipos de controle filho • MarqueeBorder esse controle pinta uma borda de " luz " ao redor suas bordas. Para criar um controle filho para o controle personalizado 1. • MarqueeText esse controle pinta uma seqüência flashing. a velocidade na qual o texto pisca é controlada pela propriedade UpdatePeriod. Visual Studio 70 . // This method stops the animation. você irá usar BackgroundWorker objetos de espaço para nome System. public interface IMarqueeWidget { // This method starts the animation. Você pode usar Timer objetos. void StartMarquee(). Abrir o IMarqueeWidget arquivo de origem no e alterar a declaração de class para interface: o Code Editor C# // This interface defines the contract for any class that is to // be used in constructing a MarqueeControl. permite esses tipos dois controle a ser adicionado à MarqueeControlRootDesigner uma MarqueeControl Recursos comuns dos dois controles são factored em uma interface denominada IMarqueeWidget. Várias outras propriedades personalizadas determinar outros aspectos da aparência do controle. public interface IMarqueeWidget { 3. controle quando a animação inicia e interrompe. o segmento de UI único pode ser impossível acompanhar a animação. If the control can // contain other classes that implement IMarqueeWidget as // children. o MarqueeControl Para implementar o recurso animação periódicos. If the control can // contain other classes that implement IMarqueeWidget as // children.ComponentModel. // These fields back the public properties. // This component updates the control asynchronously.Require)] public class MarqueeText : Label. defina as BackgroundWorker propriedades para true e WorkerSupportsCancellation do componente WorkerReportsProgess. // in milliseconds. Adicionar um novo UserControl item para o MarqueeControlLibrary projeto. importar os espaços para nome a seguir: C# using System.Forms Form Designer.darkBrush = new SolidBrush(this. Implementa a IMarqueeWidget interface. using System.Threading. using System. 5. int UpdatePeriod { get. public MarqueeText() { // This call is required by the Windows.Forms. 7.Windows.darkColorValue = this. Declare as variáveis que correspondem às propriedades expostos.Drawing.Forms. this. the text is painted in the dark color. private bool isLit = true.ForeColor. private Color lightColorValue.darkColorValue). private Brush darkBrush. Essas configurações permitem que o BackgroundWorker Componente para aumentar o ProgressChanged evento periodicamente e para cancelar Atualizações assíncronas.Windows. Para obter mais informações. using System.lightBrush = new SolidBrush(this. using System. Arraste um BackgroundWorker componente de até seu MarqueeText controle.BackColor. // This method specifies the refresh rate for the animation. 8. using System. ToolboxItemFilterType. IMarqueeWidget { 9. Dar o novo arquivo de origem uma nome de base de " MarqueeText ".ComponentModel.Design. using System. this. the text is painted in the light color. InitializeComponent(). private Brush lightBrush. Visual Studio 71 . private Color darkColorValue. using System.lightColorValue). this. } 10. instância e inicializar-los no construtor. Alterar da declaração do MarqueeText para herdar de Label e para implementar a IMarqueeWidget interface: C# [ToolboxItemFilter("MarqueeControlLibrary.Diagnostics. 6. C# // When isLit is true.MarqueeText".Design. // Initialize light and dark colors // to the control's default values. // These brushes are used to paint the light and dark // colors of the text. o Toolbox Esse componente permitirá que o MarqueeText controle para atualizar próprio assincronamente. Na parte superior do arquivo. Na janela Propriedades. } } 4. consulte Componente BackgroundWorker. this.ComponentModel.void StopMarquee(). set.lightColorValue = this. private int updatePeriodValue = 50. // This value changes whenever the BackgroundWorker component // raises the ProgressChanged event. private BackgroundWorker backgroundWorker1. // When isLit is false. Abrir o MarqueeText arquivo de origem no Code Editor. O isLit campo determina se o texto está para ser pintura com a cor determinado pela LightColor propriedade. ToArgb()) { this. private void backgroundWorker1_DoWork( object sender. this.O StartMarquee e StopMarquee chamar métodos do componente RunWorkerAsync e BackgroundWorkerCancelAsync métodos para iniciar e parar a animação. O Category e Browsable atributos são aplicados a essas propriedades. it communicates to the control using the // ProgressChanged event.darkBrush = new SolidBrush(value). C# [Category("Marquee")] [Browsable(true)] public Color LightColor { get { return this. Implementar a assessores Propriedade. this. C# public virtual void StartMarquee() { // Start the updating thread and pass it the UpdatePeriod.darkColorValue. Comparing values // from the ToArgb method is the recommended test for // equality between Color structs.ToArgb()) { this. Implementar os manipuladores para o BackgroundWorker componente na DoWork e ProgressChanged eventos.backgroundWorker1. } public virtual void StopMarquee() { // Stop the updating thread.updatePeriodValue. } } } 12. if (this. } set { // The LightColor property is only changed if the // client provides a different value.CancelAsync().RunWorkerAsync(this.backgroundWorker1.DoWorkEventArgs e) { BackgroundWorker worker = sender as BackgroundWorker.UpdatePeriod). if (this.lightColorValue = value. O ProgressChanged manipulador de eventos alterna o texto entre seu estado para dar a aparência de flashing claras e escuras. } set { if (value > 0) { this.lightColorValue. while (!worker. this. Comparing values // from the ToArgb method is the recommended test for // equality between Color structs. // Instead. // This event handler will run until the client cancels // the background task by calling CancelAsync.darkColorValue = value. } [Category("Marquee")] [Browsable(true)] public int UpdatePeriod { get { return this. which // was passed as the argument to the RunWorkerAsync // Visual Studio 72 .lightBrush = new SolidBrush(value). } } } [Category("Marquee")] [Browsable(true)] public Color DarkColor { get { return this.ComponentModel. } } } 11.updatePeriodValue = value. O DoWork manipulador de eventos sleeps para o número de milissegundos especificado pelo UpdatePeriod raises depois o ProgressChanged evento.ToArgb() != value. System. } set { // The DarkColor property is only changed if the // client provides a different value.CancellationPending) { // The Argument property of the DoWorkEventArgs // object holds the value of UpdatePeriod. this. // // The only work done in this event handler is // to sleep for the number of milliseconds specified // by UpdatePeriod. para as propriedades apareçam em uma seção personalizado da janela Propriedades chamada " digital ". then raise the ProgressChanged event. "must be > 0"). // so it must not make any calls into the MarqueeText control. Você irá expor duas propriedades aos clientes: LightColor e DarkColor.darkColorValue.lightColorValue. O Category e Browsable atributos são aplicadas para a UpdatePeriod propriedade para ele apareça em uma seção personalizado da janela Propriedades chamada " digital ". C# // This method is called in the worker thread's context.ToArgb() != value. } else { throw new ArgumentOutOfRangeException("UpdatePeriod". até parar a animação ao chamar CancelAsync seu código. OnPaint(e).ComponentModel.Design. Em princípio. importar os espaços para nome a seguir: C# using System.isLit = !this. IMarqueeWidget interface. C# protected override void OnPaint(PaintEventArgs e) { // The text is painted in the light or dark color.MarqueeBorder". this.Sleep((int)e.Threading. IMarqueeWidget { Visual Studio 73 . private void backgroundWorker1_ProgressChanged(object sender. In this case. // This event handler does work that is internal to the // control. defina as BackgroundWorker propriedades para true e WorkerSupportsCancellation do componente WorkerReportsProgess.MarqueeBorderDesigner ))] [ToolboxItemFilter("MarqueeControlLibrary. } } // The ProgressChanged event is raised by the DoWork method.Design. 3. 5.isLit.Refresh(). and the control is told to // repaint itself.ForeColor = this.isLit ? this. 2.lightColorValue : this.ReportProgress(0).Drawing.method.Drawing. base. Essas configurações permitem que o BackgroundWorker Componente para aumentar o ProgressChanged evento periodicamente e para cancelar Atualizações assíncronas.Design. Substituir o OnPaint método para ativar a animação. Porque o MarqueeBorder controle pode ter controles filho. Na janela Propriedades. using System. worker.Require)] public class MarqueeBorder : Panel. Alterar da declaração da MarqueeBorder Herdar do Panel e para implementar a C# [Designer(typeof(MarqueeControlLibrary. using System.Windows.darkColorValue. Para obter mais informações. this. } 13. ToolboxItemFilterType. Abrir o MarqueeBorder arquivo de origem no Code Editor.Diagnostics. o Toolbox Esse componente permitirá que o MarqueeBorder controle para atualizar próprio assincronamente. consulte Componente BackgroundWorker.Argument). Para criar o controle MarqueeBorder 1. using System. the ReportProgress event is used to // periodically alert the control to update its state. using System. // depending on the current value of isLit.Design. Ele tem mais propriedades e a animação no método OnPaint está mais envolvido. the text is toggled between its // light and dark state. // The DoWork eventhandler does not actually report // progress. } Criar o controle filho MarqueeBorder O MarqueeBorder controle é um pouco mais sofisticado que o MarqueeText controle.Windows.Forms. Adicionar um novo UserControl item para o MarqueeControlLibrary projeto. using System. Thread. Arraste um BackgroundWorker componente de até seu MarqueeBorder controle. using System.ComponentModel. ele precisará estar ciente de Layout eventos. ele é bastante semelhante ao controle MarqueeBorder. System.ProgressChangedEventArgs e) { this.ComponentModel. 4. using System. Dar o novo arquivo de origem uma nome de base de " MarqueeBorder ".Forms. using System. Na parte superior do arquivo. private Brush lightBrush. public enum MarqueeLightShape { Square.lightColorValue). Implementa a IMarqueeWidget interface. Coloque essas declarações antes declaração da MarqueeBorder classe. // These fields back the public properties.StartMarquee(). } } // Start the updating thread and pass it the UpdatePeriod. pad. private System. Declare as variáveis que correspondem às propriedades expostos. CCW } // This defines the possible values for the MarqueeBorder // control's LightShape property. e MarqueeLightShape. so find // each IMarqueeWidget child and call its StartMarquee // method.Controls) { if (cntrl is IMarqueeWidget) { IMarqueeWidget widget = cntrl as IMarqueeWidget.Square. this. que determina a forma das luzes (quadrado ou circular). private int updatePeriodValue = 50.RunWorkerAsync(this.CW. // Initialize light and dark colors // to the control's default values. O StopMarquee método tem uma implementação semelhante. Como o MarqueeBorder controle pode conter controles filho. private MarqueeLightShape lightShapeValue = MarqueeLightShape.darkColorValue). Circle } 7. private int currentOffset = 0. instância e inicializar-los no construtor. // because it requires that any contained controls do // not overlap any of the marquee lights. o StartMarquee método enumera todos os controles filho e chama StartMarquee naqueles que implementam IMarqueeWidget.Padding = new Padding(pad. que determina a direção na qual as luzes " girar " ao redor da borda. true). this. private MarqueeSpinDirection spinDirectionValue = MarqueeSpinDirection. this. foreach (Control cntrl in this. // This field tracks the progress of the "first" light as it // "travels" around the marquee border. public enum MarqueeSpinDirection { CW.Forms Form Designer.darkColorValue = this. } 8. private Color lightColorValue.darkBrush = new SolidBrush(this. pad. widget.6. private int lightPeriodValue = 3. // These brushes are used to paint the light and dark // colors of the marquee lights. public MarqueeBorder() { // This call is required by the Windows.UpdatePeriod). pad). O StartMarquee e StopMarquee chamar métodos do componente RunWorkerAsync e BackgroundWorkerCancelAsync métodos para iniciar e parar a animação. this. int pad = 2 * (this. this.OptimizedDoubleBuffer. InitializeComponent(). // This component updates the control asynchronously. C# public static int MaxLightSize = 10. SetStyle(ControlStyles.lightColorValue = this.backgroundWorker1.BackgroundWorker backgroundWorker1. private Color darkColorValue.BackColor. C# public virtual void StartMarquee() { // The MarqueeBorder control may contain any number of // controls that implement IMarqueeWidget. private int lightSizeValue = 5. Declarar dois enumerações de gerenciamento de estado do MarqueeBorder controle: MarqueeSpinDirection. private Brush darkBrush. this.ForeColor. } public virtual void Visual Studio 74 . C# // This defines the possible values for the MarqueeBorder // control's SpinDirection property.lightSizeValue + this.lightBrush = new SolidBrush(this.lightSpacingValue).ComponentModel. // The MarqueeBorder control manages its own padding. private int lightSpacingValue = 1. Comparing values // from the ToArgb method is the recommended test for // equality between Color structs.StopMarquee(). typeof(System. O MarqueeBorder controle tem várias propriedades para controlar sua aparência.UITypeEditor))] public MarqueeLightShape LightShape { get { return this.backgroundWorker1. C# [Category("Marquee")] [Browsable(true)] public int LightSize { get { return this.lightColorValue = value. } set { if (value > 0) { this.darkBrush = new SolidBrush(value). até parar a animação ao chamar CancelAsync seu código.lightSizeValue.All = 2 * value. } [Category("Marquee")] [Browsable(true)] public virtual int UpdatePeriod { get { return this. O ProgressChanged manipulador de eventos aumenta a posição da luz " base ".DockPadding. } } } [Category("Marquee")] [Browsable(true)] public Color DarkColor { get { return this. } } } [Category("Marquee")] [Browsable(true)] public Color LightColor { get { return this. so find // each IMarqueeWidget child and call its StopMarquee // method.lightSizeValue = value. if (this.ToArgb() != value. } set { // The DarkColor property is only changed if the // client provides a different value. } set { this. } set { if (value > 0) { this. this. } } } [Category("Marquee")] [Browsable(true)] [EditorAttribute(typeof(LightShapeEditor). } else { throw new ArgumentOutOfRangeException("LightSize".Drawing. this. "must be > 0 and < MaxLightSize"). } else { throw new ArgumentOutOfRangeException("LightSpacing".darkColorValue. "must be > 0 "). } } [Category("Marquee")] [Browsable(true)] public MarqueeSpinDirection SpinDirection { get { return this. "must be >= 0").ToArgb() != value. } } 9.lightPeriodValue = value.lightColorValue. Implementar os manipuladores para o BackgroundWorker componente na DoWork e ProgressChanged eventos.spinDirectionValue = value.lightSpacingValue.Controls) { if (cntrl is IMarqueeWidget) { IMarqueeWidget widget = cntrl as IMarqueeWidget. widget. e chama o Refresh método para fazer com que o controle para redesenhar próprio.lightShapeValue.darkColorValue. } } } [Category("Marquee")] [Browsable(true)] public int LightSpacing { get { return this. } else { throw new ArgumentOutOfRangeException("LightPeriod". foreach (Control cntrl in this.lightBrush = new SolidBrush(value).ToArgb()) { this.darkColorValue = value.updatePeriodValue = value.Design.lightShapeValue = value. } set { // The LightColor property is only changed if the // client provides a different value. } } } [Category("Marquee")] [Browsable(true)] public int LightPeriod { get { return this. do qual o estado luz / escuro de outros luzes é determinado. if (this. } set { if (value > 0 && value <= MaxLightSize) { this.lightColorValue. } } } Implementar a assessores Propriedade. } else { throw new ArgumentOutOfRangeException("UpdatePeriod". O DoWork manipulador de eventos sleeps para o número de milissegundos especificado pelo UpdatePeriod raises depois o ProgressChanged evento.updatePeriodValue. this. this. } set { this. "must be > 0").ToArgb()) { this.CancelAsync().lightSpacingValue = value. C# Visual Studio 75 .spinDirectionValue.StopMarquee() { // The MarqueeBorder control may contain any number of // controls that implement IMarqueeWidget.lightPeriodValue. } } // Stop the updating thread. } set { if (value >= 0) { this. Comparing values // from the ToArgb method is the recommended test for // equality between Color structs. o OnLayout O OnPaint método desenha as luzes ao longo das bordas do controle MarqueeBorder.DoWorkEventArgs e) { BackgroundWorker worker = sender as BackgroundWorker. } } // The ProgressChanged event is raised by the DoWork method.Square: { g. this.lightSizeValue). Brush brush. // the light is considered to be on. Implementar os métodos auxiliar. Luzes que são " lit " são tiradas com a cor determinado por propriedade LightColor. return ( (lightIndex + directionFactor * this. yPos. while (!worker. substituir OnLayout e chame Refresh. break. } 10. // This event handler does work that is internal to the // control.Circle: { g. the currentOffset is incremented.currentOffset++. xPos. this.lightSizeValue. yPos. this. C# // This method determines if the marquee light at lightIndex // should be lit.spinDirectionValue == MarqueeSpinDirection.Refresh(). System. which // was passed as the argument to the RunWorkerAsync // method.lightSizeValue). você precisa para chamar ele sempre que for alterado o layout. it communicates to the control using // the ProgressChanged event.Sleep((int)e.Assert(false. // and the control is told to repaint itself.Argument). C# Visual Studio 76 .ComponentModel. The currentOffset field specifies where // the "first" light is located. } default: { Trace.lightShapeValue) { case MarqueeLightShape. } protected virtual void DrawLight( Graphics g. break.currentOffset) % this. System. e aqueles que são " escuro " são tiradas com a cor determinado pela DarkColor propriedade. O DrawLight método desenha uma luz utilizando a cor apropriada. int yPos) { switch (this. } } } 11. xPos.FillRectangle(brush. worker. and it will be painted // with the control's lightBrush. then raise the ProgressChanged event. // so it must not make any calls into the MarqueeBorder // control. O IsLit método determina a cor de uma luz em uma posição determinado. break. } case MarqueeLightShape.lightPeriodValue == 0 ). protected virtual bool IsLit(int lightIndex) { int directionFactor = (this.").ProgressChangedEventArgs e) { this. and the "position" of the // light given by lightIndex is computed relative to this // offset.FillEllipse(brush. this. Thread. // // The only work done in this event handler is // to sleep for the number of milliseconds specified // by UpdatePeriod. "Unknown value for light shape. Instead.ReportProgress(0). // This event handler will run until the client cancels // the background task by calling CancelAsync. In this case.CW ? -1 : 1). If this position modulo lightPeriodValue is zero. IsLit e DrawLight.ComponentModel. Para isso. the ReportProgress event is used to // periodically alert the control to update its state. Forma. e posição. // The DoWork eventhandler does not actually report // progress. Como o OnPaint método dependerá da dimensões do controle MarqueeBorder.CancellationPending) { // The Argument property of the DoWorkEventArgs // object holds the value of UpdatePeriod. Substituir e OnPaint Métodos.lightSizeValue. int xPos. private void backgroundWorker1_ProgressChanged( object sender. private void backgroundWorker1_DoWork(object sender. this.// This method is called in the worker thread's context. lightCounter++. and the left side. if (this. xPos = this.Width .lightSizeValue. lightCounter++. xPos = 0. o MarqueeControl Este criador fornece personalizado comportamento que seja apropriado no contexto do designer raiz personalizado. int xPos = 0. yPos).Height > MaxLightSize) { // The position of the next light will be incremented // by this value. DrawLight(g. Especificamente.Graphics. i < horizontalLights. int increment = this.darkBrush. Interceptando chamadas para um componente na propriedade acessador é conhecido como " Sombreamento. the bottom row. yPos). this. Para esse exemplo. DrawLight(g.OnLayout(levent). xPos.Refresh(). brush. i++) { brush = IsLit(lightCounter) ? this. base. Além deste Designer. for (int i = 0. Para esse exemplo. i < verticalLights. for (int i = 0. lightCounter++. " Ele permite que um designer para controlar o valor definido pelo usuário e opcionalmente passar esse valor para o componente está sendo criado.BackColor).lightBrush : this. DrawLight(g. for (int i = 0. // Draw the bottom row of lights. which is equal to the sum of the // light size and the space between two lights. a DockPadding propriedade será removido em tempo de criação. que opera em será necessário um designer personalizado que está associado ao controle MarqueeBorder especificamente.lightBrush : this. } // Draw the lights flush with the left edge of the control. // Draw the left column of lights.lightSizeValue + this.increment) / increment. // Draw the right column of lights. // Compute the number of lights to be drawn along the // horizontal edges of the control. yPos = this.lightSizeValue. // If the control is large enough. for (int i = 0.increment) / increment. lightCounter++. // These local variables will be used to position and // paint each light. i++) { brush = IsLit(lightCounter) ? this. DrawLight(g.lightSpacingValue. int lightCounter = 0. Visual Studio 77 . g.darkBrush. draw some lights. o MarqueeBorderDesigner será " sombra " e filtrar certas propriedades sobre o MarqueeBorder Controle.Clear(this. porque o MarqueeBorder controle programaticamente Define o enchimento com base no tamanho das luzes especificado pela propriedade LightSize.Height this. yPos -= increment.OnPaint(e). brush. i < horizontalLights. yPos). xPos += increment. } // Draw the lights flush with the right edge of the control. xPos. followed by the // right side. // Repaint when the layout has changed. yPos += increment. // Draw the top row of lights. int verticalLights = (this.this.Height .lightBrush : this. xPos -= increment.Width > MaxLightSize && this. yPos). i < verticalLights. } // This method paints the lights around the border of the // control. } } } Criando um designer personalizado para sombra e propriedades de filtro A MarqueeControlRootDesigner classe fornece a implementação para o designer raiz.darkBrush. // Compute the number of lights to be drawn along the // vertical edges of the control. i++) { brush = IsLit(lightCounter) ? this. brush. brush. que impede o usuário de fazer o MarqueeBorder controle invisível ou desativado durante o tempo de design. alterar sua interação com o ambiente de design. It paints the top row first. The color // of each light is determined by the IsLit method and // depends on the light's position relative to the value // of currentOffset. i++) { brush = IsLit(lightCounter) ? this.protected override void OnLayout(LayoutEventArgs levent) { base.lightBrush : this. Brush brush. protected override void OnPaint(PaintEventArgs e) { Graphics g = e. int horizontalLights = (this. e Enabled será propriedades ser sombreado pela Visible o MarqueeBorderDesigner Os designers também pode adicionar e remover propriedades.darkBrush. int yPos = 0. xPos. } // Draw the lights flush with the bottom edge of the control.Width . xPos. Permissions. using System.ComponentModel. qual interação alças o pai-filho.Forms. Na parte superior do arquivo. e delimite a definição para a MarqueeBorderDesigner classe com espaço para nome MarqueeControlLibrary. Alterar da declaração do MarqueeBorderDesigner para herdar de ParentControlDesigner.Windows.Deman d. que relieves você da necessidade para criar variáveis instância específica. Abrir o MarqueeBorderDesigner arquivo de origem no Code Editor. using System. 2.SecurityAction.PermissionSet(System. Clique com o botão direito do mouse na Design pasta e adicionar uma nova classe. 3.Windows. Para criar um designer personalizado às propriedades de sombra e filtro 1. using System. que tem métodos que pode alterar os atributos.A classe base de MarqueeBorderDesigner é ComponentDesigner.ComponentModel.Design. você deve seguir estas regras: • • • • Adicionar ou remover itens no apenas os PreFilter métodos Modificar itens existentes em apenas os PostFilter métodos Sempre chamar o implementação básica primeiro nos PreFilter métodos Sempre chamar o implementação básica última nos PostFilter métodos Adhering com essas regras garante que todos os designers no ambiente Designtime tenham uma exibição consistente de todos os componentes que está sendo criado. using System.Design.Collections.Security.Security. propriedades e eventos expostos por um controle em tempo de criação: • • • • • • PreFilterProperties PostFilterProperties PreFilterAttributes PostFilterAttributes PreFilterEvents PostFilterEvents Ao alterar a interface pública de um componente usar esses métodos. using System.Design { [System. MarqueeBorderDesigner herdado ParentControlDesigner. Name = "FullTrust")] public class MarqueeBorderDesigner : ParentControlDesigner { 4. C# namespace MarqueeControlLibrary. Como o MarqueeBorder controle pode conter controles filho.Forms. A ComponentDesigner classe fornece um dicionário para gerenciar os valores das propriedades sombreado.Design.Permissions.Diagnostics. using System. Fornecer o arquivo de origem uma nome de base de " MarqueeBorderDesigner ". C# Visual Studio 78 . importar os espaços para nome a seguir: C# using System. Substituir o implementação básica de PreFilterProperties. } 2. C# private void OnComponentChanged( object sender.Component is IMarqueeWidget) { this. C# public bool Visible { get { return (bool)ShadowProperties["Visible"]. } 5.Contains("Padding")) { properties. e se ele for. o designer pode anexar um manipulador para o ComponentChanged evento e executar quaisquer tarefas são necessários para manter um estado consistente em tempo de criação.Initialize(component). A maior parte da funcionalidade Design-time é herdada da classe DocumentDesigner. IComponentChangeService. } set { this. Abrir o MarqueeControlRootDesigner arquivo de origem no e substituem o Initialize Método. irá chamar o Refresh método em cada IMarqueeWidget objeto contido no MarqueeControl. Para lidar com alterações componente 1. o Code Editor Chamar o implementação básica de Initialize e para consultar o IComponentChangeService. if (cs != null) { cs. o MarqueeControl O ambiente em tempo de design oferece um serviço conveniente.ShadowProperties["Enabled"] = value. Você adquirir uma referência a esse serviço consultando o ambiente com o GetService método. chamar o Refresh método an IMarqueeWidget.PreFilterProperties(properties). Se a consulta for bem-sucedida. o Enabled Essas implementações sombra propriedades do controle. IComponentChangeService cs = GetService(typeof(IComponentChangeService)) as IComponentChangeService. (PropertyDescriptor)properties["Enabled"].CreateProperty( typeof(MarqueeBorderDesigner).ShadowProperties["Visible"] = value.ComponentChanged += new ComponentChangedEventHandler(OnComponentChanged). new Attribute[0]). C# base. Implementar o OnComponentChanged manipulador de eventos. Você no caso da MarqueeControlRootDesigner classe. } set { this. } } Tratamento alterações componente A MarqueeControlRootDesigner classe fornece a experiência Design-time personalizadas para sua MarqueeControl instâncias. Isso fará com que o IMarqueeWidget objeto para redesenhar próprio adequadamente quando propriedades como seu pai Size são alteradas. (PropertyDescriptor)properties["Visible"].Control. seu código será implementar dois personalizações específicas: tratamento alterações componente.protected override void PreFilterProperties(IDictionary properties) { base. ComponentChangedEventArgs e) { if (e. } } public bool Enabled { get { return (bool)ShadowProperties["Enabled"]. } } Visual Studio 79 .CreateProperty( typeof(MarqueeBorderDesigner).Refresh(). Como usuários criar suas MarqueeControl instâncias. new Attribute[0]).Remove("Padding"). e adicionar verbos Designer. if (properties. Testar tipo do componente de envio. properties["Enabled"] = TypeDescriptor. Implementar e Visible Propriedades. } properties["Visible"] = TypeDescriptor. o designer raiz acompanhará alterações e seus controles filho. para rastreamento altera para estado componente. adicione manipuladores de evento chamado OnVerbRunTest e OnVerbStopTest. O manipulador de eventos verbo quando Stop Test é chamado. c. consulte Como criar um editor tipo UI:.Stop(). Na definição da classe MarqueeBorder. consulte DesignerVerb. new EventHandler(OnVerbStopTest)) ). contidos para os controles contidos IMarqueeWidget também participará do teste. Você pode fazer isso criando um UITypeEditor. MarqueeSpinDirection e MarqueeLightShape são representadas por enumerações.Start(). Abrir o MarqueeBorder arquivo de origem no Code Editor. } 2. } private void OnVerbStopTest(object sender. new EventHandler(OnVerbRunTest)) ). Se conectar esses manipuladores de eventos a seus verbos Designer correspondente. irá chamar o StopMarquee método no MarqueeControl. Para obter mais informações. Criando um UITypeEditor personalizada Quando você criar uma experiência Design-time personalizados para usuários. A implementação do e StopMarquee métodos chamar esses métodos em controles que implementam IMarqueeWidget. Duas dessas propriedades. O manipulador de eventos verbo quando Run Test é chamado. 2.Verbs.Verbs.Control as MarqueeControl. c. o MarqueeControl Esses verbos será adicionado ao MarqueeControlRootDesigner.Adicionando verbos criador ao seu designer personalizado Um verbo Designer é um comando de menu vinculado a um manipulador de eventos. Esses verbos permitirá que você para exibir o comportamento em tempo de execução do em tempo de criação. Você adicionará dois verbos Designer a seu designers: Run Test e Stop Test. o StartMarquee Para adicionar verbos designer ao seu designers personalizados 1. O MarqueeBorder controle expõe várias propriedades na janela Propriedades. Verbos Designer são adicionadas ao menu de atalho é um componente em tempo de criação. Para criar um tipo personalizado UI Editor 1.Control as MarqueeControl. Para obter mais informações. declare uma classe denominada LightShapeEditor que deriva de UITypeEditor. Para ilustrar o uso de um editor tipo UI. EventArgs e) { MarqueeControl c = this. Herda MarqueeControlRootDesigner da sua classe base. um DesignerVerbCollection Você irá criar dois objetos novos DesignerVerb e adicioná-los a essa coleção no método Initialize. C# // This class demonstrates the use of a custom UITypeEditor. Na MarqueeControlRootDesigner Classe.Add( new DesignerVerb("Run Test". EventArgs e) { MarqueeControl c = this. C# this. a MarqueeLightShape propriedade terá uma classe Associado UITypeEditor. irá chamar o StartMarquee método no MarqueeControl. geralmente é desejável para criar uma interação com a janela Propriedades Personalizadas. // It allows the MarqueeBorder control's LightShape property // to be changed at design time using a customized UI element // Visual Studio 80 . C# private void OnVerbRunTest(object sender.Add( new DesignerVerb("Stop Test". this. 10). 4. Finalmente. Implementar Click manipuladores de eventos para e circlePanel controles. editorService). Defina a Location propriedade do controle circlePanel para (80. Dar o novo arquivo de origem uma nome de base de " LightShapeSelectionControl ". } return value. O DropDownControl método é chamado para iniciar o LightShapeEditor.DropDown. A MarqueeLightShape propriedade oferece suporte dois tipos de formas luz: Square e Circle. ele criará um LightShapeSelectionControl. Substituir o GetEditStyle método. C# private IWindowsFormsEditorService editorService = null. 80). seu UITypeEditor Para criar um controle de exibição para seu UI personalizado Editor tipo 1. Declarar uma IWindowsFormsEditorService variável chamada editorService instância. para o LightShapeSelectionControl Abrir o LightShapeSelectionControl arquivo de origem no Code Editor. internal class LightShapeEditor : UITypeEditor { 3. } 5. defina a Size propriedade do (150. Substituir o EditValue método. 2.LightShape. Defina a Location propriedade do controle squarePanel para (8. Definir a Size propriedade de ambos os Panel controles para (60. IServiceProvider provider. object value) { if (provider != null) { editorService = provider. 3. Visual Studio 81 . Essa implementação retorna DropDown. C# public override UITypeEditorEditStyle GetEditStyle( System. 60). O valor de retorno desta chamada é retornado para o ambiente de design. Arraste dois Panel controles da Toolbox.DropDownControl(selectionControl). o squarePanel Esses métodos chamar CloseDropDown para encerrar a sessão de edição personalizada UITypeEditor. Você criará um controle personalizado usado somente para o propósito de graficamente exibindo esses valores na janela Propriedades. 4. que informa o ambiente de design como serão exibidas a LightShapeEditor. editorService. C# public override object EditValue( ITypeDescriptorContext context. Essa implementação consulta o ambiente de design para um IWindowsFormsEditorService objeto.GetService( typeof(IWindowsFormsEditorService)) as IWindowsFormsEditorService. Organizá-los lado a lado.that is invoked by the Properties window. } Criando um controle de exibição para seu UITypeEditor personalizada 1. Se tiver êxito. Adicionar um novo UserControl item para o MarqueeControlLibrary projeto. } if (editorService != null) { LightShapeSelectionControl selectionControl = new LightShapeSelectionControl( (MarqueeLightShape)value. até a LightShapeSelectionControl Nome-los squarePanel e circlePanel. 10). value = selectionControl.ComponentModel. The UI is provided // by the LightShapeSelectionControl class. Este controle personalizado será usado pelo para interagir com a janela Propriedades.ITypeDescriptorContext context) { return UITypeEditorEditStyle. gSquare.editorService = editorService. } 8. which will be used to display // the initial state. this. using( Graphics gSquare = this.squarePanel. public MarqueeLightShape LightShape { get { return this.lightShapeValue == MarqueeLightShape. o squarePanel Além disso. // Handle the Click event for the two panels.squarePanel.Circle. Implementar a LightShape propriedade. EventArgs e) { this. } } base. if(components != null) { components.squarePanel. public LightShapeSelectionControl( MarqueeLightShape lightShape.lightShapeValue = value. 0. } set { if( this. // Cache the light shape value provided by the // design-time environment.Red. No método Dispose.lightShapeValue = MarqueeLightShape.Square.lightShapeValue = MarqueeLightShape.C# private void squarePanel_Click(object sender. 6. this.Dispose( disposing ).squarePanel. this.Invalidate( false ).lightShapeValue. anexar os Click manipuladores de eventos para e circlePanel eventos controles ' Click.lightShapeValue = lightShape. C# protected override void Dispose( bool disposing ) { if( disposing ) { // Be sure to unhook event handlers // to prevent "lapsed listener" leaks. gCircle = this.editorService.FillRectangle( Brushes. } } } 9.Square.Square ) { Visual Studio 82 . if( this. this. this.CreateGraphics() ) { // Draw a filled square in the client area of // the squarePanel control. desanexar os Click manipuladores de eventos. this.circlePanel. // If the Square option has been selected. this. C# // This constructor takes a MarqueeLightShape value from the // design-time environment.circlePanel.CloseDropDown(). C# // LightShape is the property for which this control provides // a custom user interface in the Properties window. No Construtor LightShapeSelectionControl.squarePanel.Height ). } 7.Click += new EventHandler(circlePanel_Click).Click -= new EventHandler(squarePanel_Click). this.Dispose().Invalidate( false ). this.editorService. Declarar uma MarqueeLightShape variável chamada lightShapeValue instância.OnPaint (e).lightShapeValue != value ) { this. this.Click -= new EventHandler(circlePanel_Click). Ele também realçará o valor selecionado desenhando uma borda ao redor de uma forma ou o outro. this. C# private MarqueeLightShape lightShapeValue = MarqueeLightShape.Click += new EventHandler(squarePanel_Click).CloseDropDown(). InitializeComponent(). Substituir o OnPaint método.circlePanel. IWindowsFormsEditorService editorService ) { // This call is required by the designer. 0. this.Width. EventArgs e) { this. } private void circlePanel_Click(object sender. C# protected override void OnPaint(PaintEventArgs e) { base. // Cache the reference to the editor service. draw a // border inside the squarePanel. } 5. atribuir o MarqueeLightShape Valor do ambiente de design para o lightShapeValue campo. Essa implementação será desenhar um quadrado sólido e círculo.CreateGraphics(). circlePanel. Compilar uma solução.Stop() End Sub 'stopButton_Click private void startButton_Click(object sender.gSquare. } 13. System. 2. 0. Isso irá criar uma instância do tipo DemoMarqueeControl e exibi-lo em uma instância do tipo MarqueeControlRootDesigner. 5. // If the Circle option has been selected.Start() End Sub 'startButton_Click Private Sub stopButton_Click(sender As Object.BackColor ).Circle ) { gCircle.circlePanel. 7.Width. Na Toolbox. 0.DrawRectangle( Pens.Height-1). gCircle. 0. Arraste uma instância do controle MarqueeText para a DemoMarqueeControl superfície de design.DrawRectangle( Pens. this. o DemoMarqueeControl 11.demoMarqueeControl1.Height ). this.FillEllipse( Brushes.Width-1. Definir o MarqueeControlTest projeto como o projeto de inicialização e executá-lo. 8.Blue. e alterar os Text valores de propriedade para " Iniciar " e " parar ". 0.squarePanel.Start(). Selecione e clique em seu glifo Marca Inteligente. this. você pode criar o MarqueeControlLibrary projeto. 0. } } } Testando o controle personalizado no criador Neste ponto. Você verá e MarqueeText Controles disponíveis para seleção.Black. e Stop métodos na DemoMarqueeControl Visual Basic Private Sub startButton_Click(sender As Object. o DemoMarqueeControl Selecione a Run Test opção para iniciar a animação.squarePanel. this. Nos Click manipuladores de eventos.EventArgs) Me. Você pode criar um controle que herda da classe MarqueeControl e utilizá-la em um formulário.Stop(). if( this.Height-1). abrir a MarqueeControlLibrary Components guia. Clique no Visual Studio 83 . draw a // border inside the circlePanel. Você verá disponíveis para seleção. Aberto Form1 no modo estrutura. this. gCircle. e As System. Na Toolbox. chamar a Start. Nome-los startButton e stopButton. e As System.demoMarqueeControl1.demoMarqueeControl1. o MarqueeBorder Arraste uma instância do controle MarqueeBorder para a DemoMarqueeControl superfície de design.EventArgs e) { this. 9. 3. 6. } // Draw a filled circle in the client area of // the circlePanel control. Clique Stop Test para parar a animação.Width-1. Colocar dois Button controles no formulário.EventArgs) Me.demoMarqueeControl1.circlePanel. 12.EventArgs e) { this. 4. Ancorar esse MarqueeBorder controle para o controle pai.circlePanel.Clear( this. Arraste uma instância de DemoMarqueeControl até a Form1 superfície de design.lightShapeValue == MarqueeLightShape. this.Black. Aberto DemoMarqueeControl no modo de design. 10. } private void stopButton_Click(object sender. respectivamente Implementar Click manipuladores de eventos para ambos os Button controles. 0. abrir a MarqueeControlTest Components guia. System. Para criar uma implementação MarqueeControl personalizado 1.circlePanel. Você verá o formulário exibindo seu DemoMarqueeControl. No menu File. Por exemplo. e garantir que o componente padrão será no espaço para nome correto. Um controle composto é essencialmente um componente com uma representação visual. Próximas etapas O MarqueeControlLibrary demonstra uma implementação de controles personalizados e designers associado simples. componentes. Na segunda parte da explicação passo a passo. Visual Studio 84 . você criar um controle composto simples chamado ctlClock. Composição em controles podem ser colocados no Windows Forms em da mesma maneira que outros controles. Você pode tentar sombreamento mais propriedades que Enabled e Visible. A MarqueeControl Licença. modificar propriedades de vídeo. nome conjunto. e nome do projeto. Na primeira parte dessa explicação passo a passo. escolha Import and Export Settings No menu Tools. você pode. Para obter mais informações.botão Iniciar para iniciar a animação. e clique Project para abrir a New Project caixa de diálogo. o DemoMarqueeControl Adicionar mais MarqueBorder controles e ancorado-los em suas instâncias pai para criar um efeito aninhadas. e você pode adicionar novas propriedades Adicionar novos verbos Designer para simplificar tarefas comuns como encaixe controles filho. Criando o projeto Quando você cria um novo projeto. Personalizar a experiência Design-time. consulte Configurações do Visual Studio. Para obter mais informações. ou executar outras tarefas necessárias para o autor. ou blocos de código que pode estender funcionalidade. • • • • Um controle composto com Visual C# Walkthrough: criação Controles Composite fornecem um meio pelo qual personalizado interfaces gráfica podem ser criadas e reutilizado. Para criar a biblioteca controle ctlClockLib e o controle ctlClock 1. criar " Um sinal néon flashing " ou um sinal animado com várias imagens. Como tal. você estender a funcionalidade de ctlClock através de herança. Faça suas experiências com configurações diferentes para as UpdatePeriod propriedades relacionadas luz-e o. Para alterar as configurações. Você pode fazer esse exemplo mais sofisticados de várias maneiras: • Alterar os valores de propriedade no criador. consulte Geração e compilação de código fonte dinâmico . Para obter mais informações. Criar suas próprias implementações de IMarqueeWidget. consulte Como: Licenciar componentes e controles. validar a entrada do usuário. você especificar seu nome para definir o raiz. ele pode consistir de um ou mais Windows Forms controles. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. aponte para New. Controlar como os controles são serializados e como código for gerado para eles. Você verá o texto piscando e as luzes mover-se a borda. Por exemplo. clique com o botão direito do mouse ctlClock.Alterar o nome do arquivo para ctlClock. 2. clique Save All para salvar o projeto. você irá incorporar Windows controles em seu controle composto e escrever código para implementar funcionalidade. selecione o Windows Control Library modelo de projeto. Adicionando Windows controles e componentes para o controle composto Uma interface visual é uma parte essencial de seu controle composto. se dois conjuntos de módulos (assemblies) fornecer componentes nomeado ctlClock.cs e clique em View Designer. Na ‘ Component Designer.2.Size 4. Esta interface visual é implementado pela adição de um ou mais controles do Windows para a superfície de designer. 3. No designer. e clique duas vezes Label.cs e clique em Rename. e implementa os métodos padrão e as propriedades. o Component Designer 5. digite ctlClockLib na caixa Name. ele não é exibido com os controles na superfície Designer. defina as propriedades a seguir. Observação Por padrão. Propriedade Name Text TextAlign Font. No Solution Explorer. Em expanda o Common Controls nó. clique timer1. Para adicionar um rótulo e um timer a seu controle composto 1. também é atribuída para a raiz por padrão. é um componente. A raiz é usado para qualificar os nomes dos componentes no conjunto. o Toolbox Um Label controle denominado label1 é adicionado a seu controle na superfície de designer. e. um Timer Portanto.cs. Na demonstração a seguir. ctlClockLib. e clique duas vezes Timer. o Toolbox Porque ele tem sem representação visual em tempo de execução. No menu File. em seguida clique em OK O projeto nome. mas sim em (uma bandeja na parte inferior da superfície designer). Visual Studio 85 . um controle composto herda da classe UserControl fornecida pelo sistema. A partir da lista de Visual C# projetos. A UserControl classe fornece funcionalidade exigido pelo composto todos os controles. No Solution Explorer. Clique no Yes botão quando lhe for perguntado se você desejar renomear todas as referências para o elemento de código " UserControl1 ". clique com o botão direito do mouse UserControl1. você pode especificar seu ctlClock componente usando ctlClockLib. Na janela Propriedades. 4.ctlClock. clique em label1. Alterar para lblDisplay (espaço em branco) MiddleCenter 14 Em expanda o Components nó. e defina a Interval propriedade 1000 e a Enabled propriedade true. 3. Certifique-se de alterar o modificador de private acesso para protected. O intervalo representa o número de milissegundos entre tiques. esse evento ocorrerá cada milissegundos de milhar. } set { colFColor = value.ForeColor = colFColor. } // Stores the selected value in the private variable colBColor. 3. } Este código fará com que a hora atual a ser mostrado no lblDisplay. você pode criar e Expor propriedades personalizadas Escrevendo os blocos de código apropriada. lblDisplay. Modificar o código para que ele parecido com o exemplo de código a seguir.. Essas instruções criar as variáveis particulares que você vai usar para armazenar os valores para as propriedades você está prestes a criar. Porque o intervalo de timer1 estava definido para 1000. No procedimento a seguir. lblDisplay. Para obter mais informações. Localize a public partial class ctlClock instrução. [C#] // Declares the name and type of the property. No menu File. ele executa o código no evento timer1_Tick. consulte a seção " Inheriting de um controle Usuário " abaixo. get { return colBColor. [C#] protected void timer1_Tick(object sender. Digite o seguinte código abaixo as declarações de variável da etapa 2. } } Visual Studio 86 .BackColor = colBColor. Cada ticks tempo timer1. private Color colBColor.A Interval propriedade controla a freqüência com a qual o Timer Componente Ticks.Text = DateTime. and // updates the background color of the label control lblDisplay. Na Component Designer. você adicionará as propriedades para o controle que permitem ao usuário para alterar a cor do plano de fundo e texto. Enquanto a propriedades individuais desses controles não irá ser acessíveis aos usuários subseqüentes do seu controle. System.EventArgs e) { // Causes the label to display the current time. O Code Editor para o controle abre. digite o seguinte código [C#] private Color colFColor. protected virtual void timer1_Tick(object sender. lblDisplay. assim atualizando o horário atual a cada segundo. Para adicionar uma propriedade para o controle composto 1. } } // Provides a similar set of instructions for the foreground color. clique com o botão direito do mouse ctlClock. System. cada um com seu próprio conjunto de propriedades herdadas. clique duas vezes timer1 Para ir para o timer1_Tick evento para ctlClock. public Color ClockForeColor { get { return colFColor.cs e clique em View Code. 7. 6. Sob o Brace abertura ({). Adicionar propriedades ao controle composto O controle relógio agora encapsula um Label controle e um Timer componente. clique Save All para salvar o projeto. 8.ToLongTimeString(). Modificar o método para ser assessor pela palavra-chave virtual. set { colBColor = value.Now.EventArgs e) 9. No Solution Explorer. 2. public Color ClockBackColor { // Retrieves the value of the private variable colBColor. métodos. você já viu como componentes e Windows controles podem ser combinados com código e embalagem para fornecer funcionalidade na forma de um controle de composição personalizado. A cor plano de fundo de seu controle alterada para a cor selecionada. clique Save All para salvar o projeto. No Solution Explorer. Pressione F5 para criar o projeto e executar o controle no UserControl Test Container. e clique em User Control A Add New Item caixa de diálogo é aberta. A primeira etapa para criar um controle herdado é para derivar-lo de seu pai. eles deve ser hospedado em um contêiner. ctlClock. No nesta seção. Visual Studio 87 . Nesta seção e as seções anteriores. O controle composto agora pode ser usado como uma base no qual outros controles pode ser construído. componentes. Escolha uma cor para selecioná-lo. 4. aponte para Add. 2.O código antecedente torna duas propriedades personalizadas. localize e selecione a propriedade para exibir a paleta de cores. substituindo métodos pai e adicionando novos métodos e propriedades. Testar comportamento em tempo de execução do seu controle e exercer suas propriedades com o UserControl Test Container. Para criar o controle herdado 1.. Para testar o controle 1. Selecione o Inherited User Control modelo. você criará um controle denominado ctlAlarmClock composto. Na próxima seção você aprenderá como construir um controle composto herdadas usando ctlClock como base. 4. e código em reutilizáveis controles composto. mas também pode atuar como uma base para a adição de novo ou modificado funcionalidade. e gráfica características do controle pai. Na grade. consulte HOW TO: testar o comportamento de um UserControl RunTime. Use uma seqüência de eventos semelhante para verificar se a ClockForeColor propriedade está funcionando como esperado. Você aprenderá a estender a funcionalidade de ctlClock. o Contêiner de Teste na propriedade a ClockBackColor propriedade. e como testar o controle depois que ele for concluída. Você aprendeu para expor as propriedades em seu controle composto. bem como código para implementar funcionalidade apropriado para a propriedade. você aprendeu como combinar Windows controles. Esta ação cria um novo controle que possui todas as propriedades. clique com o botão direito do mouse ctlClockLib. O processo de derivar uma classe de uma classe base é chamado Herança. ClockForeColor e ClockBackColor. 2. O get e set fornecer instruções para armazenamento e recuperação de valor da propriedade. Teste o controle Controles são aplicativos não autônoma. Será esse controle ser derivadas de seu controle pai. Herdar a partir de um controle composto Nas seções anteriores. No menu File. Para obter mais informações. 3. Usuários disponíveis para subseqüentes deste controle. e exibir a janela Propriedades. Clique na parte de exibição do controle. Observe que o controle herdado ctlClockLib. A Inheritance Picker caixa de diálogo será exibida. controles contido em um controle composto são private.cs tiver sido adicionado ao projeto atual. Em Component Name. você adicionará um controle rótulo que será memória flash quando o alarme é sounding. } set { dteAlarmTime = value. Localize a public class instrução.. e clique em Add. Para continuar adicionando ao alarme o relógio na interface visual. Observação Um arquivo chamado ctlAlarmClock. clique duas vezes ctlClock. e AlarmSet. } set { blnAlarmSet = value. 5. que indicará se o alarme está definido. Por padrão. // These properties will be declared as public to allow future // developers to access them. que será armazenar o valor da data e hora o alarme é para ir desativado. 2. 2. mas não as propriedades dos controles constituintes estará disponível a menos que eles foram especificamente expostos. } } public bool AlarmSet { get { return blnAlarmSet. No Solution Explorer.3. Sob o Brace abertura digite o seguinte código. digite ctlAlarmClock. } } Adicionando a interface gráfica do controle O controle herdado tem uma interface visual que é idêntica ao controle ela herda da. clique com o botão direito do mouse ctlAlarmClock e clique em View Code. [C#] private DateTime dteAlarmTime.cs. Observação Se você quiser que os subseqüentes usuários de seu controle composto para ter acesso a seus controles Visual Studio 88 . Na caixa Name.ctlClock. O designer para ctlAlarmClock abre na janela principal. Adicionando as propriedades alarme Propriedades são adicionadas a um controle herdadas da mesma maneira adicionados a um controle composto. Ele possui os mesmos controles constituintes como seu controle pai. Para adicionar o controle rótulo 1. public DateTime AlarmTime { get { return dteAlarmTime. No Solution Explorer. eles são esmaecidos. Você agora usará a sintaxe declaração da propriedade para adicionar duas propriedades ao seu controle: AlarmTime. 4. Isso indica que essas propriedades são nativo para lblDisplay e não pode ser modificado ou acessado na janela Propriedades. e suas propriedades não estão acessíveis por qualquer meio. clique com o botão direito do mouse ctlAlarmClock e clique em View Designer. Observação Enquanto todas as propriedades são exibida. private bool blnAlarmSet. No Solution Explorer. pesquise os projetos atual. ({) instrução. Para adicionar propriedades a seu controle composto 1. Você pode adicionar para a interface gráfica de um controle composto herdadas da mesma maneira ao deseja incluir em qualquer controle composto. EventArgs e) { // Calls the Timer1_Tick method of ctlClock. e). se estenderá a capacidade de ctlAlarmClock Mantendo todos os inerente a funcionalidade do ctlClock. 3. Neste procedimento. { if (AlarmTime.BackColor = Color. Em seguida. lblAlarm. adicione o seguinte código. Adicionar um Label controle para o controle composto. localizar o chave de fechamento no final da classe o Code Editor Imediatamente antes do Brace.interno. arraste o Label controle imediatamente abaixo da caixa Exibir. Configuração lblAlarm Alarme! MiddleCenter false 2. blnColorTicker = true. Instrução. The background color of the label // will flash once per tick of the clock. Usando o mouse. Visual Studio 89 .Now. Propriedade Name Text TextAlign Visible Adicionar a funcionalidade alarme Nos procedimentos anteriores. Em (}). ele executa código adicional para incorporar a funcionalidade alarme. if (AlarmSet == false) return.BackColor = Color. A override instrução devolve o controle para usar esse método em vez do método que foi herdada do controle base. } else { lblAlarm. } } else { // Once the alarm has sounded for a minute.timer1_Tick(sender. Na janela Propriedades. você adicionar propriedades e um controle que permitirá funcionalidade alarme no seu controle composto. if (blnColorTicker == false) { lblAlarm. Um controle rótulo flashing será exibido quando o alarme ocorre. Para substituir o método timer1_Tick do ctlClock 1. Quando esse método for chamado. Em Localizar a private bool blnAlarmSet.Visible = false. and minute of the alarm time are the same as // the current time. ou protected Isso permitirá que você possa definir e modificar propriedades de controles contido em seu controle composto usando o código apropriado. declare-los como public ou protected.Date == DateTime.Minute) { // Sets lblAlarmVisible to true. você será adicione código para comparar a hora atual para a hora alarme e.Hour && AlarmTime.. and changes the background color based on // the value of blnColorTicker.Minute == DateTime. [C#] protected override void timer1_Tick(object sender. lblAlarm.Red. substituindo o timer1_Tick método do ctlClock e adicionando código adicional a ela. ele chama o método substitui invocando a base.timer1_Tick instrução. else // If the date. blnColorTicker = false. defina as propriedades a seguir.Hour == DateTime.Visible = true. // Checks to see if the alarm is set. the label is made // invisible again.Now. hour.Date && AlarmTime. flash an alarm. Você. base. o Code Editor Imediatamente abaixo dele. se eles são os mesmos.Blue. [C#] private bool blnColorTicker. garantindo que todos os a funcionalidade incorporada ao controle original é reproduzida neste controle.Now. 4. adicione a instrução a seguir. } } } A adição deste código realiza diversas tarefas. System. para memória flash um alarme. clique com o botão direito do mouse ctlClockLib e clique em Build. clique duas vezes btnAlarmOff. um controle composto herdadas não pode autônoma sozinho e deve ser hospedado em um formulário ou outros contêiner. Propriedade Name Text 3. Para implementar o método shutoff 1. 2. Você irá gravar código para definir e exibir a AlarmTime propriedade de ctlAlarmClock. clique Save All para salvar o projeto. No Solution Explorer. Como com um controle composto padrão. Value (Valor) btnAlarmOff Desativar alarme No designer. Visual Studio 90 . Clique duas vezes o projeto para adicionar a referência para o projeto de teste. 2.cs e clique em View Designer. O ctlClockLib projeto será listado em Project Name. Adicione um novo Windows Application projeto para a solução. ctlClock:. No menu File. Para fazer isso. [C#] private void btnAlarmOff_Click(object sender. clique com o botão direito do mouse ctlAlarmClock. e denomine-Test. Adicionar um botão para o controle. Neste procedimento. } 5. será necessário para hospedar-lo em um formulário. A Code Editor abre para a private void btnAlarmOff_Click linha. Since ctlAlarmClock tem uma maior intensidade de funcionalidade. você adicionará código para o lblAlarm_Click método. AlarmSet = false. lblAlarm. System. Defina as propriedades do botão da seguinte maneira. Clique Add Reference para exibir a Add Reference caixa de diálogo.Visible = false.EventArgs e) { // Turns off the alarm. consulte HOW TO: testar o comportamento de um UserControl Run-Time. // Hides the flashing label. código adicional é necessário para testá-lo. A única coisa que permanece deve implementar uma maneira para desativá-lo.O controle relógio alarme está quase completo. O designer abre. 4. e será testar suas funções inerente. Clique com botão direito no Solution Explorer. Para colocar o controle a ser usado. Usar o controle Inherited em um formulário Você pode testar o controle herdadas da mesma maneira você testou o controle classe base. Modificar esse método para que ele parecido com o código a seguir. No Solution Explorer. você irá escrever um programa simples para testar a funcionalidade do ctlAlarmClock. Para criar e adicionar o controle a um formulário de teste 1. Pressione F5 para criar o projeto e executar o controle no UserControl Test Container Para obter mais informações. mouse no References nó para o projeto de teste. 3. Clique na guia rotuladas Projects. Definir as propriedades desses controles da seguinte maneira. Você aprendeu para criar um controle composto pela combinação controles e componentes em um contêiner controle composto. 5. Observe que a hora atual é atualizado no controle ctlAlarmClock. 7. clique com o botão direito do mouse Test e clique em Build. definir um valor em minutos que seja maior que a hora atual mostrada por ctlAlarmClock um minuto. Em expanda o ctlClockLib Components Nó. [C#] private void dtpTest_ValueChanged(object sender. Desativar o alarme clicando btnAlarmOff. o Toolbox Clique duas vezes ctlAlarmClock para adicionar uma cópia do ctlAlarmClock ao seu formulário. Quando o tempo exibido atingir o tempo ao qual o alarme é definido. Essa explicação passo a passo tem abordadas um número de principais conceitos.EventArgs e) { ctlAlarmClock1. clique com o botão direito do mouse Test e clique em Set as StartUp Project. lblTest.ToShortTimeString(). No menu Debug. Modificar o código para que ele parecido com o seguinte. Você aprendeu para adicionar propriedades para o controle. Controle label1 8.Text = "Alarm Time is " + ctlAlarmClock1. Em Localizar e clique duas vezes DateTimePicker Para adicionar um DateTimePicker controle ao seu formulário. 6. Esperar que o tempo exibido para atingir o tempo configuração alarme. No designer. Agora você pode redefinir o alarme. clique duas vezes dtpTest. No Solution Explorer. No Solution Explorer. } 12.AlarmTime = dtpTest. Propriedade Text Name Value (Valor) (espaço em branco) lblTest dtpTest Time dateTimePicker1 Name Format 10. O tempo para a Configuração de alarme é mostrado na lblTest. A Code Editor abre para private void dtpTest_ValueChanged. clique em Start Debugging. Inicia o programa de Teste. System. o lblAlarm será memória flash. ctlAlarmClock1.AlarmTime. 15. 13.AlarmSet = true. Usando o teclado. e que o hora de início é mostrado no controle DateTimePicker 14. Clique o DateTimePicker onde os minutos da hora são exibidos. Na última seção. 9.4. e adicione um Label controle clicando duas vezes Label. 16. e para escrever código para implementar funcionalidade personalizada. 11.Value. você aprendeu para estender a funcionalidade de um determinado controle composto a Visual Studio 91 . o Toolbox Usar o mouse para posicionar os controles em um local conveniente no formulário. Criar um novo Windows Application projeto. Você pode escrever aplicativos que estão capaz de executar várias tarefas simultaneamente. Essa capacidade. consulte Component BackgroundWorker Overview. você criará um componente multissegmentado simples que executa vários cálculos complexos simultaneamente. Visual Studio 92 . Um exemplo de um componente que pode alterar usar de multithreading. O usuário será entrada valores e sinal para o componente para iniciar cálculos. Um componente Multithreaded Simple com Visual C# Walkthrough: criação O BackgroundWorker Componente substitui e adiciona funcionalidade ao espaço para nome System. seria um componente que calcula informações de folha de pagamento O componente pôde processar dados inseridos em um banco de dados por um usuário em um segmento enquanto cálculos folha pagamento muito processor-foram executados em outro. você irá retornar valores para a interface de usuário. e para alterar a funcionalidade de métodos host por substituir esses métodos. escolha Import and Export Settings No menu Tools. argumentos não podem ser passados entre segmentos.herança. chamado multithreading. As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. Nesta demonstração. se você escolher. Ao executar esses processos em segmentos separados. Observação Embora geralmente seja uma função de um método preferível que calcule um valor. os usuários precisam aguardar o computador para concluir cálculos antes de inserir dados adicionais. 2. Para alterar as configurações.cs como frmCalculations. espaço para nome System. Você irá criar variáveis públicas no seu componente para armazenar valores recebidos da interface do usuário.cs. ou Liberar segmentação é uma maneira eficiente de componentes de design que são muito processor-e exigem entrada do usuário.Threading. Para criar o formulário 1. nem valores podem ser retornados. Existem muitas maneiras simples para fornecer valores para segmentos e para receber valores a partir deles. Criando o projeto O aplicativo consiste em um único formulário e um componente. Nome do aplicativo Calculations e renomeie Form1. No entanto. Quando Visual Studio solicita que você para renomear o Form1 elemento de código. Nessa explicação passo a passo. e eventos serão usados para notificar o programa principal quando um segmento de execução foi concluída. Este formulário servirá como a interface do usuário principal para seu aplicativo. consulte Configurações do Visual Studio.Threading foi mantida para compatibilidade com versões anteriores e uso futuro. Para obter mais informações. Você também irá implementar métodos no seu componente para executar os cálculos com base nos valores dessas variáveis. atualizando públicas variáveis. clique em Yes. O formulário irá receber valores de seu componente e exibirá-los em controles de rótulo. O componente executará os cálculos muito processor-e sinalizar o formulário quando concluído. Para obter mais informações. 4. Do Code Editor aberto para Calculator. 2. public int varAddTwo. int Counter). quatro Button controles. double TotalCalculations). 2. Observação Embora será você ser declarar quatro eventos. public delegate void FactorialCompleteHandler(double Factorial. Nome do componente Calculator. e um TextBox controle a seu formulário. Imediatamente abaixo as declarações de variável inseridas na etapa anterior. public int varLoopValue. a digite o seguinte código: // This delegate will be invoked with two of your events. public int varFact2. 2. 3. Declare Os delegados para os eventos que o componente será usado para comunicar valores para o formulário. No menu Project.1 Adicionar dois Executar um loop (vazio) Para criar o componente Calculadora 1. public int varFact1. você só precisará criar três representantes porque dois eventos terá a mesma assinatura. double TotalCalculations). public delegate void LoopCompleteHandler(double TotalCalculations. Definir propriedades para esses controles da seguinte maneira: Controle label1 label2 label3 label4 label5 button1 button2 button3 button4 textBox1 Name (Nome) lblFactorial1 lblFactorial2 lblAddTwo lblRunLoops lblTotalCalculations btnFactorial1 btnFactorial2 btnAddTwo btnRunLoops txtValue Texto (vazio) (vazio) (vazio) (vazio) (vazio) Fatorial Fatorial . e as outras variáveis vai receber valores do formulário. selecione Add Component. public delegate void AddTwoCompleteHandler(int Result.3. 1. Adicione instruções para criar variáveis públicas que será usado para passar valores frmCalculations para cada segmento. Adicionar cinco Label controles. A variável varTotalCalculations manterá uma execução total do número total de cálculos executada pelo componente. Para adicionar variáveis públicas ao componente Calculadora Para adicionar métodos e eventos ao componente Calculadora 1. Visual Studio 93 . public double varTotalCalculations = 0. } // Signals that the method has completed. } // This method will calculate the value of a number factorial. clique cada botão para gerar o contorno de código para manipuladores de eventos de cada controle Click e adicione código para criar os manipuladores. public event FactorialCompleteHandler FactorialMinusOneComplete. } // This method will run a loop with a nested loop varLoopValue times. public void FactorialMinusOne() { double varTotalAsOfNow = 0. public event LoopCompleteHandler LoopComplete.1. Imediatamente abaixo o código que você digitou na etapa anterior. varX <= varFact1. varTotalAsOfNow = varTotalCalculations. varX++) { // This nested loop is added solely for the purpose of slowing down // the program and creating a processor-intensive application. varLoopValue). Imediatamente abaixo do { tipo: Calculator Calculator1. } Transferindo Entrada de usuário para o componente A próxima etapa é para adicionar código para frmCalculations para receber entrada do usuário e para transferir e receber valores de e para o Calculator Componente. varY <= 500. varTotalAsOfNow = varTotalCalculations. 4. Se parecer Quando concluída. int varResult = varAddTwo + 2. varX <= varFact2 . varTotalAsOfNow = varTotalCalculations. Calculator1 = new Calculator(). Declarar os eventos que o componente será usado para se comunicar com seu aplicativo. varTotalCalculations += 1. for (varX = 1. 3. } // This method will add two to a number (varAddTwo+2). varTotalAsOfNow). Imediatamente antes adicione a seguinte linha: o }. varTotalCalculations += 1. digite o seguinte código: // This method will calculate the value of a number minus 1 factorial // (varFact2-1!). Para implementar front-end funcionalidade para frmCalculations 1. // Increments varTotalCalculations and keeps track of the current // total as of this instant. varTotalAsOfNow).1. 5. varX++) { varResult *= varX. double varTotalAsOfNow = 0. varX++) { varResult *= varX. for (int varY = 1. // Creates a new instance of Calculator. Fazer isso. adicionando o seguinte código imediatamente abaixo o código digitado na etapa anterior. FactorialMinusOneComplete(varResult. Localize o construtor. varTotalCalculations += 1. Localize a public partial class frmCalculations instrução. } } LoopComplete(varTotalAsOfNow. double varResult = 1. No designer. for (int varX = 1.4. public void RunALoop() { int varX. for (int varX = 1. 2. // Performs a factorial calculation on varFact2 . and communicates the // result and a value of total calculations performed up to this // point. public event FactorialCompleteHandler FactorialComplete. varX <= varLoopValue. public event AddTwoCompleteHandler AddTwoComplete. public void AddTwo() { double varTotalAsOfNow = 0. varTotalAsOfNow = varTotalCalculations. Aberto frmCalculations no Code Editor. varY++) { varTotalCalculations += 1. seu Click manipuladores de eventos devem com o seguinte: Visual Studio 94 . } FactorialComplete(varResult. // (varFact1!) public void Factorial() { double varResult = 1. varTotalAsOfNow). double varTotalAsOfNow = 0. AddTwoComplete(varResult. Parse(txtValue. Calculator1.varAddTwo = int.varFact2 = int.varFact1. double Calculations) { lblAddTwo. System. clique no botão rotulado Add Two.ToString().// Passes the value typed in the txtValue to Calculator. Calculator1.FactorialCompleteHandler(this.Text = "TotalCalculations are " + Calculations.Enabled = true.AddTwoComplete += new Calculator.Enabled = false. adicione o seguinte código imediatamente antes para manipular os eventos personalizados seu formulário receberá do Calculator1. { lblFactorial1.FactorialMinusHandler). } 6. btnFactorial2.LoopCompleteHandler(this. double Calculations) // Displays the returned value in the appropriate label. tipo 4.Enabled = true. O número " 6 " deve ser exibido no rótulo abaixo dele. // Updates the label that displays the total calculations performed lblTotalCalculations.ToString().Text). double Calculations) { lblFactorial2. // Disables the btnFactorial1 until this calculation is complete. Visual Studio 95 .Parse(txtValue. lblTotalCalculations. lblRunLoops.FactorialMinusOneComplete += new Calculator.Enabled = true.Text = Value. Embora você não tiver implementado capacidade multithreading ainda.varFact1 = int.EventArgs e) { Calculator1. Calculator1.EventArgs e) { Calculator1.Text).FactorialMinusOne(). } private void btnRunLoops_Click(object sender. btnFactorial2.Text). Calculator1.AddTwoCompleteHandler(this.varLoopValue = int. private void btnFactorial1_Click(object sender.ToString().Text = Count.Text = "Looping".LoopDoneHandler). System. // Re-enables the button so it can be used again.FactorialHandler).Enabled = false. lblTotalCalculations. Calculator1. Calculator1. btnRunLoops.RunALoop(). } private void LoopDoneHandler(double Calculations.ToString(). lblTotalCalculations.FactorialComplete += new Calculator. O aplicativo começa e frmCalculations aparece.EventArgs e) { Calculator1.Text = "TotalCalculations are " + Calculations.LoopComplete += new Calculator.Enabled = false.Parse(txtValue.Enabled = true. System. Partir do Debug menu.Parse(txtValue. } private void AddTwoHandler(int Value. btnAddTwo.Factorial().ToString(). btnFactorial1. Calculator1.AddTwoHandler).Text = Value. você testará o projeto para verificar sua funcionalidade antes de prosseguir. Teste seus aplicativos Agora você tenha criado um projeto que incorpora um formulário e um componente capaz de realizar vários cálculos complexos. } private void FactorialMinusHandler(double Value.Text = "TotalCalculations are " + Calculations.Text). int Count) { btnRunLoops. e devem ser exibidos em lblTotalCalculations " cálculos total são 1 ". Para testar seu projeto 1.FactorialCompleteHandler(this.Text = Value.AddTwo(). escolha Start Debugging.ToString().ToString().ToString(). Calculator1. System. } 5. Do } no construtor de frmCalculations. btnFactorial1. 2. digite o seguinte para manipular os eventos receberá do Calculator1 seu formulário: private void FactorialHandler(double Value.Enabled = false.Text = "TotalCalculations are " + Calculations. Após o código adicionado na etapa anterior. } private void btnAddTwo_Click(object sender.EventArgs e) { Calculator1. // Lets the user know that a loop is running lblRunLoops. Na caixa de texto. btnAddTwo. } private void btnFactorial2_Click(object sender. // Starts the thread.Threading.Threading. Se seu programa é executado somente um único segmento de execução. public System. Para adicionar a subrotina segmentos 1. public System.3.FactorialMinusOne)). Imediatamente antes do fim da declaração de classe na parte inferior do código. break.Threading.Thread(new System.Thread LoopThread.Threading.Threading.Thread FactorialThread.ThreadStart(this.Thread AddTwoThread. e lblTotalCalculations agora lê " cálculos total são 24.Threading. Em alterar o valor na caixa de texto para 20.Thread(new System. e.Threading. cálculos muito processor-como o exemplo acima terá a tendência unir o programa Backup até que os cálculos tenha sido concluídos. em seguida clique o botão rotulado Run A Loop.Threading. switch(threadNumber) { case 1: // Sets the thread using the AddressOf the subroutine where // the thread will start. Alterar o valor na caixa de texto para 5000000 e clique no botão rotulado Run A Loop. Adicionando recurso Multithreading O exemplo anterior demonstrado as limitações de aplicativos executados somente um único segmento de execução. LoopThread. localize a declaração de classe. Clique nela novamente. Na parte superior do código. case 3: AddTwoThread = new System. FactorialThread = new System.43290200817664E + 18 " é exibido abaixo dele.Threading.Thread FactorialMinusOneThread. break.Threading. Na próxima seção você usará a Thread classe para adicionar vários segmentos de execução ao seu componente.AddTwo)). clique no botão rotulado Factorial.Start().Factorial)). AddTwoThread.Start(). e clique imediatamente no botão rotulado Add Two. 2. case 4: LoopThread = new System. O número " 6 " deve ser exibido sob o botão. seguida. o { tipo o seguinte: // Declares the variables you will use to hold your thread objects. public System.1. case 2: FactorialMinusOneThread = new System. } } Visual Studio 96 . e imediatamente abaixo. nem qualquer controle no formulário irá responder até que os loops tenha sido concluídos. break.Start(). O rótulo sob este botão deve ler " 50000 " e os cálculos total exibidos são " 25000024 ". Observe que há um intervalo pequeno mas notável antes este botão seja reativada.ThreadStart(this.RunALoop)).Thread(new System. public System. O botão não responder. Aberto Calculator. O número " 2.ThreadStart(this. " 4.Threading.Threading. Altere o valor na caixa de texto para 50000. adicione o método a seguir: public void ChooseThreads(int threadNumber) { // Determines which thread to start based on the value it receives. FactorialMinusOneThread. 6. " 5. e lblTotalCalculations agora leituras " cálculos total são 4. 3.cs no Code Editor.Start(). Na próxima seção.Thread(new System. FactorialThread. Agora clique no botão rotulado Factorial .ThreadStart(this. break. você adicionará capacidade multithreading ao seu aplicativo para que vários segmentos podem ser executados uma vez. // Calculator1. o Code Editor. você usará o System. e portanto somente pode indicar um void método.RunALoop(). Como controles são sempre pertence ao segmento principal de execução.FactorialMinusOne(). 3.Parse(txtValue. // Calculator1. Empacotamento é o ato de mover uma chamada entre limites do segmento.ChooseThreads(1). Adicione a seguinte linha para chamar o Calculator1. Observação Certifique-se incluir o valor apropriado para o Threads argumento.Text).Parse(txtValue.Text). System.varFact1 = int. thus directing it to start the // correct thread. Calculator1. Para adicionar o código apropriado a frmCalculations 1. // Calculator1.varFact1 { Calculator1.AddTwo().Factorial() 2.Parse(txtValue. A ThreadStart não pode receber parâmetros ou valores secreta.varFact2 = int.Factorial1 método diretamente como mostrado: // Calculator1.varAddTwo = int. Fazer modificações semelhantes para os outros button_click métodos. Comentário fora da linha que chama o Calculator1. a quantidade de entre segmentos Boundary-empacotamento que deve ocorrer assim Minimizing.EventArgs e) { Calculator1. // Lets the user know that a loop is running lblRunLoops.Delegate) método para chamar métodos no segmento principal de execução. 1. Calculator1. Quando você tiver terminado.ChooseThreads(1).Parse(txtValue. ele requer um argumento na forma de.Windows. seu código deverá ter semelhante à seguinte: private void btnFactorial1_Click(object sender.Text = "Looping". System.Enabled = false. // Disables the btnFactorial1 until this calculation is complete btnFactorial1. 2. Calculator1. Calculator1.EventArgs e) // Passes the value typed in the txtValue to Calculator. O ChooseThreads método você apenas implementado receber um valor a partir do programa chamá lo e usa esse valor para determinar o segmento apropriado para iniciar.Quando instanciado. } private void btnRunLoops_Click(object sender. btnFactorial2. // Calculator1. qualquer chamada para um controle de um segmento subordinada requer uma empacotamento chamada. e é muito dispendioso em termos de recursos.ChooseThreads(4).Text).BeginInvoke(System.ChooseThreads(3). btnRunLoops. Abre o frmCalculations.Enabled = false.varLoopValue = int. btnAddTwo.Factorial(). } private void btnAddTwo_Click(object sender.Control.EventArgs e) { Calculator1.ChooseThreads(2). é um Thread um ThreadStart O ThreadStart é um representante que aponta para o endereço do método onde o segmento é para começar. } private void btnFactorial2_Click(object sender. System. Para minimizar a quantidade de empacotamento que precisa a ocorrer. Calculator1.cs arquivo no localize private void btnFactorial1_Click.Enabled = false. System.Text).Forms. } Empacotamento chamadas para controles Agora você irá facilitam atualizando a exibição no formulário. Esse tipo Visual Studio 97 . e certifique-se que as chamadas serão tratadas de forma isenta de segmentos.ChooseThreads método: // Passes the value 1 to Calculator1.EventArgs e) { Calculator1.Enabled = false. this. Você pode chamar BeginInvoke de seu formulário (this. int Count) { } 3. double Calculations) { } public void Add2Handler(int Value. AddTwoHandler. Adicionar os seguintes métodos vazios a seu código. new Object[] {Value. new Object [] {Value. double Calculations) { this. new Object[] {Value. new Object[] {Calculations. seu código deverá ter semelhante à seguinte: protected void FactorialHandler(double Value. int Count) { this. public delegate void LDHandler(double Calculations. double Calculations) { } public void Fact1Handler(double Value. double Calculations) { this. } protected void FactorialMinusHandler(double Value. AddTwoHandler. double Calculations). it transfers execution of // this method back to the main thread. No menu Edit. int Count). e LoopDoneHandler e LDoneHandler Quando terminar. consulte HOW TO: Manipulate controles de segmentos. Para obter detalhes. e LoopDoneHandler. Calculations}). public void FactHandler(double Value. Simply put. double Calculations) { } public void LDoneHandler(double Calculations.BeginInvoke(new A2Handler(Add2Handler). uso Cut e Paste Para Recortar todo o código do método FactorialHandler e colá-lo em FactHandler. Para criar os procedimentos invoking controle1. e Add2Handler. não deve haver nenhum código restantes em FactorialHandler.BeginInvoke(new FHandler(FactHandler). } protected void AddTwoHandler(int Value. e InvokeBeginInvoke exigem um representante para o método apropriado como um argumento. public delegate void A2Handler(int Value. Repita a etapa anterior para FactorialMinusHandler e Fact1Handler. double Calculations) { // BeginInvoke causes asynchronous execution to begin at the address // specified by the delegate. Abrir o Editor de frmCalculations código. Any parameters required by // the method contained at the delegate are wrapped in an object and // passed. 2.) ou qualquer um dos controles no formulário Quando concluída. } Pode parecer que o manipulador de eventos simplesmente está fazendo uma chamada para o método próxima. e todo o código usado para conter esses devem ter sido movidos para novos métodos apropriados 5. Factorial1Handler. Essa abordagem salva em chamadas entre limites do segmento e permite que o aplicativos multisegmentados para executar com eficiência e sem medo de causar lockup. 4. } protected void LoopDoneHandler(double Calculations.BeginInvoke(new FHandler(Fact1Handler). Na seção Declarações.de chamada é necessário ao chamar métodos que manipulam controles. O manipulador de eventos realmente está causando um método para ser chamado no segmento principal da operação. Chame o BeginInvoke método para chamar os métodos de forma assíncrona. Count}).BeginInvoke(new LDHandler(LDoneHandler). Para obter detalhes sobre como trabalhar com controles em Visual Studio 98 . adicione o seguinte código: public delegate void FHandler(double Value. Calculations}). double Calculations). Calculations}). Essas linhas declarar o representante assinaturas que serão usadas por BeginInvoke para chamar os métodos apropriados. Na sucessão rápida. varTotalAsOfNow = varTotalCalculations. escolhendo Start Debugging no menu Debug. resultados são retornados no Run A Loop botão abaixo. Teste sua solução. Um conjunto de instruções que execute como uma unidade são disse para ser atômicas. No exemplo mostrado acima. execução na expressão especificada será bloqueada até que o segmento especificado tem um bloqueio exclusivo no objeto em questão. Resultados posteriormente serão exibidos nos rótulos abaixo os botões factorial. Coordenar seus segmentos Um usuário experiente de aplicativos multisegmentados pode Perceive uma falha sutis com o código como digitado. Se conclui muito cedo. Mas se vários segmentos em execução. " loop " é exibido no rótulo abaixo neste botão. 2. do Declaração lock (Referência do C#) fornece Visual C# para permitir sincronização de segmentos para garantir que cada segmento sempre retorna um resultado preciso. Estas duas linhas de código incrementar a variável varTotalCalculations Pública e defina a variável varTotalAsOfNow local com esse valor. quatro conjuntos separados de cálculos foram executados simultaneamente em quatro segmentos separados.000. Recuperar as linhas de código de cada método desempenho cálculo-em Calculator: varTotalCalculations += 1. O rótulo abaixo Add Two deve ser o primeiro para exibir um resultado. relatando resultados imprecisos. Isso leva à possibilidade que cada segmento na verdade. } Quando o lock Bloco for digitado. outro segmento pode alterar o valor desta variável por incrementando-. // Insert more code that affects the object. Esses resultados avaliada como infinito. // Insert more code that affects the object. A interface do usuário permaneceu responde às solicitações. 7. Finalmente. a expressão é liberada e os segmentos são permitidos para continuar normalmente. 6. Esse valor é retornado ao frmCalculations e exibido em um controle rótulo. Você encontrará que todos os botões responder a uma entrada. após um atraso adicional.um ambiente com vários segmentos. clique em Todos os três botões que ainda estão ativados. Digite 10000000 na caixa de texto e clique em Run A Loop. Mas é o valor correto sendo retornado? Se apenas um único segmento de execução estiver sendo executado. // Release the lock. A execução pode prossiga como um bloco sem interferência de outros segmentos. Cada segmento tem a capacidade para incrementar a variável varTotalCalculations. É possível que após um segmento incrementa essa variável. Esse loop deve tomar uma quantidade significativa de tempo para executar.000 é muito grande para uma variável de precisão dupla para conter. Como você apenas observado. como o número retornado por uma FATORIAL 10. e eles foram retornados após cada segmento concluído. 1. é o } Visual Studio 99 . consulte HOW TO: Manipulate controles de segmentos. Salve seu trabalho. Deve lock ser usado com um objeto que retorna uma referência em vez de um valor. a resposta será mais certeza. está. A sintaxe para lock é a seguinte: lock(AnObject) { // Insert code that affects the object. a execução está bloqueada no AnObject. ajustar o tamanho do número de acordo. a resposta é claramente Sim. mas antes ele copia o valor a varTotalAsOfNow. Quando encontrado. Para alterar as configurações. Criando o projeto Quando você cria um novo projeto. se dois conjuntos de módulos (assemblies) fornecer componentes nomeado ValueButton. varTotalAsOfNow = varTotalCalculations. também é atribuída para a raiz por padrão. consulte Configurações do Visual Studio. Por exemplo. Você deve cuidadosamente considerar a necessidade de segmentos. escolha Import and Export Settings No menu Tools. 2. Você pode perceber um pequeno impacto no desempenho do seu programa. Isso ocorre porque a execução de segmentos pára quando um bloqueio exclusivo é obtido no seu componente. A herança é capaz de criar controles que mantenham toda da funcionalidade inerente do Windows Forms controles padrão mas também incorporar funcionalidade personalizada.cs no Code Editor. e para garantir que o componente padrão será no espaço para nome correto. A raiz é usado para qualificar os nomes dos componentes no conjunto. bloqueio e implementá-las somente quando absolutamente necessário. Esse botão herdarão funcionalidade do controle Windows Forms Button padrão. 3. para definir o raiz. Para obter mais informações. Modifique este código para que ele lê da seguinte maneira: lock(this) { varTotalCalculations += 1. você especificar seu nome. você pode especificar seu ValueButton componente usando Visual Studio 100 . Salve seu trabalho e testá-lo como no exemplo anterior. Embora ele garante a precisão. aponte para New e clique Project para abrir a New Project caixa de diálogo. e nome do projeto. Selecione o Windows Control Library modelo de projeto a partir da lista de Visual C# projetos e tipo ValueButtonLib na caixa Name. você criará um controle herdado simples chamado ValueButton. essa abordagem impedes alguns dos benefícios de desempenho de vários segmentos. um em cada método de cálculo. e será expor uma propriedade personalizada chamada ButtonValue. Para criar a biblioteca controle ValueButtonLib e o controle ValueButton 1. } 4. você pode criar poderosos controles personalizados através Herança. Nessa explicação passo a passo. ValueButtonLib. varTotalAsOfNow = varTotalCalculations. No menu File. nome conjunto. O projeto nome. Deve haver quatro instâncias desse código. 2.Para adicionar a instrução de bloqueio ao seu aplicativo 1. Aberto Calculator. Localizar cada ocorrência do código a seguir: varTotalCalculations += 1. Walkthrough: Inheriting a partir de um controle do Windows Forms com Visual C# Com Visual C# 2005. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. public int ButtonValue { // Sets the method for retrieving the value of your property. Abrir este arquivo no Code Editor. No menu File. 6. clique com o botão direito do mouse ValueButton.cs e depois escolha Rename No menu de atalho. clique com o botão direito do mouse ValueButton. Este código define os métodos pelo qual a ButtonValue propriedade está armazenados e recuperados. Essa propriedade não existe no controle Button. Em Solution Explorer.Designer.cs e. 7. A get instrução define o valor retornado para o valor que é armazenado na variável varValue particular. abra o ValueButton. Porque o Button controle faz sua própria pintura. Alterar o nome do arquivo para ValueButton.ValueButtonLib.cs. Sua representação visual será ser exatamente a mesma que a classe ela herda da) (ou seja. Localize o InitializeComponent método e remover a linha que atribui a AutoScaleMode propriedade. Na Solution Explorer. e alterar o tipo do qual esse controle herdado UserControl para Button Isso permite que o controle herdadas para herdar todas as funções do controle Button. No Solution Explorer. que têm nenhum elemento UI. mas expõe propriedades personalizadas. 8. consulte Namespaces (Guia de programação C#). você não consegue para modificar sua aparência no designer. Clique no Yes botão quando lhe for perguntado se você deseja renomear todas as referências para o elemento de código ' UserControl1 '. } // Sets the method for setting the value of your property. set { varValue = value. Observação Um criador visual está não mais disponível. Para adicionar a propriedade Value 1. 5. No nesta seção. Adicionar uma propriedade ao seu controle Inherited Um uso possíveis de herdadas controles Windows Forms é a criação de controles que são idênticos no aspecto e estilo de padrão controles Windows Forms. optar Save All por salvar o projeto. e a set instrução define o valor da variável particular pelo uso da palavra-chave value. Teste O controle Visual Studio 101 . optar Save All por salvar o projeto.cs. // Declares the property. } } 4. Imediatamente após o { tipo o código a seguir: [C#] // Creates the private variable that will store the value of your // property. No menu File.ValueButton Para obter mais informações. private int varValue. ValueButton.cs e selecione View Code.. Ainda assim você pode adicionar componentes. 3. get { return varValue. 3. clique com o botão direito do mouse UserControl1. em seguida clique na View Code partir do menu de atalho. você adicionará uma propriedade chamada ButtonValue para o controle. No Solution Explorer. para a superfície de design. Button a menos que modificado no código de. Localize a class instrução.cs nó para exibir o arquivo código gerado pelo designer-. 2. Localize a class linha public partial class ValueButton Instrução. Selecione o Windows nó. clique em Build Solution. examine as propriedades deste controle. 6. No Solution Explorer. Clique com o botão direito do mouse e selecione Properties a partir do menu de atalho. 4. 5. Clique duas vezes ValueButton. 3. 8. A compilação deve ser bem-sucedida sem nenhum erros do compilador ou avisos. No menu File. Clique na guia rotuladas Projects. mouse Test e selecione Build. O ValueButtonLib projeto será listado em Project Name. No Solution Explorer. 6. Realoque o rótulo para o centralizar do formulário. 4. 7.Controles são projetos não autônoma. e clique em Windows Application. Visual Studio 102 . Inserir a linha de código a seguir. Para adicionar o controle ao formulário 1. clique duas vezes Label Para adicionar um Label controle ao seu formulário. em seguida. você deve fornecer um projeto de teste para que ele seja executado. clique com o botão direito do mouse no References nó do seu projeto de teste. Defina a ButtonValue propriedade como 5. ButtonValue. exceto que não há uma propriedade adicionais. selecione Add Reference a partir do menu de atalho para exibir a Add Reference caixa de diálogo.cs e escolha View Designer a partir do menu de atalho. Na guia All Windows Forms da Toolbox. 3. 9. Observe que eles são idêntico às propriedades expostos por um botão padrão. 2. digite Test. Para criar o controle • No menu Build. Para criar um projeto de teste 1. clique ValueButtonLib Components. A Code Editor abre para o valueButton1_Click evento. sob o Visual C# nó. A ValueButton aparece no formulário. aponte para Add e clique New Project para abrir a Add New Project caixa de diálogo. o ValueButton Na janela Properties. Clique duas vezes o projeto para adicionar a referência para o projeto de teste. Clique duas vezes valueButton1. Na ‘ Toolbox. será criar o controle e testá-lo em um formulário do Windows. No nesta seção.Text = valueButton1. Na caixa Name.ButtonValue. clique com o botão direito do mouse Form1. eles deve ser hospedado em um contêiner.ToString(). 2. Você também deve tornar o controle acessíveis para o projeto teste criando (compilação)-lo. A fim de testar o controle. [C#] label1. Clique com botão direito no Solution Explorer. 5. mas expõe uma propriedade adicionais e personalizados. Aparece Form1. 12. demonstrando que a ButtonValue propriedade do seu controle herdado foi passado para label1 através do valueButton1_Click método. selecione Start Debugging. O número ' 5 ' é exibida no label1. Clique em valueButton1. clique com o botão direito do mouse Test e escolha Set as Startup Project No menu de atalho. No Solution Explorer. No menu Debug. 11. Assim o ValueButton controle herda todas as funções do botão Windows Forms padrão. Visual Studio 103 .10. Explicação passo a passo cada discute o desenvolvimento de um tipo aplicativo específico ou recurso de aplicativo principal usando uma série de instruções passo a passo. o aplicativo rich client típico contém um subconjunto dos recursos apresentados. Você irá importar esta biblioteca de classes para outro projeto. As orientações seguir descrevem o processo de Criando aplicativo com base em formulários usando vários tipos controle diferente. Walkthroughs do Windows Forms Lista orientações adicionais que podem ser executados para familiarizar-se com recursos do Visual Studio. e criar um novo formulário herdeira do formulário básico. Na maioria dos casos. Walkthroughs de aplicativos cliente Rich O aplicativo rich client típica é um executável autônomo com uma interface gráfica composta de vários controles para o usuário. Observação O objetivo principal dessas orientações é para demonstrar os vários recursos do Visual Studio disponíveis para o desenvolvedor do cliente Rich. Demonstrar herança Visual Descreve como criar um formulário Windows base e compilá-lo em uma biblioteca de classes. explicação passo a passo cada incorpora métodos ou recursos de partes diferentes do Visual Studio. Criar um aplicativo distribuídos Explica como criar um aplicativo de várias camadas. Isso fornece uma introdução prática para os vários recursos principais do Visual Studio de uma maneira clara e ordenada. e depois exibir os dados no formulário. e Consumir um serviço XML da Web criado com Visual Basic ou Visual C#.Explicações passo-a-passo do Visual Studio Essas orientações introduzir as áreas importantes do produto Visual Studio. Portanto. Visual Studio 104 . Nesta seção Criando um aplicativo cliente Rich com MFC Demonstra como criar uma interface cliente rico-usando a biblioteca) classe MFC (Microsoft Foundation. ilustra as etapas fundamentais necessárias para criar Windows Forms no Visual Basic e Visual C#. conexão com um banco de dados existente. distribuídos que tem um cliente Windows Rich e uma interface do navegador. Seções relacionadas Criar um formulário simples do Windows Usando um exemplo simples mas completa. uma biblioteca de classes Well-tested que compatível diversos amplo de recursos comuns a todos os aplicativos Windows. Walkthrough: Criando um aplicativo cliente Rich com MFC Explicação passo a passo o seguir descreve um procedimento para criar um aplicativo rich client MFC-Based e vários outros recursos do Visual Studio . 2. Na caixa Name. No MFC Application Wizard. 4. Visual Studio 105 . Selecione a Database View with File Support opção. 5. você modificará seu projeto para oferecer suporte o acesso a bancos de dados e exibir recursos do aplicativo rich client. Para implementar suporte a banco de dados 1. clique no MFC Application ícone. No menu File. Usando o MFC Application Wizard. 3. Observação Essa explicação passo a passo presume que o servidor está sendo acessado é um servidor SQL e o pubs banco de dados que existe no servidor. Criar o aplicativo cliente Rich MFC Para criar o aplicativo MFC 1. selecione Database Support. 3. Digite ou selecione um nome de servidor existente. 2. você irá realizar as atividades a seguir: • o o o Criar uma solução-com base MFC que exibe dados de um banco de dados existente e exibe os seguintes recursos usando várias caixas de diálogo: Hospedando um controle ActiveX sem janelas Usando dinâmico caixas de diálogo HTML (DHTML) Validando o usuário do aplicativo usando um serviço XML da Web existente. clique no Microsoft OLE DB Provider for SQL Server item e clique em Next. clique em New. deve fornecer um banco de dados existente e pelo menos uma tabela pesquisável. Selecione Use Windows NT Integrated Security. Clique OK para fechar a caixa de diálogo e abrir o MFC Application Wizard. Durante o curso desta explicação passo a passo. digite MyProject.NET. No painel tipos Project. 4. Na caixa OLE DB Provider(s) de listagem. e clique em Project A New Project caixa de diálogo será exibida. Clique no Data Source botão. Para concluir o explicação passo a passo. 6. clique em Visual C++ Projects. Observação Essa explicação passo a passo usa o pubs banco de dados e authors tabela como um banco de dados exemplo e tabela. e em Painel Modelos. Na janela Propriedades. expanda o nó de projeto e clique duas vezes no OnInitialUpdate método da classe CMyProjectView. Você irá modificar este formulário para exibir uma lista simples de autores da tabela authors. while(cmd. Arraste um Button controle para o formulário padrão. alterar a Caption caixa para DHTML Dialog. Selecione o pubs banco de dados. 3. szAuthor). 4. 11. Para exibir os resultados da consulta 1. Depois que o aplicativo estrutura for criado. no menu de atalho. O MyProject aplicativo já contém um objeto de formulário (chamado IDD_MYPROJECT_FORM) localizado sob o nó diálogo no modo de exibição de recurso. 2. Selecione OK para fechar a caixa de diálogo. clique em Add Variable. CMyProjectSet &dbset = GetDocument()>m_MyProjectSet. digite m_DataList e clique em Finish. Observação Esses dois controles serão usados posteriormente no explicação passo a passo o para acessar outros recursos do aplicativo. 8. 9.MoveNext() == S_OK) m_DataList. Arraste um Button controle para o formulário padrão. Os resultados da consulta (todos os autores na tabela) são exibidos em uma caixa de listagem. 10.h. Porque este é apenas uma demonstração. 12. alterar a Caption caixa para Control Host. Para modificar o formulário 1. 6. 2. expanda o Projeto. Acessar e exibir dados de um banco de dados existente Nesta seção. Clique com o botão direito do mouse no List Box controle e. será necessário remover a #error linha de MyProjectSet. e clique duas vezes no objeto de formulário padrão). No modo de exibição de recursos. Na janela Propriedades. Clique Finish para criar o aplicativo estrutura.7.. hresult=hr) { SELECT au_lname ([bindto]szAuthor) FROM AUTHORS }]. No modo classe. consulta e exibição são simples. O Add Member Variable Wizard aparece. principais recursos podem ser adicionados. Adicione o seguinte código após qualquer código existente na função: HRESULT hr = S_OK. 5. você usará um formulário simples e controle para demonstrar o acesso e exibição dos dados da tabela authors. source_name="dbset". TCHAR szAuthor[80]. Na caixa Select Database Object de diálogo.InsertString(-1. selecione a authors tabela. Após a criação do projeto. Clique no OK botão para estabelecer a conexão. (IDD_MYPROJECT_FORM Arraste um List Box controle para o formulário padrão. [db_command(name="cmd". expanda o Dialog nó. Visual Studio 106 . Na caixa Variable name. No menu de atalho. 4. Clique Finish para aceitar as configurações padrão e criar o projeto. 4. 3. No menu Debug. 10. e clique em Add Class A Add Class caixa de diálogo será exibida. 5.) com os nomes de todos os autores atuais na tabela última 3. Criando e hospedando um controle ActiveX sem janelas A modificação próxima para o aplicativo rich client é uma caixa de diálogo que hospeda um controle personalizado simples sem janelas. Para criar o evento Click 1.Esse código usa o db_command atributo ao inicializar o conjunto de dados de objeto do documento (m_MyProjectSet. e clique em New Project A New Project caixa de diálogo será exibida. O ATL Project Wizard aparece. Clique com o CustomCtl projeto. No menu de atalho. 9. clique no ATL Project ícone Digite CustomCtl para o nome do novo projeto e clique em OK. e no painel Modelos. Em seguida um objeto Caixa de diálogo é criado que contém o controle e manipular o evento de controle. clique com o botão direito do mouse a MyProject Solução. No menu Build. No menu de atalho. clique em Start Without Debugging. Na página Options. Para criar o controle personalizado 1. 4. clique em Add. expanda o CustomCtl nó. Este evento é acionado pelo controle sempre que o mouse é clicado na área de controle. 8. O ATL Control Wizard aparece. 3. 11. Clique com o botão direito do mouse o interface de eventos para o controle personalizado (_IMyCtlEvents). insira MyCtl na caixa Short name. Clique duas vezes no ATL Control item. clique em Add. o No modo de classe. No Explorer Solution. 6. 7. e clique em Add Method Insira os seguintes valores usando o Adicionar Assistente método: Return typevoid Visual Studio 107 . 2. Clique Finish para criar o objeto controle personalizado. selecione Visual C++ Projects. Na ATL Control Wizard. Depois que o controle for criado. clique em Build Solution. clique em Add. No painel tipos Project. você adicionará um evento simples chamado Click. Os resultados da consulta serão exibidos na caixa de listagem do formulário modo filho. escolha Connection points. A primeira etapa é para criar um controle ActiveX personalizado com um evento simples. 2. Na caixa de diálogo. 4. clique com o botão direito do mouse a MyProject Solução. 10. 3. No modo de exibição do recurso. insira os seguintes valores: Class nameCMyCtlDlg Base classCDialog Clique em Finish. 11. No menu de atalho. Clique duas vezes no Control Host botão. o o No Assistente para classe MFC. No modo de classe.o Method nameClick Clique Finish para criar o Click evento. Do IDD_MYPROJECT_FORM no modo de exibição de recursos. Clique com botão direito mouse na IDD_DIALOG1 caixa de diálogo e clique Add Class no menu de atalho. 5. 8. clique no Messages botão e adicionar um OnLButtonDown manipulador para a WM_LBUTTONDOWN mensagem. clique em Add. 7. selecione a classe de controle (CMyCtl). return 0. 9. clique o Control Events botão e adicione um ClickMyctl1 manipulador para o Click evento. selecione CMyCtl Object e Insert ActiveX Control clique OK para adicionar o controle. Na janela Propriedades. adicionada anteriormente. Visual Studio 108 . Para exibir a caixa de diálogo de controle host 1. 7. exibir o formulário principal clicando duas vezes (localizada sob o Dialog nó do arquivo de recurso para a MyProject Solução). A etapa final envolve conectando a caixa de diálogo para o aplicativo rich client. 5. No menu Build. O assistente classe MFC aparece. Adicione o seguinte código para a função do manipulador: 2. e clique em Add Resource Clique no Dialog item e clique em New. Selecione o controle ActiveX em um modelo de diálogo. Isso é feito com código no manipulador para o botão Controlar host você criou anteriormente. Para hospedar o controle 1. Clique com o botão direito do mouse na IDD_DIALOG1 caixa de diálogo e selecione Insert ActiveX Control no menu de atalho. 8. 2. no tópico Accessing and Displaying Data from an Existing Database. 6. Depois que a solução cria com êxito. Adicione o seguinte código para o corpo do manipulador de eventos: AfxMessageBox("Click event fired"). 9. 6. Na janela Propriedades. uma caixa de diálogo simples pode hospedar o controle. clique em Build Solution. 3. Adicione o seguinte código para o corpo do manipulador: Click(). 4. Para implementar a caixa diálogo DHTML 1. Para fins dessa explicação passo a passo. clique em Add. clique em Build Solution. 5. 3. uma caixa de diálogo DHTML simples será implementada.) no formulário principal do aplicativo Para exibir a caixa de diálogo DHTML 1. Clique duas vezes no DHTML Dialog botão. Você pode chamar a caixa de diálogo host controle pressionando o Control Host botão. Substituir o texto existente (que deve ser semelhante TODO: Place controls here).CMyCtlDlg dlg. clique duas vezes no IDR_HTML_MYDHTMLDLG item e clique na guia HTML no painel do projeto para 7. 6. o OK Clique com o botão direito do mouse o IDD_DIALOG2 formulário Caixa de diálogo e selecione Add Class Insira os seguintes valores: Class nameCMyDhtmlDlg Base classCDHtmlDialog Clique em Finish. dlg. 2. com This is the text content of my DHTML dialog box Como com o diálogo Host de controle implementado anteriormente. No menu de atalho. Remover esses são implementados em HTML nas etapas subseqüentes. Adicione o seguinte código para a função do manipulador: 2. No menu Debug.h da classe implementar a caixa de diálogo Controle host. exibir o formulário principal clicando duas vezes (localizada sob o nó de diálogo do arquivo de recurso para a MyProject Solução). 6. Do IDD_MYPROJECT_FORM no modo de exibição de recursos. 8. 9. e clique em Add Resource Clique no Dialog item e clique New para criar uma nova caixa de diálogo.DoModal( ). e Cancel Botões do modelo de diálogo. esta caixa de diálogo será exibida quando o usuário pressiona um botão (DHTML Dialog. contendo um controle de imagem que exibe um bitmap simples. 5. Implementar uma caixa de diálogo DHTML Outro recurso dos aplicativos cliente Rich é o uso de caixas de diálogo que utilizam HTML para a interface do usuário em vez de recursos diálogo tradicional. clique em Start Without Debugging. Adicione o código a seguir após a última #include Instrução no arquivo de origem atual: #include "MyCtlDlg. Acionam o evento personalizado Click clicando no botão esquerdo do mouse dentro do controle. editar o arquivo HTML associado. adicionada anteriormente. 3. o o Clique no modo de exibição de recursos. No modo de exibição de recursos. No menu Build.h" Isso inclui o arquivo. sob o nó HTML. Visual Studio 109 . 4. com o MyProject projeto. 5. você irá criar um serviço da Web XML simples projetado para ser executado em um servidor Web usando o Microsoft Internet Information Services (IIS). fornecendo um Rich front-end para um banco de dados existente ou bancos de dados. Essa rotina de validação é deliberadamente simples para ilustrar o conceito claramente. clique em Start Without Debugging. clique no ASP. Depois que a solução foi criada. Abra a MyProject Solução. Depois que o serviço da Web XML existir.asmx arquivo de origem. 4. 2. clique em uma Visual Basic Projects ou Visual C# Projects. 4.DoModal( ).h" Isso inclui o arquivo. No menu Debug. um aplicativo rich client interage com um serviço XML da Web externo.h da classe implementação caixa de diálogo DHTML. 6. string s2) { return s1 == s2. Criar a solução. Uma parte da serviços XML da Web comum consiste em verificar cada usuário do aplicativo.asmx. Nesta etapa. você pode implementar um método simples de validação.. Para obter mais informações sobre caixas de diálogo DHTML e um exemplo mais completo. clique em Build Solution. dlg. clique com o botão direito do mouse a Service1. clique em New. No menu File. Adicione o código a seguir após a última #include Instrução no arquivo de origem atual: #include "MyDhtmlDlg.cs superfície de design e selecione View Code Substituir o HelloWorld método da Web no final do arquivo com o código a seguir: ' Visual Basic <WebMethod()> Function Validate(ByVal s1 As String.NET Web Service ícone Na caixa Location. Após criar a solução. Para fazer isso. No painel tipos Project. consulte a CDHtmlDialog classe e a DHtmlExplore amostra. caixa de diálogo Abrir a caixa de diálogo DHTML pressionando o DHTML Dialog botão. e clique em Project A New Project caixa de diálogo será exibida. adicionar um método de validação ao Service1. Para criar o serviço da Web XML 1. 3. ByVal s2 As String) As Boolean Return s1 = s2 End Function // C# [WebMethod] public bool Validate(string s1. Para adicionar uma referência da Web para o aplicativo do cliente 1. } Depois você modificou o arquivo de origem. No menu Build. digite http://localhost/MyService. O usuário é então possam interagir com os dados de uma maneira familiarizado ou gráfica. e no painel Modelos. Visual Studio 110 . você pode adicionar e configurar uma referência da Web com caixa Add Web Reference de diálogo. Clique OK para fechar a caixa de diálogo e criar a solução. Criando e Consuming um serviço da Web XML existente Ocasionalmente.CMyDhtmlDlg dlg. Quando for exibida. s>Validate(CComBSTR(m_Name). selecione aquele que você acabou de criar uma lista de serviços XML da Web existente no (Service1). Clique duas vezes no IDD_DIALOG3 formulário Caixa de diálogo. Clique duas vezes no OK botão no formulário Caixa de diálogo. 3. 6. Service1::CService1 *s = new Service1::CService1(). um descrição do serviço será exibida no painel esquerdo e botão Add Reference será ativado. 10. 8. Na caixa Variable Name. bool result = false. 4.2. Para validar o usuário 1. 9. e clique em Add Resource Clique duas vezes no Dialog item. clique com o MyProject projeto e selecione Add Web Reference. UpdateData(TRUE). Clique em Finish. 5. com o MyProject projeto. &result). Em Browse to. você adicionará uma caixa de diálogo de validação para demonstrar a interação entre o aplicativo e o serviço da Web XML. 4. 6. 5. 4. No menu de atalho. CComBSTR(m_Password). No menu Category drop-down. o o Clique no modo de exibição de recursos. digite m_Name. No menu de atalho. Se o serviço da Web for encontrado. selecione Web services on the local machine. Clique com o botão direito do mouse na primeira Edit control. Insira os seguintes valores: Class nameCMyValidateDlg Base classCDialog Clique em Finish. 3. selecione Value. if (result) CDialog::OnOK(). ele deve aspecto como este: http://localhost/MyService/Service1. 2. Clique no Add Reference botão. Para adicionar uma caixa de diálogo de validação 1. O URL do arquivo. Adicione o seguinte código para a função do manipulador: Visual Studio 111 . Assim que a referência da Web for adicionada. clique em Add. Arraste dois Edit control controles para o IDD_DIALOG3 formulário Caixa de diálogo.asmx para o serviço da Web também deve aparecer na caixa URL da. Clique com o botão direito do mouse no segundo Edit control Controle. O assistente classe MFC aparece. A Add Web Reference caixa de diálogo será exibida. 7. Adicionar outra variável (chamada m_Password de categoria Value). A máquina local será exibido. 2. adicionar controles para fornecer um serviço de validação para o usuário.asmx 3. selecione Add Variable. Agora que a caixa diálogo foi criada. No Solution Explorer. Compilar uma solução. e no painel Modelos.h" Isso inclui o arquivo. clique em Add. Para implementar esse comportamento. if (dlg. clique no Setup Wizard ícone Digite MySetup o nome do projeto de instalação para e clique em OK. No menu de atalho. Para a rotina de validação para ser eficiente. 5. Visual Studio 112 . Para exibir a caixa de diálogo de validação inicialmente 1. No Explorer Solution. Adicione o código a seguir após a última #include Instrução no arquivo de origem atual: #include "WebService. No painel tipos Project. No menu Debug. 6. e clique em OK. Adicione o seguinte código antes que a chamada para a ShowWindow função do objeto pMainFrame: // Display the validation dialog box first CMyValidateDlg dlg. 5. clique com o botão direito do mouse a MyProject Solução. e clique em New Project A New Project caixa de diálogo será exibida.DoModal() != IDOK) return FALSE. No modo de classe.h" Isso inclui o arquivo.11.h do serviço da Web usado por caixa de diálogo de validação. 3. o usuário atual ser impedido de acessar o aplicativo rich client. clique em Build Solution. O Assistente para Instalação será exibido. Clique em Next duas vezes.h da caixa de diálogo de validação. 2. 4. 2. O aplicativo rich client será executada. selecione Setup and Deployment Projects. caixa de diálogo de validação deve ser o primeiro objeto Interface de usuário seja exibido. Será se um nome incorreto ou senha for inserida. exibindo sua caixa de diálogo principal. Criar um projeto de instalação A etapa final ao desenvolver seu aplicativo Visual C++ está criando um projeto de instalação. Clique duas vezes a InitInstance função para editar o corpo função. No menu Build. Na caixa de diálogo de verificação. Para criar um projeto de instalação 1. modifique a InitInstance função da classe do aplicativo principal para chamar esta caixa de diálogo primeiro. O aplicativo continua somente quando a caixa diálogo corretamente sai. clique em Start Without Debugging. 4. Se o usuário inserir o nome correto e a senha a aplicativo rich client serão exibidos. 3. expanda o CMyProjectApp nó. Adicione o código a seguir após a última #include Instrução no arquivo de origem atual: #include "MyValidateDlg. inserir o mesmo texto nas caixas de edição Nome e senha. o o Selecione os seguintes grupos de saída: Saída de MyProject principal Saída de CustomCtl principal Clique em Next duas vezes. e Walkthroughs de implantação Visual Studio 113 . 9. Clique em Finish No menu Build. consulte Implantar aplicativos. 7. Para obter mais informações sobre projetos de implantação e o Assistente para instalação.6. O arquivo resultante (MySetup) pode ser copiado para uma máquina de destino para instalação do aplicativo rich client. 8. clique em Build MySetup. Projetos de implantação. Uma introdução ao usar o depurador Visual Studio com páginas da Web. Uma introdução ao criar um componente de camada intermediária que torna dados disponível para páginas da Web. e usar outros recursos ASP.NET no Visual Web Developer Uma introdução ao criar um serviço da Web ASP. você aprenderá sobre a criação de sites.NET para definir um layout geral para páginas da Web. Uma introdução ao criar uma página da Web que usa Partes da Web para permitir que o usuário para personalizar o conteúdo e layout de uma página. Passo a passo: Ligação de dados em um objeto corporativo personalizado Passo-a-passo: Depuração de Páginas da Web no Visual Web Developer Passo-a-passo: Criando e Usando Páginas Mestras do ASP.NET no Visual Studio. criando um objeto comercial da camada intermediária.NET. Visual Studio 114 .NET e consumindo-lo de uma página da Web. Por trabalhar com essas orientações. Uma introdução a adicionar segurança logon em um site da Web. criar e editar páginas da Web.NET no Visual Web Developer Passo-a-passo: Personalizando um site usando temas no Visual Studio Passo-a-passo: Criando uma página do Web Parts no Visual Web Developer Uma introdução ao definir um aparência consistente para suas páginas da Web. Walkthrough Passo-a-passo: Criando uma página da Web básica no Visual Web Developer Passo-a-passo: Acesso a dados básico em páginas da Web Descrição Uma introdução ao criar páginas da Web ASP.NET. Uma introdução ao exibir dados em uma página da Web usando os controles da fonte de dados e o GridView controle. Uma introdução ao usar páginas mestras ASP. Passo a passo: Criando um site com associação e logon de usuário (Visual Studio) Passo a passo: Criando e usando um serviço da Web do ASP. conectando a fontes de dados.NET para personalizar os sites e páginas.Walkthroughs Application de formulários da Web O objetivo dessas orientações é para mostrar como criar um site da Web usando páginas da Web e controles ASP. A tabela a seguir lista uma seleção de orientações que fornecerá uma visão geral dos recursos ASP. consulte Introdução ao Controle de Origem. Para esta explicação passo a passo.NET Framework Criando um Site e Página Web Nesta parte da explicação passo a passo. Você também adicionará um texto HTML e executará a página no seu navegador Web. Adicionar controles. Para mais informações. você criará e executará sua página no sistema de arquivos local. Além disso. Em vez disso. No menu File. consulte Explicação Passo a Passo: Editando Sites Web com FTP no Visual Web Developer. adicionando controles e escrevendo código. Para criar um site Web do sistema de arquivos 1. ilustrando as técnicas básicas de criação de uma nova página.Explicação Passo a Passo: Criando uma Página Web Básica no Visual Web Developer Esta explicação passo a passo fornece uma introdução ao Microsoft Visual Web Developer. clique em Web site A caixa de diálogo New Web Site aparece como mostrado na screen shot a seguir. que armazena seus arquivos em uma subpasta da raiz do IIS local (normalmente. Um sistema de arquivos do site Web é um sistema que armazena páginas e outros arquivos em uma pasta que você escolhe em algum lugar em seu computador local. você criará um site Web e adicionará uma nova página a ele. Adicionar manipuladores de eventos. Um site remoto armazena arquivos em um servidor remoto que você pode acessar através de uma rede local. os arquivos do site Web podem ser armazenados em um sistema de controle de origem como o Visual SourceSafe. Criando uma página ASP. 2. As tarefas ilustradas nesta explicação passo a passo incluem: • • • • • • Criar um site Web do sistema de arquivos. Para mais informações. Pré-requisitos Para concluir esta explicação passo a passo. Abra o Visual Web Developer. \Inetpub\Wwwroot\). Um site FTP armazena arquivos em um servidor remoto que você acessa através da Internet.NET Single-File no Visual Web Developer. Visual Studio 115 . e em seguida. usando o File Transfer Protocol (FTP). Executar páginas com o Servidores Web em Visual Web Developer. Familiarizando-se com o Visual Web Developer. será necessário: • • Visual Web Developer O . aponte para New. Outras opções de site Web incluem um site Web do IIS local. Ela orienta você através da criação de uma página simples usando o Visual Web Developer. você criará um site Web do sistema de arquivos que não requer que você trabalhe com o Internet Information Services (IIS) da Microsoft. você pode usar vários idiomas no mesmo aplicativo Web. é útil você se familiarizar com o ambiente de desenvolvimento do Visual Web Developer. Exibem os documentos com os quais você está trabalhando em janelas com guias. por padrão. selecione a caixa File System e seguida. o Visual Web Developer exibe a página no modo Source. clique em Visual Basic ou Visual C#. que cria algumas pastas e alguns arquivos padrão. A ilustração a seguir mostra as janelas e ferramentas que estão disponíveis no Visual Web Developer. Quando você cria um site Web.) Barras de ferramentas. Exibe os arquivos e pastas em seu site Web. você especifica um modelo. Na lista Language. Janela de Documento. Fornecem comandos de formatação de texto. 4.NET Web Site.Caixa de diálogo New Web Site 3.aspx. 6. Entretanto. Modo Source de uma página padrão Um Tour do Visual Web Developer Antes de você prosseguir trabalhando na página. Janela de Propriedades. o o o o Visual Studio 116 . você está criando um site Web baseado no modelo ASP. localização de texto. Você pode alternar entre documentos clicando nas guias. Permite que você altere as configurações da página. somente as marcadas na ilustração anterior. (Nem todas as janelas e ferramentas que você vê são listadas aqui. Diagrama do ambiente Visual Web Developer Para se familiarizar com o designer da Web em Visual Web Developer • Examinar a ilustração anterior e corresponder o texto para a lista a seguir. Algumas barras de ferramentas ficão disponíveis somente quando você está trabalhando em modo Design. criando páginas e componentes em linguagens de programação diferentes 5. que descreve as janelas e ferramentas mais comumente usadas. Por exemplo. e assim por diante. Quando uma nova página é criada. digite o nome da pasta onde você deseja manter as páginas do seu site Web. Na caixa Location. A linguagem de programação que você escolher será o padrão para seu site Web. dos controles e de outros objetos. O Visual Web Developer cria a pasta e uma nova página chamada Default. Nesta explicação passo a passo. Clique em OK. digite o nome da pasta C:\BasicWebSite. Solution Explorer. O screen shot a seguir mostra o modo Source de uma página Web padrão. clique em ASP. dos elementos HTML. onde você pode ver os elementos HTML da página. Cada modelo cria um aplicativo Web que contém arquivos e pastas diferentes.NET Web Site. No Visual Studio installed templates. Fornece controles e elementos HTML que você pode arrastar para a sua página. Para adicionar uma página ao site Web 1. Caixa de Ferramentas. você irá criar e trabalhar com uma nova página. Se o Server Explorer não estiver visível no Visual Web Developer. 4. Visual Studio 117 . Você pode usar a página Default. Para fazer isso. Mostra diferentes modos de exibição do mesmo documento. no menu Tools. O menu View permite exibir janelas adicionais. Feche a página Default. clique em Other Windows. 5. para esta explicação passo a passo. Na Solution Explorer. no menu View.NET (página Web Forms) chamada Default. o Visual Web Developer adiciona uma página do ASP.NET pode ser localizado na página ou em um arquivo de classe separado. Observação Você pode reorganizar e redimensionar as janelas para atender suas preferências. selecione o nó HTML Designer e altere a opção Start Pages In. clique com o botão direito do mouse o site Web (por exemplo. Server Explorer/Database Explorer. A screen shot a seguir mostra a caixa de diálogo Add New Item. Modo Source é o editor HTML para a página. Entretanto. Entretanto. 3. 6. clique com o botão direito do mouse na guia que contém o nome de arquivo e selecione Close.aspx como a home page para o seu site Web. Na lista Language. ou J#). consulte Explicação Passo a Passo: Criando uma Página Web Básica com Separação de Código no Visual Web Developer. você pode alterar a linguagem. Para saber mais sobre como manter o código em um arquivo separado. Exibe conexões de banco de dados. O código para páginas do ASP. 2. Na caixa Name. Os elementos da caixa de ferramentas são agrupados por função em comum. você está criando uma página single-file com o código e HTML na mesma página. Modo Design é uma superfície de edição próxima ao WYSIWYG.o Guias de Exibição.aspx. No Visual Studio installed templates. Você trabalhará com esses modos posteriormente nesta explicação passo a passo. sempre que você cria um nova página ou um componente para o seu site Web. clique em Options. Quando você cria o site Web. C#. você especifica uma linguagem padrão. Caixa de Diálogo Add New Item Nesta explicação passo a passo. clique em Web Form. C:\BasicWebSite). Se você preferir abrir as páginas Web em modo Design. e clique em Server Explorer. e clique em Add New Item.aspx. Você pode usar linguagens de programação diferentes no mesmo site Web. escolha a linguagem de programação que você prefere usar (Visual Basic. o o Criando uma Nova Página Web Forms Quando você cria um novo site Web. digite FirstWebPage. Desmarque a caixa de seleção Place code in separate file. você usa o IIS como seu servidor Web. você pode tentar executá-la. a página está em branco. digite Bem-vindo ao Visual Web Developer. Na parte inferior da janela de documento. como mostrado na seguinte screen shot. você pode usar o Servidor de Desenvolvimento do ASP. A screen shot a seguir mostra o texto que você digitou no modo Design.7. clique na guia Design para alternar para o modo Design. você irá adicionar algum texto estático para a página. Um ícone aparece na barra de ferramentas para indicar que o servidor Web Visual Web Developer está sendo executado. então. como mostrado na seguinte screen shot. Embora a página que você criou tenha uma extensão . que é executado localmente e não requer o IIS. Nesse ponto. Pressione CTRL+F5 para executar a página.NET. ela atualmente executa como qualquer página HTML. O texto de boas vindas como visto no modo Design 3. Observação Visual Studio 118 . o servidor Web padrão no Visual Web Developer é o Servidor de Desenvolvimento do ASP. O Visual Web Developer cria a nova página e a abre no modo Source.NET. O modo Design exibe a página com a qual você está trabalhando de uma maneira WYSIWYG. O Visual Web Developer inicia o Servidor de Desenvolvimento do ASP. Alterne para modo Source.NET. Ícone do Servidor Visual Web Developer A página é exibida no navegador. Clique em Add. você não tem qualquer texto ou controles na página. é necessário um servidor Web. Para executar a página 1. digitando no modo Design. Entretanto. 2. O texto de boas vindas como visto no modo Source Executando a Página Antes de prosseguir com a adição de controles para a página. Adicionando HTML à página Nesta parte da explicação passo a passo. Para executar uma página. Para os sites Web do sistema de arquivos.aspx. Em um site Web de produção. para testar uma página. Você pode ver o HTML que você criou. Na página. Para adicionar texto para a página 1. você deve configurar seu navegador para ignorar os servidores proxy para solicitações locais. você irá definir as propriedades em modo Design e em modo Source. Entretanto. Você pode misturar HTML estático e controles de servidor na mesma página. Pressione SHIFT+ENTER algumas vezes para criar um pouco de espaço. conforme mostrado na screen shot a seguir. caixas de texto e outros controles familiares. Feche o navegador.NET.Se o navegador exibe um erro 502 ou um erro indicando que a página não pode ser exibida. consulte COMO: Ignorar um Servidor proxy para Solicitações Web Locais. digite Entre com o seu nome:. Os controles do servidor. Agora você irá adicionar os controles do servidor na página. um controle Toolbox e um controle Label. As propriedades do controle são declaradas como atributos. TextBox e Label para a página e gravar o código para manipular o evento Click para o controle Button. Para adicionar controles para a página 1. 2. quando você define a propriedade Text para o controle Button. O modo de exibição Source exibe o HTML para a página. O screen shot a seguir mostra como os três controles aparecem no modo Design. Selecione o controle Button e na janela Properties. você pode programar os controles com código que é executado no servidor. Para definir as propriedades de controle 1. No TextBox. Texto do Controle Button Alterado 2. rótulos. fornecem capacidades típicas para processamento de formulários para suas páginas Web do ASP. Visual Studio 119 . você irá adicionar os controles Button. na etapa 1. Nesta parte da explicação passo a passo. a partir do grupo Standard. incluindo os elementos que o Visual Web Developer criou para os controles do servidor. não no cliente. Alterne para modo Source. 4. 2. Esse texto HTML estático é a legenda do controle TextBox. Controles no Modo de Exibição Design Definindo as Propriedades do Controle O Visual Web Developer oferece várias maneiras para definir as propriedades dos controles na página. 3. Os controles são declarados usando sintaxe do tipo HTML. você realmente definiu o atributo Text na marcação do controle. Adicionando e Programação Controles Nesta parte da explicação. que incluem botões. Coloque o ponto de inserção acima do controle TextBox e em seguida. defina Text para Display Name. Clique na guia Design para alternar para modo Design. exceto as marcas que usam o prefixo asp: e incluem o atributo runat="server". arraste três controles para a página: um controle Label. Por exemplo. Para obter detalhes. conforme mostrado a screen shot a seguir. pressionando CTRL+J. 2.Observe que todos os controles estão dentro de um elemento <form> que também tem o atributo runat="server". Observação Clicar duas vezes em um controle em modo Design é apenas uma das várias maneiras para você poder criar os manipuladores de eventos. Programando o Controle Button Para esta explicação passo a passo. você irá escrever um código que lê o nome que o usuário insere na caixa de texto e exibe o nome no controle Label. O Visual Web Developer exibirá uma lista dos membros disponíveis para o controle Label. O Visual Web Developer alterna para o modo Source e cria um esqueleto de manipulador de eventos para o evento padrão do controle Button. O IntelliSense exibe uma lista de cores. O atributo ForeColor é concluído com a cor que você selecionou. Membros disponíveis do controle Label Visual Studio 120 . e pressione SPACEBAR. conhecido como IntelliSense. digite o seguinte: Label1. Observação Você pode exibir uma lista suspensa do IntelliSense a qualquer momento.NET no lado do servidor quando a página é executada. Alternar para o modo Design. Dentro do manipulador. Código fora dos elementos <form runat="server"> e <script runat="server"> é interpretado pelo navegador como código do cliente. Esse recurso. O atributo runat="server" e o prefixo asp: para controle de marcas marcam os controles para que eles sejam processados pelo ASP. Uma lista suspensa aparece para mostrar a lista de propriedades que você pode definir para o controle Label. Selecione uma cor para o texto do controle Label. Clique duas vezes no controle Button. A screen shot a seguir mostra a lista suspensa do IntelliSense para o controle Label. O IntelliSense para o controle Label 4. 3. Selecione ForeColor e digite um sinal de igualdade (=). Para adicionar um manipulador de eventos padrão para o controle button 1. Coloque o ponto de inserção em um espaço dentro da guia <asp:label>. o evento Click. elementos HTML e outros itens na página. 3. ajuda você no modo Source com a sintaxe dos controles de servidor. 5. Observe que quando você clica no botão. Observação Se você estiver usando o Visual Basic com separação de código. exiba o fonte da página que você estiver executando. você vê somente HTML comum. O ponto importante é que o nome usado para o atributo OnClick deve corresponder ao nome de um método na página. C# protected void Button1_Click(object sender. Este atributo vincula o evento Click do botão para o método do manipulador que você codificou na etapa 4. e em seguida. Os métodos do manipulador de eventos podem ter qualquer nome. System. você não vê os elementos <asp:> com os quais você estava trabalhando no modo Source. No código fonte da página. a página é remetida para o servidor Web.NET recria a página. O nome que você inseriu é exibido no controle Label. Em vez disso. o ASP. Executando a Página Agora você pode testar os controles do servidor na página. Por exemplo. envia a nova página para o navegador. Role para baixo até o elemento <asp:Button>. Feche o navegador. Concluir o manipulador de evento Click para o botão para que ele apareça como mostrado no exemplo de código a seguir.NET. 4. o controle <asp:Button> é processado como o elemento HTML <input type="submit">. Quando a página é executada. No navegador.4. Trabalhando com Controles Adicionais Visual Studio 121 . o nome que você vê é o nome padrão criado pelo Visual Web Developer.NET processa os controles do servidor e processa os elementos HTML da página que executa as funções que representam o controle. o evento é acoplado ao método do manipulador usando uma palavra-chave Handles na própria declaração do manipulador. o Visual Web Developer não adiciona um atributo OnClick explícito. Digite um nome para a caixa de texto e clique o botão. } 5. executa o manipulador de eventos Click do controle Button).Text + ". welcome to Visual Web Developer!". Pressione CTRL+F5 para executar a página no navegador. você pode ver que a página está fazendo uma chamadapara o servidor Web sempre que você clicar no botão. Observe que o elemento <asp:Button> agora tem o atributo OnClick="Button1_Click".EventArgs e) { Label1. 3. A página novamente executa usando o Servidor de Desenvolvimento do ASP. executa o seu código (neste caso.Text = TextBox1. 2. O ASP. Se você observar a barra de status do navegador. Para executar a página 1. Nesta parte da explicação . como <WeekEndDayStyle>. A partir da lista suspensa da direita. O controle Calendar é um controle mais complexo que o botão. selecione Calendar1. 2. A lista suspensa exibe uma lista de todos os objetos para os quais você pode escrever código. selecione SelectionChanged. Nesta seção. O painel exibe comandos que facilitam a execução das tarefas mais comuns para o controle selecionado. 2. você adicionará um controle Calendar na página e o formatará. A partir da seção Standard do Toolbox. que exibe as datas de um mês ao mesmo tempo. O Visual Web Developer cria um esqueleto de manipulador de eventos para o evento SelectionChanged do controle Calendar. selecione Simple e em seguida. você programará o controle Calendar para exibir a data selecionada atualmente. Ele também inclui subelementos. A screen shot a seguir mostra o controle Calendar como processado no modo Design. Visual Studio 122 . A caixa de diálogo Auto Format é exibida. que representam várias configurações de formatação. Controle Calendar em modo Source Programando o Controle Calendar Nesta seção. alterne para modo Design. Controle Calender no modo Design 3. escolha Auto Format. A screen shot a seguir mostra o controle Calendar no modo Source. a caixa de texto e o rótulo com os quais você tem trabalhado e ilustra alguns recursos adicionais dos controles do servidor. Este elemento é muito maior que os elementos para os controles simples que você criou anteriormente. Para adicionar um controle Calendar 1. Para programar o controle Calendar 1. Em Visual Web Developer. Na lista Select a scheme. 5. clique em OK Alterne para modo Source. permitindo que você selecione um esquema de formatação para o calendário. A screen shot a seguir mostra a caixa de diálogo Auto Format para o controle Calendar. você trabalhará com o controle Calendar. A partir da lista suspensa da esquerda no topo do modo Source. arraste um controle Calendar para a página: O painel de marca inteligente do calendário é exibido. No painel de marca inteligente. Você pode ver o elemento <asp:Calendar>. Caixa de Diálogo Auto Format para o controle Calendar 4. Feche o navegador. Criar páginas Web que são especificamente projetadas para telefones celulares e outros dispositivos. consulte Explicação Passo a Passo: Criando e Usando Páginas Mestra do ASP.ToString(). Criar um layout de site consistente usando páginas mestra. Concluir o manipulador de evento SelectionChanged com o seguinte código destacado. Adicionar acesso de dados para as páginas Web. Observe que o controle Calendar tem sido processado para a página como uma tabela.Agora você já viu duas maneiras para criar um manipulador de eventos para controles. Para obter detalhes.EventArgs e) { Label1. O primeiro foi clicar duas vezes o controle no modo Design. Próximas Etapas Esta explicação ilustra os recursos básicos do designer da página do Visual Web Developer. • • • • • Visual Studio 123 . Para obter detalhes. exibir o código fonte para a página. Para executar a página 1. 2. consulte Explicação Passo a Passo: depuração de páginas Web no Visual Web Developer. O segundo é usar as listas suspensas em modo Source para selecionar um objeto e o evento para o qual escrever o código. Para obter detalhes. consulte Explicação Passo a Passo: Criando Páginas Web para Dispositivos Móveis. consulte Explicação Passo a Passo: Acesso de Dados Básicos em Páginas Web. No navegador. consulte Explicação Passo a Passo: Edição de HTML Básica no Visual Web Developer. } Executando a Página Agora você pode testar o calendário. Pressione CTRL+F5 para executar a página no navegador. você pode querer: • Aprender mais sobre como editar HTML no Visual Web Developer. C# protected void Calendar1_SelectionChanged(object sender. 3.NET em Visual Web Developer.Text = Calendar1. 4. A data que você clicou é exibida no controle Label. Clique em uma data no calendário. consulte Explicação Passo a Passo: Adicionando Navegação de Site para um Site Web. Adicionar navegação ao seu site para que os usuários possam facilmente se mover entre as páginas. 3. Para obter detalhes. Agora que você entende como criar e editar uma página Web no Visual Web Developer. você pode querer explorar outros recursos. System. Aprenda sobre o depurador para páginas da Web. Para obter detalhes. com cada dia como um elemento <td> contendo um elemento <a>. Para obter detalhes. Por exemplo.SelectedDate. crie um novo site e página seguindo estas etapas. Configurar o controle GridView para permitir a classificação e paginação. 3. clique em ASP. A caixa de diálogo New Web Site aparece. Caso contrário. Se o banco de dados Northwind não estiver no mesmo computador do servidor web. consulte Centro de Desenvolvimento de Acesso e Armazenamento de Dados. Durante este passo-a-passo. Se você estiver usando o Microsoft Windows XP ou Windows Server 2003.7 ou posterior. clique em New Web Site. Entretanto. Criar uma consulta filtrada que exibe somente registros selecionados. Abra o Visual Web Developer. Visual Studio 124 . se você estiver usando o Microsoft Windows 2000. Em Visual Studio installed templates.7. No menu File. será necessário o seguinte: • • Acesso ao o banco de dados SQL Server Northwind. você aprenderá a fazer o seguinte: • • • • • • Conectar-se a um banco de dados do Microsoft SQL Server na ferramenta de desenvolvimento da web. Exibir dados com o controle GridView. 2.NET Web Site. • Microsoft Data Access Components (MDAC) versão 2. você pode atualizar o MDAC que já está instalado no o computador. Usar o controle SqlDataSource para gerenciar o acesso a dados e vinculação. o Microsoft Visual Web Developer. Para fazer o download da versão atual do MDAC. Criando o site da web Se você já criou um site no Visual Web Developer completando o Passo-a-passo: Criando uma Página da Web Básica no Visual Web Developer. Pré-requisitos Para concluir este passo-a-passo. você pode usar esse site e ir para a próxima seção. contate o administrador do servidor. Para criar um site do sistema de arquivos 1. Usar edição arrastar-e-soltar para criar elementos de acesso a dados que podem ser usados na página sem código. você deve ter um nome de usuário e senha para uma conta de usuário do SQL Server que tenha acesso ao banco de dados Northwind Observação Se você precisar de informações sobre como efetuar login no SQL Server.Passo-a-passo: Acesso a Dados Básico em Páginas da Web Este passo-a-passo mostra como como criar uma página simples com dados vinculados usando controles que são especialmente criados para acesso a dados. você já tem MDAC 2. é necessário o seguinte: • Uma conexão com uma fonte de dados (como um banco de dados). Na lista Language. A caixa de diálogo Data Source Configuration aparece. 4. insira o nome da pasta onde você deseja manter as páginas do site Por exemplo. Na caixa Location mais a direita. Para adicionar e configurar um controle GridView para exibir dados 1. Clique em OK. 2.4. em Choose Data Source list. e usando assistentes para criar a conexão e o controle da fonte de dados.aspx. digite o nome de pasta C:\WebSites. arraste um controle GridView para a página. alterne para o modo de exibição Design. clique na linguagem de programação que preferir trabalhar. Você pode adicionar esses elementos para o site separadamente.NET. No procedimento a seguir. 3. No seguinte procedimento. clique com o botão direito do mouse no controle GridView e clique em Show Smart Tag. você criará uma conexão com o banco de dados SQL Server Northwind. que executa consultas e gerencia os resultados de consultas. No menu GridView Tasks. Da pasta Data em Toolbox. clique em <New data source>. No entanto. Se o o menu de atalho GridView Tasks não for exibido. Um controle na página para exibir os dados realmente. O controle GridView receberá seus dados a partir do controle SqlDataSource. No Visual Web Developer. Visual Studio 125 . 5. O procedimento a seguir explica como criar todos os três elementos que você deve ter para exibir dados na página. você irá exibir dados em um controle GridView. O Visual Web Developer cria a pasta e uma nova página chamada Default. • • Um controle da fonte de dados na página. é mais fácil começar a visualizando a exibição de dados usando o controleGridView. Adicionando um Controle GridView para Exibir Dados Para exibir dados em um página da web do ASP. 6. Isso especifica que você deseja obter dados de um banco de dados que suporte instruções SQL. Você pode deixar esse nome.5. Clique em Database. Na caixa Specify an ID for the data source. Clique em OK. exibindo uma página na qual você pode escolher uma conexão. O Wizard Configure Data Source aparecerá. Visual Studio 126 . um nome controle da fonte de dados padrão aparece (SqlDataSource1). Isso inclui o SQL Server e outros OLE-DB – bancos de dados compatíveis. 6. clique em Microsoft SQL Server e clique emContinue. 9. em Data source.7. A caixa de diálogo Add Connection aparece. Visual Studio 127 . digite o nome do SQL Server que você deseja usar. 8. Clique em New Connection. Na caixa de diálogo Choose Data Source. Na caixa Server name . 2. É mais seguro do que armazenar a seqüência de conexão na página. (Você pode deixar o nome de seqüência de conexão padrão NorthwindConnectionString. e clique em Next.) Visual Studio 128 . Para as credenciais de login. e digite Northwind. exibindo uma página onde você pode escolher armazenar a seqüência de conexão no arquivo de configuração. 14.10. 13.<DataSourceName> aparece e as informações de conexão são preenchido. digite um nome de usuário e senha. 11. O assistente Configure Data Source . Clique em Next. clique em OK. Certifique-se de que a caixa de seleção Yes. Clique em Select or enter a database name. save this connection as esteja selecionada. O assistente aparecerá. quando você tiver certeza que ele funciona. 12. Clique em Test connection e. Armazenar a seqüência de conexão no arquivo de configuração tem duas vantagens: 1. selecione a opção que seja apropriada para acessar o banco de dados do SQL Server (segurança integrada ou ID específico e senha) e se for necessário. Você pode reutilizar a mesma seqüência de conexão em várias páginas. CompanyName e City check boxes. O assistente aparecerá. 15. Observação O assistente permite que você especifique critérios de seleção (uma cláusula WHERE) e outras opções de consulta SQL. que incorpora as informações de conexão e consulta que você especificou. 16. clique em Customers. exibindo uma página na qual você pode especificar os dados que você deseja buscar do banco de dados. Clique em Finish. selecione o CustomerID. Para esta parte do passo-a-passo. na lista Name. você vai criar uma declaração simples sem seleção ou opções de classificação.O assistente aparecerá. Clique em Test Query para certificar-se que está buscando os dados que você deseja. Clique em Next. 17. exibindo a Instrução SQL que você está criando em uma caixa na parte inferior da página. O assitente fecha e você retornado para a página. 19. 18. Em Columns. Executar o assistente realizou duas tarefas: o O assistente criou e configurou um controle SqlDataSource (chamado SqlDataSource1). Visual Studio 129 . Em Specify columns from a table or view. Adicionando Classificação e Paginação Você pode adicionar classificação e paginação no controle GridView sem escrever nenhum código. Pressione CTRL+F5 para executar a página. Opcionalmente. Um rodapé é adicionado ao controle GridView com links de número página. selecione Enable Paging check box. 4. No menu GridView Tasks. 2. Feche o navegador. Se você exibir as propriedades para o controle SqlDataSource. Será possível clicar em uma coluna título para classificar pelos conteúdos dessa coluna. Portanto. Os títulos de colunas no controle GridView alteram para vínculos. No modo de exibição Design. Visual Studio 130 .o O assistente acoplou o controle GridView para o SqlDataSource. Para testar a página 1. clique com o botão direito do mouse no controle GridView e clique em Show Smart Tag. Observação Você pode facilmente alterar o aspecto do controle GridView. Para adicionar classificação e paginação 1. clique em Auto Format e aplique um esquema. o controle GridView exibirá dados que são retornados pelo controle SqlDataSource. use Properties para alterar o valor da propriedade PageSize de 10 para um tamanho de página menor. Se há mais registros na fonte de dados do que o tamanho da página. do controle GridView. Pressione CTRL+F5 para executar a página. você poderá usar os links de navegação de página na parte inferior do controle GridView para mover entre páginas. No menu GridView Tasks. No modo de exibição Design. Nesta parte do passo-a-passo. A página aparece no navegador. 5. clique com o botão direito do mouse no controle GridView e clique emShow Smart Tag. 6. Testando a página Agora você pode executar a página. O controle GridView exibe todas as linhas de dados da tabela Customers. você verá que o assistente criou valores para as propriedades ConnectionString e SelectQuery. você modificará a consulta para o controle SqlDataSource para que os usuários possam selecionar registros de clientes para uma cidade específica. Adicionando filtragem Com freqüência você deseja exibir somente dados selecionados na página. selecione Enable Sorting check box. No menu de atalho GridView Tasks. Feche o navegador. 3. 2. Em Propriedades. arraste um controle TextBox e um controle Button para a página. O assistente Configure Data Source .Primeiro. Quando você tiver terminado com essa parte do passo-a-passo.<Datasourcename> aparece. você criará um elemento de parâmetro para o controle SqlDataSource. definida ID como textCity. a página será semelhante a este procedimento no modo de exibição Design. Em Properties para o controle Button. da caixa de texto. Agora você pode modificar a consulta para incluir um filtro. 2. Para adicionar a caixa de texto para especificar uma cidade 1. 3. você usará um controle TextBox para criar um caixa de texto na qual os usuários poderão digitar o nome de uma cidade. 4. Clique em Next. digite City ou texto semelhante antes da caixa de texto atuar como uma legenda. A partir do grupo Standard em Toolbox. clique em Configure Data Source. O controle Button é usado somente para enviar a página para o servidor. definida Text como Submit. Em seguida. Se você desejar. 3. O elemento de parâmetro estabelece como o controle SqlDataSource obterá o valor para sua consulta com parametrizada — nomeada. 2. Visual Studio 131 . Você não precisará escrever qualquer código para ele. O assistente exibe o comando SQL que está atualmente configurado para o controle SqlDataSource. Como parte desse processo. Clique com o botão direito do mouse no controle SqlDataSource e clique em Show Smart Tag. Para modificar a consulta com um filtro parametrizados 1. alterará a consulta para incluir um filtro parametrizado (cláusula WHERE). No menu SqlDataSource Tasks. para o controle TextBox. que solicita a você um valor para usar na cláusula WHERE. O assistente aparecerá. clique em textCity. Aparecerá a página Add WHERE Clause.<DataSourceName>. 12. Os registros de clientes de London aparecem. Na lista Column. 6. exibindo a página Parameter Values Editor. 7. Visual Studio 132 . clique em Next. Clique em Add. Clique em WHERE. clique em Test Query. Agora você pode testar a filtragem. 10. 11. Na página Test Query. clique em Control. Clique em Finish para fechar o assistente. 5. 13. clique em City. As cinco etapas anteriores especificam que a consulta obterá o valor de pesquisa para City a partir do controle TextBox adicionado mo procedimento anterior. Na lista Operator. Em Parameter properties. No assistente Configure Data Source . Na lista Source. Clique em OK para fechar a página Add WHERE Clause. A cláusula WHERE que você criou aparecerá em uma caixa na parte inferior da página. clique em =. digite London e clique em OK. 8.4. Na caixa Value. 14. 9. na lista Control ID. Por exemplo. Uma lista de clientes da City of London aparecerá no controle GridView. 2. consulte Passo-a-passo: Criando Páginas da Web Master/Detail no Visual Studio. Na o caixa de texto. Para obter informações detalhadas. consulte Passo-a-passo: Editando e Inserindo Dados em Páginas da Web com o Controle DetailsView Web Server. Para obter informações detalhadas. 3. consulte Passo-a-passo: Vinculação de Dados para um Objeto Business Personalizado. Você pode testar outros recursos adicionais do acesso a dados. digite London. • Trabalhar com registros que tenham um relacionamento master-detail. Para obter informações detalhadas. como Buenos Aires e Berlin. Pressione CTRL+F5 para executar a página. Próximas etapas Acesso a dados é uma parte importante em vários aplicativos da web. Tente outras cidades. • Editar e inserir registros. Visual Studio 133 . consulte Passo-a-passo: Criando uma Página da Web para Exibir Dados de Banco de Dados do Access. Para obter informações detalhadas. convém fazer o seguinte: • Trabalhar com o Microsoft Access em vez do SQL Server (Você não pode usar dependência de cache SQL com o Access). este passoa-passo forneceu somente uma amostra do que você pode fazer com dados em páginas da web. e o usa como fonte de dados em uma página..Para testar a filtragem 1. • Criar um componente middle-tier (comercial) que executa acesso a dados. e clique em Submit. O Microsoft Visual Web Developer inclui um assistente que ajuda você a criar um componente de dados que você pode usar como um objeto de dados de camada do meio. clique em ASP. Acoplar um controle para os dados retornados pelo objeto corporativo. Entretanto. 2. 4. Por exemplo. Em Visual Studio installed templates. Criar um objeto corporativo personalizado permite que você implemente suas próprias lógicas corporativa." Caso contrário. você aprenderá como: • • • • Criar um componente que pode retornar dados para um página da Web.NET. com um ou mais componentes contidos na camada no meio para fornecer acesso a dados. O componente usa um arquivo XML para seus dados. Para criar um site do sistema de arquivos 1. 3. "Criando um arquivo XML para dados Corporativos.Passo-a-passo: Ligação de dados para um objeto corporativo personalizado Muitos aplicativos da Web são criados usando várias camadas.NET Framework. em vez contar com o componente de dados criado pelo o assistente. você também pode desejar criar um objeto corporativo personalizado. Abra o Visual Web Developer. Ler e gravar dados. clique em New Web Site. Esta explicação passo a passo presume que você tenha uma compreensão geral de como usar o Visual Web Developer. você pode usar esse site e vá para a próxima seção. seguindo as etapas no Passo-a-passo: Criando uma página da Web básica em Visual Web Developer). usando o objeto corporativo. Na caixa Location. Visual Studio 134 . Fazer referência a objeto corporativo como uma fonte de dados em uma página da Web. será necessário: • • Visual Web Developer (Visual Studio). digite o C:\WebSites nome da pasta. Pré-requisitos Para concluir esta explicação passo a passo. A caixa de diálogo New Web Site aparece. conforme descrito em Passo-a-passo: Ligação de dados de páginas da Web com um componente de dados do Visual Studio.NET Web Site. No menu File. Esta explicação passo a passo ilustra como criar um objeto corporativo básico que você pode usar como uma fonte de dados para páginas da Web do ASP. Criando o site da Web Se já tiver criado um site no Visual Web Developer (por exemplo. insira o nome da pasta onde você deseja manter as páginas do seu site. Durante esta explicação passo a passo. crie um novo site e página seguindo estas etapas. O . org/dsPubs. sobrescrevendo o que já estiver no arquivo. Na caixa Name.tempuri. O arquivo XML inclui informações de esquema que identifica a estrutura do banco de dados dos dados.aspx. e cole-o para o arquivo. Esta explicação passo a passo usa um arquivo XML.tempuri. Na lista Language.tempuri. digite Authors. 2. 6.//mstns:authors" /> <xs:field xpath="mstns:au_id" /> </xs:unique> </xs:element> </xs:schema> <authors> Visual Studio 135 . O Visual Web Developer cria a pasta e uma nova página chamada Default. você criará um arquivo XML simples para os dados de componentes Business. Um novo arquivo XML é criado que contém somente a diretiva XML. clique com o botão direito do mouse App_Data. Em Visual Studio installed templates. Para criar o arquivo XML 1. No Solution Explorer.org/dsPubs.0" standalone="yes"?> <dsPubs xmlns="http://www.xsd" xmlns:mstns="http://www. incluindo uma restrição de chave primária para a chave. Copie os seguintes dados XML.5. <?xml version="1.xml.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" attributeFormDefault="qualified" elementFormDefault="qualified"> <xs:element name="dsPubs" msdata:IsDataSet="true"> <xs:complexType> <xs:choice minOccurs="0" maxOccurs="unbounded"> <xs:element name="authors"> <xs:complexType> <xs:sequence> <xs:element name="au_id" type="xs:string" /> <xs:element name="au_lname" type="xs:string" /> <xs:element name="au_fname" type="xs:string" /> <xs:element name="au_phone" type="xs:string" /> </xs:sequence> </xs:complexType> </xs:element> </xs:choice> </xs:complexType> <xs:unique name="Constraint1" msdata:PrimaryKey="true"> <xs:selector xpath=".w3. clique em XML file. Criando um arquivo XML para dados corporativos No procedimento a seguir. Observação Componentes Business podem trabalhar com dados em qualquer forma que seja adequada para seu aplicativo.tempuri. Observação Certifique-se de que você criou o arquivo XML na pasta App_Data.org/dsPubs.xsd" xmlns:xs="http://www. 5. e então clique em Add New Item. 3.xsd" xmlns="http://www. Clique em Add. clique na linguagem de programação que você preferir trabalhar.org/dsPubs.xsd"> <xs:schema id="dsPubs" targetNamespace="http://www. A pasta App_Data tem as permissões definidas sobre ela que permitirá que a página da Web leia e grave dados para o arquivo XML. Clique em OK. 4. Web. Copie o seguinte código. e cole-o para o arquivo. e em seguida. Em Visual Studio installed templates. clique em Class. Clique em Add. sobrescrevendo o que já estiver no arquivo.<au_id>172-32-1176</au_id> <au_lname>West</au_lname> <au_fname>Paul</au_fname> <au_phone>408 555-0123</au_phone> </authors> <authors> <au_id>213-46-8915</au_id> <au_lname>Gray</au_lname> <au_fname>Chris</au_fname> <au_phone>415 5550120</au_phone> </authors> </dsPubs> 6. na pasta App_Code e clique Add New Item.ReadXml (filePath. 3.Server. 5. 6. Criando um componente A próxima etapa é para criar uma classe para atuar como o seu componente de negócios. você deve criar uma. incluindo o cache global de assemblies.Data. e feche-o. A caixa de diálogo Add New Item aparece. Na caixa Language. private String filePath = HttpContext. } public DataSet GetAuthors () { return dsAuthors. } } } Visual Studio 136 . digite BusinessObject. 7. Em um aplicativo real. namespace PubsClasses { public class AuthorClass { private DataSet dsAuthors = new DataSet("ds1").MapPath ("~/App_Data/Authors. 4. Na caixa Name.Current. XmlReadMode. clique com o botão direito do mouse. Para criar uma pasta App_Code • No Solution Explorer.ReadSchema). clique em App_Code.xml. Observação Certifique-se de criar o novo item na pasta App_Code.xml"). using System. using System. O Visual Web Developer cria o novo arquivo de classe e abre o editor de códigos. Agora você poderá adicionar o componente ao seu site. clique Add ASP. C# using System. public AuthorClass() { dsAuthors. Salve o arquivo Authors. Para criar o componente Business 1. Se seu site não tiver uma pasta chamada App_Code.NET Folder. Observação A pasta deve ser nomeada App_Code. Você irá manter o componente na pasta App_Code do site da Web. clique com o botão direito do mouse no nome de seu site. Na Solution Explorer. você pode manter o componente em qualquer armazenamento conveniente. 2. clique na linguagem de programação que você preferir. aspx. clique com o botão direito do mouse no nome do site. Quando uma instância da classe é criada. clique PubsClasses. Exibindo dados usando o componente Business Você pode chamar o componente Business em uma página da Web e exibir seus dados. ele lê o arquivo XML e converte em um DataSet. No Toolbox. Clique com o botão direito do mouse no controle ObjectDataSource e em seguida. e adicione. 8. 5. 6. a partir da pasta Data. Ele retorna um DataSet contendo os dados do arquivo Authors. você pode adicionar uma nova página para o site. returns Dataset. O assistente Configure Data Source aparece. A classe do método GetAuthors retorna o DataSet. Na lista Choose your business object. clique em Add New Item. 8. Para criar um controle ObjectDataSource que referencia o componente 1. clique em GetAuthors(). Alterne para modo Design. na lista Choose a method. Clique em Finish. O método GetAuthors é definido na classe Business criada anteriormente. Observação Se você não tem uma página Default. clique na marca inteligente para exibir o Menu ObjectDataSource Tasks. Para referenciar o componente. que está especificamente projetado para trabalhar com objetos. No Solution Explorer. Como alternativa. Alterne para ou abra a página Default. definida ID como AuthorsObjectDataSource. 7. um Web Form 2. No menu ObjectDataSource Tasks. Na guia Select.AuthorClass. você pode usar outra página. Agora você pode obter dados do componente usando o controle ObjectDataSource. 4. use um controle ObjectDataSource. clique em Configure Data Source. 3. Você irá exibir os dados em um controle GridView na página. o método GetAuthors do componente deve ser chamado. As informações de configuração que você inseriu especificam que para obter dados do componente.aspx. Na janela Properties. Salve o arquivo. Visual Studio 137 . arraste um controle ObjectDataSource para dentro da página. Você deve salvar o arquivo para que a próxima seção funcione corretamente. 10. 9.xml.Observação Certifique-se de que o valor da variável filePath referencia o nome do arquivo XML que você criou anteriormente. Clique em Next. que você irá fornecer na página como parâmetros.Rows. workRow. au_fname ). Pressione CTRL+F5 para executar a página.Add (workRow). String au_lname. 3. XmlWriteMode. como o Controle SqlDataSource . No menu Common GridView Tasks. workRow. É importante que o aplicativo tenha permissão para gravar no arquivo em tempo de execução ou a página da Web exibirá um erro quando você tentar atualizar o arquivo. Inserindo dados usando o componente Business Como em outros controles de fonte de dados. } Observação Preste atenção para os nomes das variáveis usadas para passar informações do autor para o método Close (au_id.XML na pasta App_Data. arraste um controle GridView para a página. Adicione o seguinte método como o membro final do AuthorClass.BeginEdit (). dsAuthors. na caixa Choose Data Source. 3.xml que você criou anteriormente será atualizado. O método cria uma nova linha no DataSet. atualizar e excluir). você irá alterar a página para que os usuários possam digitar novas informações de autor e modificar o controle ObjectDataSource para executar a inserção. a partir da pasta Data. String au_fname.WriteSchema). workRow[3] = au_phone. Visual Studio 138 . você modificará o componente Business com um método que insere um registro autor. as permissões são definidas automaticamente. 2. workRow[0] = au_id. workRow[1] = au_lname. workRow[2] = au_fname. O controle GridView é exibido com o dados XML dentro dele. 2. 4. Observação Durante esta parte da explicação passo a passo. Nesta seção. o Controle ObjectDataSource suporta atualização (inserir.Tables[0].NewRow (). e grava o DataSet atualizado de saída como um arquivo XML.Para exibir dados do componente 1. Então.WriteXml (filePath. Para modificar o componente Business para permitir inserção 1. Clique com o botão direito do mouse no controle GridView e clique na marca inteligente se o Menu Common GridView Tasks não estiver aparecendo.Tables[0]. Se você tiver criado o arquivo Authors. String au_phone) { DataRow workRow = dsAuthors. o arquivo Authors. No Toolbox. C# public void InsertAuthor (String au_id. Eles devem corresponder aos nomes de coluna definidos no esquema do arquivo XML criado anteriormente.EndEdit (). dsAuthors. Alterne para o arquivo BusinessObject. O novo método tem quatro valores para inserir. au_lname e au_phone. clique em AuthorsObjectDataSource. Salve o arquivo. No menu DetailsView Tasks. Agora você pode inserir novos autores no arquivo XML. e clique Insert. Para configurar o controle da fonte de dados para inserir dados • Clique com o botão direito do mouse AuthorsObjectDataSource. clique no botão New. você irá usar o controle DetailsView . O controle GridView imediatamente reflete o novo registro. Para testar a inserção 1. O controle é reexibido com caixas de texto. Para adicionar um controle para inserir dados 1. Isso faz com que o controle DetailsView processe um botão New que os usuários podem clicar para colocar o controle no modo de entrada de dados. você pode desejar: • Adicionar funcionalidades de atualização e exclusão . 5. adicione métodos ao componente. no menu DetailsView Tasks clique na marca inteligente.aspx. Para fazer isso. Observação O leiaute exato da página não é importante. As novas informações de autor são adicionadas ao arquivo XML. a partir da pasta Data. clique em Properties. 3. configura o controle da Visual Studio 139 . 2. 2. clique em AuthorsObjectDataSource. Isso é semelhante a lógica usada para adicionar a inserção — você adiciona um método ao componente. Na janela Properties. arraste um controle DetailsView para a página. Insira novas informações de autor.A próxima etapa é alterar a página para que os usuários possam inserir novas informações de autor. Você pode desejar testar recursos adicionais de navegação. Próximas etapas Esta explicação passo a passo ilustra como trabalhar com um componente de dados. Alterne para ou abra a página Default. 4. defina AutoGenerateInsertButton como true. Observação Se não estiver visível. Alterne para modo Design. você deve configurar o controle ObjectDataSource para especificar qual ação o controle deve executar para inserir dados. Finalmente. No controle DetailsView. na caixa Choose Data Source.aspx. Este é o nome do método adicionado para o componente Business. Por exemplo. 3. Em Toolbox. e defina InsertMethod para InsertAuthor. Para o procedimento seguinte. Pressione CTRL+F5 para executar a página Default. Um método comum é adicionar membros e funções ao seu site. consulte Passo-apasso: Editando e Inserindo Dados com o controle DetailsView do servidor Web • Alterar o componente Business para trabalhar com dados de banco de dados em vez de com um arquivo XML. e depois estabelecer regras que o componente Business pode verificar antes de permitir as alterações feitas nos dados. Restringir quais usuários podem fazer alterações aos dados. Você não precisa fazer qualquer alteração aos controles na página. Para obter detalhes. • Visual Studio 140 . adiciona parâmetros apropriados. consulte Passo-a-passo: Criando um site com associações e logon de usuário (Visual Studio) e Passo-a-passo: Gerenciando Usuários de Sites da Web com Papéis. Para obter detalhes.fonte de dados para chamar o método componente. e adiciona uma linha de código para chamar os métodos Update e Delete do controle da fonte de dados. 4. Nesta explicação passo a passo. Para obter informações sobre como criar componentes usando diferentes Visual Studio 141 . serão necessários: • Visual Web Developer e o . 3.NET Framework. o qual permite que você execute o código da página linha por linha e examine os valores das variáveis. você criará uma página que você pode depurar. você criará um página da Web que contém uma calculadora simples que eleva um número ao quadrado. Para criar um site no sistema de arquivos 1.NET Web Site. Nesta explicação passo a passo. Por exemplo. clique em ASP. você pode usar várias linguagens no mesmo aplicativo da Web. Se você já criou um site no Visual Web Developer (por exemplo. Chamar o depurador a partir de um página Web Forms em um site no sistema de arquivos. criando páginas e componentes em linguagens de programação diferentes. Criar página e site da Web Na primeira parte da explicação passo a passo. 5. Tarefas ilustrado nesta explicação passo a passo incluem: • • Definir pontos de interrupção. A caixa de diálogo New Web Site aparecerá. crie um novo site e página seguindo estes passos. clque em New Web Site. Entretanto. você trabalhará com o depurador. Na caixa Location. Pré-requisitos Para concluir este explicação passo a passo. você usará o depurador para examinar a página enquanto esta estiver sendo executada. Abra o Visual Web Developer. Caso contrário. Em Visual Studio installed templates. Na lista Language clique na linguagem de programação que você preferir para trabalhar. digite o nome da pasta C:\WebSites.NET. por ter seguido o tópico Explicação passo a passo: Criando uma página da Web básica no Visual Web Developer). No menu File. consulte Explicação passo a passo: Criando uma página da Web básica no Visual Web Developer.Explicação passo a passo: depuração de páginas da Web no Visual Web Developer O Visual Web Developer fornece ferramentas para ajudar a rastrear erros em suas páginas da Web do ASP. você pode usar o site criado e pular para "Adicionando controles para depuração" a seguir nesta explicação. Após criar a página (que incluirá um erro deliberadamente). O linguagem de programação que você escolher será o padrão para seu site. Para uma introdução ao Visual Web Developer. 2. Você também deve ter uma compreensão geral de como trabalhar no Visual Web Developer. clique em File System e digite o nome da pasta onde você deseja manter as páginas do seu site. consulte Compartilhada pastas código em sites da Web do ASP. 6.NET. Certifique-se que a caixa de seleção Place code in separate file está desmarcada. Feche a página Default. Você pode agora adicionar alguns controles à página e depois adicionar código. digite DebugPage. Na caixa Name. Mude para o modo de exibição Design e depois da pasta Standard para a pasta Toolbox. Em Visual Studio installed templates.aspx.NET pode estar localizado na página ou em um arquivo de classe separado. arraste então os seguinte controles para a página: Controle Label TextBox Button Label Observação Propriedades ID: CaptionLabel Text: (empty) ID: NumberTextBox Text: (empty) ID: SquareButton Text: Square ID: ResultLabel Text: (empty) Visual Studio 142 . consulte Explicação passo a passo: Criando uma página da Web básica com separação de código no Visual Web Developer. 2. 3. Clique em Add. 6. No Solution Explorer. você está criando uma página em um único arquivo com o código e HTML na mesma página. C:\WebSite) e escolha Add New Item.aspx. Para adicionar uma página ao site 1. clique com o botão direito do mouse no nome do seu site (por exemplo. é importante que você crie uma nova página conforme especificado no procedimento a seguir. Para saber mais sobre como manter o código em um arquivo separado. O Visual Web Developer cria a nova página e a abre no modo de fonte.aspx. O código para páginas ASP. O código será simples. Para adicionar controles e código para depuração 1. 4. Nesta explicação passo a passo. 7. mas suficiente para permitir que você adicione pontos de interrupção posteriormente. escolha Web Form. Clique em OK. O Visual Web Developer cria a pasta e uma nova página chamada Default. escolha a linguagem de programação que você preferir usar.linguagens. A partir da lista Language. Criando uma página para depuração Você começará criando uma nova página. Para esta explicação passo a passo. 5. } 4.Text).Text = NumberTextBox. porque há um erro no programa. System. result = Square(number). 3. Observação O exemplo de código deliberadamente não inclui a verificação de erros. Observe que o resultado é incorreto. C# protected void SquareButton_Click(object sender. O manipulador deve se parecer como o exemplo de código a seguir. Para alterar a legenda do controle Label 1. Square = number + number. 2.Convert. return Square. number = System. Salve a página. ou Enter another number: caso contrário. C# int Square(int number ) { int Square. No modo de exibição Design. Para executar a página 1. Feche o navegador. Depurando a página Visual Studio 143 .O layout da página para esta explicação passo a passo. não é importante.IsPostBack == false) { CaptionLabel.Text = "Enter a number: ". } else { CaptionLabel. Inclua um erro no código que adicione o número a si mesmo em vez de multiplicar. Adicione lógica ao manipulador Click para chamar uma função chamada Square para elevar o número digitado pelo usuário ao quadrado. ResultLabel. result.Text = "Enter another number: " . O manipulador deve se parecer com o exemplo a seguir. Digite um número (diferente de 2) e pressione o botão Square. O código deve se parecer com o exemplo a seguir.ToInt32(NumberTextBox. Defina o texto do controle Caption Label como Enter a number: se esta for a primeira vez a página está em execução. 4. 2.EventArgs e) { int number. Crie a função que eleve o número ao quadrado. Clique duas vezes no controle Button role para criar um manipulador Click para ele. } Você também pode adicionar código na página para alterar o texto do rótulo dependendo se esta for a primeira vez que a página está sendo executada. Pressione CTRL+F5 para executar a página.ToString(). 2.Text + " squared is " + result. } Teste a página Para certificar-se que a página está funcionando. 3. execute-a em seu estado atual. clique duas vezes na superfície de design (não no controle) para criar um manipulador de eventos Page_Load. C# if(Page. e escolha Insert Breakpoint. C# if(Page. você usará o depurador para examinar o código da página linha por linha ao ser executado.IsPostBack == false) 3. A partir do menu Debug escolha Start Debugging (ou pressione F5) para executar a página no modo de depuração. clique OK para ativar a depuração.config já existe mas a depuração não estiver ativada. Se você vir a mensagem informando que depuração não está ativada. adicionar pontos de interrupção no código e executar a página no modo Debug. Clique com o botão direito do mouse na linha a seguir. Se o arquivo Web. Para executar o depurador 1. Com pelo menos um ponto de interrupção.config não existir. 2.config. Observação Você não pode definir um ponto de interrupção em uma instrução que declara uma variável. pressionando F9. A opção para ativar a depuração é armazenada como uma configuração no arquivo Web. Defina outro ponto de interrupção para a linha a seguir do manipulador SquareButton_Click: C# result = Square(number). você definirá pontos de interrupção em seu código. seu aplicativo provavelmente não estará configurado para oferecer suporte a depuração. Se o arquivo Web. Observação Você pode habilitar e desabilitar pontos de interrupção. Para definir pontos de interrupção 1. O Visual Web Developer exibe uma mensagem informando a você o que deve fazer para ativar a depuração.config. o Visual Web Developer vai tanto criar o arquivo quanto realizar a configuração apropriada do depurador. Inicialmente. você verá uma mensagem ligeiramente diferente informando que o Visual Web Developer irá modificar o arquivo Web. que mantém várias opções de configuração específicas do site.Nesta parte da explicação passo a passo. Se você nunca tiver executado o depurador antes. 2. Visual Studio 144 . Por padrão. você estará pronto para executar o depurador. depuração é desativada em aplicativos por questões de desempenho (páginas executam mais lentamente no depurador) e por razões de segurança. Mude para o modo de visualização Source. Um ponto de interrupção é uma linha em seu código onde a execução pára e o depurador é chamado. escolha Breakpoint. Isso abre a janela Locals. Isso abre uma janela Watch onde você pode especificar os valores que você deseja rastrear. Neste momento. Pressione F5 novamente para continuar. escolha Continue para continuar a execução. Se você preferir. 3. onde ele para no segundo ponto de interrupção que você definiu. ele para e realça a linha. 8. clique em Watch 1 Observação Se você estiver usando o Visual Web Developer Express Edition. Como o ponto de interrupção está no manipulador Page_Load. 5. 9. 7. o designer altera para modo de depuração exibindo o código para a página e algumas janelas de depuração. O manipulador de eventos Page_Load termina o processamento e a página é exibida no navegador. O navegador está aberto. que exibe os valores de todas as variáveis e objetos que estão sendo no escopo da linha sendo executada. com o ponto de interrupção na linha no manipulador Page_Load. você vê que o valor de number é 2 e o valor de result é 0. a página ainda não terminou de ser processada. No menu Debug. Quando o depurador chega na linha com o ponto de interrupção. o depurador oferece apenas uma única janela Watch. Na janela Locals. mas com a desvantagem de que a janela pode conter mais informações do que você deseja ver. com a vantagem de que você não precisa definir explicitamente um observador para os elementos.IsPostBack e clique Add Watch. No menu Debug. a janela Watch mostra que o valor de Page. clique com o botão direito do mouse na parte IsPostBack da expressão Page.No Visual Web Developer. O comando Continue informa o depurador para continuar até que ele chegue no próximo ponto de interrupção. Observação Visual Studio 145 . clique em Windows e clique Locals. O depurador será exibido novamente. No editor. A partir do menu Debug. ou pressione F5. O depurador processa o manipulador Page_Load e entra no manipulador SquareButton_Click. clique em Watch e em seguida. Insira o valor 2 na caixa de texto e clique o botão Square. 4.IsPostBack é true. clique em Windows. A janela Locals fornece uma maneira alternativa para você exibir esses valores. Isso adiciona a expressão na janela Watch e exibe o valor atual da propriedade (false) é exibida na coluna Value. O depurador executa sua página linha por linha. você pode digitar o nome de uma variável ou propriedade na coluna Name da janela Watch. 6. mas a página não será exibida ainda. o texto na caixa de texto foi alterado para 5. Além disso. clique em Windows e Immediate. O depurador percorre seu código linha por linha. O resultado que você vê —10— é incorreto . propriedade de objeto ou expressão que combinem essas. Na janela Immediate. usando a mesma sintaxe que você usaria em código. ou pressione F11. Edite o valor da variável number e altere-o para 5. como tanto adicionar quanto elevar 2 a 2 resulta em 4. O comando Step Into faz com que o depurador execute uma linha e depois interrompa novamente. Portanto. digite a expressão a seguir e pressione ENTER. escolha Step Into para entrar na função Square. 13. Pressione F5 para continuar a execução do programa. C# ResultLabel. No menu Debug. Na janela Immediate. mantendo o ponteiro do mouse sobre ela.Text O ponto de interrogação (?) é um operador na janela Immediate que avalia a expressão que o segue. Visual Studio 146 . já que 10 não é o quadrado de 5.Text = "5" Além de avaliar expressões. Você pode agora corrigir o erro. digite o seguinte e pressione ENTER: NumberTextBox. Continue a depuração pressionando F11 até chegar a linha de código a seguir. 14. 11. você pode alterar o valor dessa variável. 10. ela exibe o resultado de passar 5 para a função Square. Quando a página aparecer. Na coluna Value da janela Locals. Você pode avaliar qualquer variável. você está avaliando a propriedade Text do controle NumberTextBox na página.Você também pode ver o valor de qualquer variável no programa. 12. A janela Immediate permite que você execute comandos. Quando o depurador executa a função Square. clique com o botão direito do mouse na linha para a variável number e selecione Edit value. para obter o valor de uma propriedade). ? NumberTextBox. 15. Para corrigir o erro e testar novamente 1. No exemplo. a janela Immediate permite que você altere variáveis ou propriedades 16. O valor 2 para a variável number não é um bom teste do programa.Text = NumberTextBox. Você pode usar a janela para avaliar expressões (por exemplo. você pode usar a janela Locals para verificar os dados passados para a função (number) e o valor de retorno da função (Square).Text + " squared is " + result.ToString(). A partir do menu Debug. Mude do navegador para o Visual Web Developer. enquanto o programa está sendo executado. A partir do menu Debug. Próximas etapas O depurador inclui recursos adicionais para ajudá-lo a trabalhar com seu código. 2. Visual Studio 147 . pressionando as teclas CTRL+SHIFT+F9. escolha Delete All Breakpoints para que a página não pare a cada vez que for executada. As alterações temporárias que você fez anteriormente. Como o código não está em execução (a página terminou de ser processada). Feche o navegador para interromper o depurador. Para obter detalhes. 4. Além disso. Na função Square. altere o operador "+" para o operador "*". Pressione CTRL+S para salvar a página. Mude para o janela do navegador. ele é elevado ao quadrado corretamente. 7. você está em modo de edição e pode fazer alterações permanentes. Desta vez. 5.Observação Não feche o janela do navegador. quando você executar a página e inserir um valor. talvez você queira explorar o rastreamento. como alterar a propriedade Text do controle NumberTextBox. não foram persistentes. Insera 5 na caixa de texto e clique o botão. Por exemplo. porque eles se aplicavam somente quando a página foi executada da última vez. talvez você queira aprender sobre técnicas para manipular condições de erro e formas em que você pode monitorar o processamento de página em tempo de execução. 3. Observação Você também pode limpar os pontos de interrupção. consulte Explicação passo a passo: Usando rastreamento no Visual Web Developer para ajudar a localizar erros em página da Web. 6. Para criar um site do sistema de arquivos 1.Passo-a-passo: Criando e usando Páginas Mestras do ASP. Páginas mestras permitem que você crie um layout de página — uma página modelo — e então crie páginas separadas contendo o conteúdo que será mesclado com a página mestra em tempo de execução. Pré-requisitos Para concluir esta explicação passo a passo.NET Web Site. Visual Studio 148 . Na lista Language. você pode usar esse site e vá para a próxima seção. Clique em OK. Entretanto. um. 2. a exibição de um logotipo é opcional e o tamanho exato do gráfico não será importante para a explicação passo a passo. digite o nome da pasta C:\WebSites. 4. . Criando um site da Web Se você já tiver criado um site no Visual Web Developer (por exemplo. Na caixa Location.NET Framework. 6. No menu File. Executando páginas mestras para mostrar um conteúdo diferente. crie um novo site e página seguindo estas etapas. consulte Visão Geral sobre Páginas Mestras no ASP. Para obter mais informações sobre páginas mestras.NET . A caixa de diálogo New Web Site aparece. clique em ASP. Selecionando uma página mestra em tempo de execução. Opcionalmente. clique em New Web Site. O . É recomendável que o logotipo não seja maior do que 48 pixels de largura.NET com conteúdo que você deseja exibir na página mestra. "Criando a Página mestra. seguindo as etapas do Passo-a-passo: Criando uma página básica da Web em Visual Web Developer).". clique a linguagem de programação em que você preferir para trabalhar. Criando uma página ASP.NET no Visual Web Developer Esta explicação passo-a-passo ilustra como criar uma página mestra e diversas páginas de conteúdo. insira o nome da pasta onde você deseja manter as páginas do seu site. Abra o Visual Web Developer. será necessário: • • • Visual Web Developer (Visual Studio). 5. Em Visual Studio installed templates. Tarefas ilustrado esta explicação passo a passo incluem: • • • • Criando uma página mestra no Microsoft Visual Web Developer . 3.jpg.gif. ou outro arquivo gráfico que você possa usar como um logotipo em sua página mestra. Caso contrário. Por exemplo. digite Master1. e um rodapé que será exibido em cada página do seu site. um logotipo. e clicar em Validation. 4. Uma página mestra também contém um ou mais espaços reservados de conteúdo que designam onde o conteúdo dinâmico aparecerá quando as páginas forem exibidas. Com o arquivo Master1. Nesta seção. defina o esquema de destino para validação para o Microsoft Internet Explorer 6. Você irá trabalhar mais com o espaço reservado de conteúdo posteriormente nesta explicação passo-a-passo. mas aparecerá no modo de origem. Então. não em um arquivo separado de código 5. você irá usar uma tabela para ajudar você a posicionar elementos na página. você pode usar tanto a lista suspensa na caixa de ferramentas ou selecionar Options a partir do menu Tools.NET Single-file.NET. o código ilustrado nesta explicação passo-apasso irá funcionar. 3. clique na linguagem de programação que você preferir e clique Add. que é a área da página mestra onde os conteúdo substituíveis serão mesclados nas páginas de conteúdo em tempo de execução. Para definir esse valor. Observação Esta explicação passo-a-passo assume que você está usando arquivos code-behind para todas as páginas. que é uma região na página mestra que pode ser substituída por informações em uma página de conteúdo. clique com o botão direito do mouse no nome do seu site. Você iniciará criando uma tabela de layout para armazenar os elementos da página mestra. Visual Studio 149 . irá posicionar o controle de espaço reservado de conteúdo que já estiver na página. Para criar a página mestra 1. e então clique Add New Item. A nova página mestra abre no modo de origem.Master selecionado no modo de exibição de origem. você primeiro criará um página mestra. No Solution Explorer.0. Dispondo a Página Mestra A página mestra define como as páginas no seu site aparentam. 2. Na caixa Name. Posteriormente. Selecione a caixa de seleção Place code in separate file . você irá usar uma tabela para formatar a página mestra com um menu. Ela pode conter qualquer combinação de textos estáticos e controles. nesta seção. Criando a página mestra A página mestra é o modelo de como será o aspecto de suas páginas.aspx. Na parte superior da página está uma declaração @ Master em vez de uma declaração @ PAGE normalmente encontrada na parte superior de páginas ASP. Você também vai trabalhar com um espaço reservado de conteúdo. Nesta explicação passo a passo. Na lista Language. clique em Master Page. O corpo da página contém um controle <asp:contentplaceholder>. Para criar uma tabela de layout para a página mestra 1.O Visual Web Developer cria a pasta e uma nova página chamada Default. Em Visual Studio installed templates. Se você estiver usando uma página ASP. e a linha central é dividida em duas células. 3. A partir da Lista suspensa na parte superior da janela Propriedades. 6. e defina seu Width como 48 na janela Properties. Clique na primeira linha. Defina a propriedade do controle do Menu Orientation como Horizontal. Crie um menu seguindo estas etapas: 1. Se tiver um gráfico de logotipo disponível. Selecione todas as células na tabela e defina BgColor como uma cor diferente do que a cor do plano de fundo. você pode adicionar conteúdo para a página mestra que aparecerá em todas as páginas. selecione DOCUMENT. Clique na célula inferior e digite o texto rodapé como Copyright 2005 Contoso Inc. e defina seu Height como 48 na janela Properties. e defina BgColor para uma cor diferente. No menu Layout. e defina VAlign como top. Clique na página onde você deseja colocar a tabela de layout. o o o Faça as seguintes configurações: Na linha do meio. Para adicionar conteúdo estático para a página mestra 1. O modelo define a organização de linhas e células na tabela. Alternar para modo Design. clique na coluna mais à esquerda. Após definir o layout a tabela. clique em Template. Visual Studio 150 . a partir do grupo de controle Navigation. arraste um controle de Menu para a célula superior. como azul. e defina seu Height como 48 na janela Properties. 4. e adicionar um menu. Clique na linha inferior. 2. Observação Você pode definir a largura e altura arrastando as bordas de célula da tabela ou selecionando a célula e definindo valores na janela Properties. Na lista cliquem em Header. 5. Observação Não coloque a tabela de layout dentro do Controle ContentPlaceHolder.2. Na caixa de diálogo Insert Table . 3. A cor selecionada não é importante. O modelo que você selecionou cria três linhas. Na Toolbox. Posteriormente nesta explicação passo-apasso você criará uma segunda página mestra sem uma cor para comparar com aquilo que você está selecionando aqui. 7. footer and side. 8. você poderá adiciona-lo também. Você irá adicionar uma mensagem de direitos autorais como um rodapé. clique em Insert Table. e clique OK. Na lista Language. Na página de conteúdo. 4. 3. clique na linguagem de programação que você preferir. 2. clique com o botão direito do mouse no nome do site. Clique no segundo nó. 3. e defina Text como About e NavigateUrl como About. Selecione a caixa de seleção Select master page. certifique-se de anotar o nome porque você precisará saber o nome mais tarde. Na Solution Explorer. Clique na marca inteligente no controle do Menu. 2. 5. No Solution Explorer. Nesta explicação passo a passo. Na caixa Name.2.NET que está associada com a página mestra. Definida a propriedade do controle da Imagem ImageUrl com o nome do arquivo gráfico. Para criar a Home Page 1. arraste um controle de Image para a coluna do esquerda no meio de tabela. 2. clique duas vezes no ícone Add a root node para adicionar dois itens de menu : 1. e clique Edit Menu Items na caixa de diálogo Menu Tasks. Visual Studio 151 . selecione o arquivo gráfico.aspx. Salvar a página. Em Items. Você pode deixar esse nome ou alterá-lo.aspx. e defina Text como Home e NavigateUrl como Home. Navegue para o arquivo gráfico. 5. A página de conteúdo é uma forma especializada de uma página ASP. e clique Add. Na Toolbox do grupo Standard. A primeira é uma Home Page e a segunda é uma página do tipo Sobre. Agora você pode posicionar o espaço reservado de conteúdo para especificar onde a página mestra pode exibir conteúdo em tempo de execução. Clique no primeiro nó. e clique em Add New Item. siga estas etapas para colocá-lo na página mestra: 1. Criando Conteúdo para a Página Mestra A página mestra fornece o modelo para o seu conteúdo. Em Visual Studio installed templates. você irá adicionar duas páginas com conteúdo para a página mestra. Clique OK para fechar a caixa de diálogo Menu Item Editor. 4. Se você tiver um arquivo gráfico disponível para uso como um logotipo. você adiciona o texto e os controles que você deseja exibir quando os usuários solicitarem essa página. Se você alterar o nome.NET que contém somente o conteúdo a ser mesclado com a página mestra. digite Home. e então clique Add. Arraste o controle ContentPlaceHolder para a célula à direita do meio. 2. 4. A Propriedade ID do controle é ContentPlaceholder1. e clique Add Existing Item. clique com o botão direito do mouse no nome do site. criando uma página ASP. Você define o conteúdo para a página mestra. Para adicionar um espaço reservado de conteúdo 1. clique em Web Form. 3. você pode digitar qualquer texto que o ajudará a reconhecer esta página como a home page. Certifique-se de anexar a nova página à página Master1.aspx é criado. selecione o texto. e em seguida.Master como fez com a Home Page..A caixa de diálogo Select a Master Page aparece. Em vez disso. Um novo arquivo.. C# <%@ Page Language="C#" MasterPageFile="~/Master1. As informações de título são armazenadas na diretiva @ Page da página de conteúdo. Você pode criar a página Sobre da mesma forma que você criou a Home Page. 2. de forma que o título correto é exibido no navegador quando o conteúdo é mesclado com a página mestra. Todo o conteúdo restante da página mestra é exibido. Clique em Master1.NET. A página contém uma diretiva @ PAGE que conecta a página atual com a página mestra selecionada com o atributo MasterPageFile. Uma página de conteúdo não tem os elementos usuais que compõem uma página ASP. Visual Studio 152 . e em seguida. %> A página também contém um elemento <asp:Content> com que você irá trabalhar a seguir. Você pode definir o título de cada página de conteúdo independentemente. Alterne para o modo Design. portanto você pode ver o layout. Pressione ENTER para criar uma nova linha vazia no controle Content. 6. clique em DOCUMENT. você adiciona somente o conteúdo que você deseja exibir na página mestra. No Controle Content. digite Welcome to the Contoso Web Site. como os elementos html. body. formate o texto como Heading 1 selecionando o texto e então selecionando Heading 1 da lista suspensa Block Format acima da Toolbox. Da lista suspensa na janela Properties. A região que você criou como um controle ContentPlaceHolder na página mestra é exibida como um Controle de Conteúdo na nova página de conteúdo.aspx. ou form. substituindo as regiões do espaço reservado que você criou na página mestra. 5. e defina Title para Home Page de Contoso. e clique OK. digite Obrigada por visitar nosso site. mas ele aparece esmaecido porque você não poderá alterá-lo ao editar uma página de conteúdo.master" . Altere o título da página para Página Sobre Contoso. Salve a página. como mostrado no seguinte exemplo de código. Use as mesmas etapas que você usou para a Home Page para adicionar uma nova página de conteúdo chamada About.master. 2. Para adicionar conteúdo para a Home Page 1. 3. Para criar a página Sobre 1. O texto adicionado aqui não é importante. 4. Para adicionar uma propriedade à página mestra 1. e em seguida.aspx é exibida.master. A página About. Alterne para. Clique no link Sobre. 2. 5. não há nenhuma referência no navegador para a página mestra. Contoso provê serviços de software de alta qualidade.aspx.MASTER. C# public String CompanyName { get { return (String) ViewState["companyName"]. usar o valor da propriedade nas páginas de conteúdo. 3. Salve a página.NET. Dentro da definição de classe. e digite Desde 1982.NET mescla o conteúdo da página Home. executando-as como você faria com qualquer página ASP. Referenciando Membros da Página Mestra Código em páginas de conteúdo podem referenciar membros da página mestra. } set { ViewState["companyName"] = value. incluindo quaisquer propriedades pública ou métodos e os controles da página mestra. ou abra. Na Solution Explorer. Pressione ENTER para criar uma nova linha. O ASP. A primeira etapa é adicionar uma propriedade para a página mestra. 2.master em uma única página e exibe a página resultante no navegador. e clique View Code Para abrir o editor de códigos. e pressione CTRL+F5.NET. 4. e em seguida. Para mais informações. Se você preferir. selecionando o texto e selecionando Heading 1 do Block Format da lista suspensa acima do Toolbox. digite o código a seguir. Observe que a URL da página é Home. Alterne para a página Home. o Visual Web Developer cria páginas que usam o modelo code-behind. } } O código cria uma propriedade chamada CompanyName para a página mestra. Testando as páginas Você pode testar as páginas. Nesta parte da explicação passo a passo você irá criar uma propriedade na página mestra.aspx com o layout na página Master1. Ela também será mesclada com a página Master1.3. a página Master1.MASTER. formate o texto como um Heading 1. O valor é armazenado no estado da exibição para que ele seja persistentes entre postbacks. Observação Por padrão. Na região de conteúdo. clique com o botão direito do mouse em Master1. digite Sobre Contoso. você pode criar código usando o modelo Single-File. e qualquer referência para o nome da empresa nas páginas de conteúdo é baseada na propriedade da página mestra.aspx. A premissa é que o nome da empresa do site está armazenado como uma propriedade na página mestra. consulte Modelo de Código de Página Web do ASP. Para testar as páginas 1. Visual Studio 153 . ou abra.CompanyName = "Contoso". C# void Page_Load(Object sender. 5. você irá embutir em código o valor da propriedade CompanyName para a página. adicione o seguinte código. 6.CompanyName. 4. a página code-behind Master1. a página Home. Alterne para modo Design. EventArgs e) { CompanyName. 4.Master. a página Home. ou abra. Dentro da definição da classe (mas não dentro do código da propriedade). Para testar a referência para a propriedade da página mestra 1. Defina a propriedade ID do controle do Label como CompanyName. Na parte superior da página. Alterne para. com o texto Bem-vindo ao site de Contoso 2. e coloque-o após o texto estático de forma que leia-se o texto: Bem-vindo ao site de [label] 7. EventArgs e) { this. sob a diretiva @ PAGE. Na Toolbox do grupo Standard. Dentro da definição de classe. adicione a seguinte diretiva @ MasterType : <%@ MasterType virtualpath="~/Master1. 3. com a página Master1. que você irá usar logo. Feche o navegador. 2.aspx. Alterne para modo de origem. No controle Content. Altere o manipulador Page_Init para atribuir um nome de empresa diferente para a propriedade.MASTER. } Para esse exemplo. C# void Page_Init(Object sender. ou abra. A página é exibida no navegador. Alterne para.4.Text = Master.aspx. altere o texto para Bem-vindo ao site de. clique com o botão direito do mouse em Home. 9. Visual Studio 154 .aspx e clique View Code para abrir o editor de códigos. adicione o seguinte código. Agora você pode testar a página de conteúdo para certificar-se de que ele está referenciando a propriedade CompanyName da página mestra corretamente. } A propriedade Master da página de conteúdo retorna uma referência para a página mestra conforme definido na diretiva @ MasterType adicionada na etapa 3. Agora você pode modificar o página de conteúdo para usar a propriedade CompanyName da página mestra. Para referenciar a propriedade CompanyName na página de conteúdo 1. 3. arraste um controle Label para o controle Content.master" %> A diretiva vincula a propriedade Master da página de conteúdo. Alterne para. No Solution Explorer. 8. como no seguinte exemplo de código. e pressione CTRL+F5 para executar a página. NET Programaticamente.NET Programaticamente. Nesta parte da explicação passo a passo.CompanyName = "New Company Name". você irá adicionar uma segunda página mestra ao site. e denomine a nova página mestra como Master2. C# <%@ Master Language="C#" CodeFile="Master2. Clique com o botão direito do mouse em Copy of master1.Master e. usando o método Master.C# void Page_Init(Object sender. talvez queira permitir que os usuários selecionem entre vários layouts e defina a página mestra de acordo com suas preferências. na diretiva @ Master.aspx. Alterando páginas mestras dinamicamente • • Em algumas circunstâncias.master. Você pode referenciar controles na página mestra.master.cs" Inherits="Master2" %> Visual Studio 155 .FindControls. Neste momento. Abra a Master2. e criar botões que permitem ao usuário alternar entre uma página mestra e outra. clique em Rename. Para mais informações.master. provavelmente você iria armazenar informações como o nome da empresa no arquivo de configuração e lê-las diretamente nas páginas de conteúdo. usar código para definir a página mestra para uma página de conteúdo. consulte Trabalhando com Páginas Mestras de ASP. clique em Paste Uma página mestra é adicionada ao site a Web com o nome Copy of master1. 2. Porque as duas páginas mestras serão muito semelhante.Page. o nome da empresa atualizado aparece na página Anotações Há várias outras questões que você deve estar ciente ao trabalhar com uma página mestra: • Em um aplicativo real. EventArgs e) { this.Web. Alterne para a página Home. Por exemplo. convém poder alterar páginas mestras dinamicamente. você irá fazer uma cópia da primeiro página mestra e irá modificá-la para atuar como a segunda página mestra . Para mais informações. e em seguida. } 5. consulte Trabalhando com Páginas Mestras de ASP. clique com o botão direito do mouse em Master1. No Solution Explorer. 4. e clique Copy. ou seja. A diretiva completa da página vai parecer com o exemplo de código a seguir. No entanto.master. o cenário descrito aqui fornece uma ilustração simples de como fazer a referência a membros de página mestra nas páginas de conteúdo.UI. e pressione CTRL+F5 para executá-la novamente. 3. Para fazer uma cópia da página mestra 1. você deve fazer um cast da propriedade System. para fazer isso. Entretanto. altere Master1 para Master2. Você pode acessar membros na página mestra mesmo sem incluir uma diretiva @ MasterType.master.Master para o tipo apropriado na página mestra (a propriedade Master é null se uma página não tiver nenhuma página mestra). Clique com o botão direito do mouse no nome do site. EventArgs e) { Session["masterpage"] = "Master2. EventArgs e) { Session["masterpage"] = "Master1. C# void LinkButton1_Click(Object sender. O código terá o aspecto como no exemplo a seguir. Agora você escreve o código na página de conteúdo que irá carregar dinamicamente a página mestra que o usuário tiver selecionado.Redirect(Request. } Esse código é o mesmo que o usado para o botão na página Master2. 7. a partir do nó Standard. e. Alterne para. e defina sua propriedade Text como Plain.Url.master". em seguida. Para adicionar botões para selecionar uma página mestra alternativa 1. Alterne para.) Em breve. 4. C# void LinkButton1_Click(Object sender. Na janela Properties. Response. C# public partial class Master2 : System. Adicione um controle LinkButton como você fez nas etapas 1 e 2. adicione o código realçado seguinte.master. 6. adicione o código realçado seguinte. você vai criar código na página de conteúdo que usará o nome da página mestra. em seguida. 6. Defina a propriedade Text do botão como Colorful.master". A nova página mestra terá o aspecto e funcionalidades como a Master1. e depois recarregue a página atual. ou abra.ToString()).Master e altere o nome da classe no arquivo code-behind da página mestra de Master1 para Master2 para corresponder ao valor do atributo Inherits na diretiva <%@ Master %> da página.UI. 5. ou abra. 3. 2. arraste um controle LinkButton para a página e coloque-o abaixo do menu na célula mais alta da tabela. Clique duas vezes no botão para criar um manipulador para o Evento Click.Url.Master no modo Design. Clique duas vezes no botão Plain para criar um manipulador para o Evento Click. na lista suspensa na parte superior. Visual Studio 156 . } O código carrega o nome da página mestra alternativa em uma variável de sessão persistente. mas não terá nenhuma cor de plano de fundo. 8.Web.ToString()). clique em DOCUMENT. e. (A propriedade Url retorna um objeto Uri que faz referência a página atual. Desmarque a propriedade BgColor. a página Master1. Na Toolbox. a página Master2. 7. Alterne para modo Design.MasterPage A próxima etapa é adicionar um botão para cada página mestra que permite ao usuário selecionar a página mestra alternativa.master.Redirect(Request. Response.5. Abra o arquivo de código do Master2. exceto que ele carrega uma página mestra alternativa.MASTER. adicione o seguinte código. C# void Page_PreInit(Object sender. Dentro da definição da classe.aspx e clique View Code para abrir o editor de códigos. Para obter detalhes.aspx. A página é reexibida.MASTER. e então guardar a preferência do usuário usando perfis. no manipulador Page_Init). não será possível atribuir páginas mestras dinamicamente para a Home Page e em vez disso você vai poder trabalhar com outras páginas que você tiver criado. Master1. Observação A Home Page que você criou contém uma diretiva @ MasterType que efetivamente a vincula para uma única página mestra (Master1. que não tem nenhuma cor de plano de fundo. Este código deve executar no manipulador Page_PreInit. Agora você pode testar as páginas mestras dinâmicas. você provavelmente deve exibir uma escolha dos layouts. Anotações Há várias outras questões que você deve estar ciente ao trabalhar com páginas mestras dinâmicas: • O cenário desta seção para alterar páginas mestras é simplificada para manter a explicação passo a passo focalizada em páginas mestras. 2. No Solution Explorer. neste momento mesclada com a Master2. Portanto. que você pode configurar no código de uma maneira semelhante à mostrada nessa seção da explicação passo a passo.MASTER). A página é exibida no navegador mesclada com sua página mestra padrão. clique com o botão direito do mouse em About. pressione CTRL+F5 para executar a página. a página About. • Visual Studio 157 . Em um aplicativo real. 2.MasterPageFile = (String) Session["masterpage"]. não pode ser executado em um manipulador que ocorre em qualquer momento posterior que o manipulador Page_PreInit (por exemplo. Para testar as páginas mestras dinâmicas 1. consulte Visão geral sobre Propriedades de Perfil de ASP. ou abra. Na página About. Alterne para. 3. Clique no link Colorful. Você pode ter algumas páginas que devem usar uma página mestra alternativa.NET. EventArgs e) { if(Session["masterpage"] != null) { this. se houver.master. A página é exibida usando a Master1. Para obter detalhes. Clique no link Plain .Escrever código para selecionar a página mestra dinamicamente 1.aspx. porque a página mestra deve ser estabelecida para que a página possa criar uma instância dela antes de qualquer inicialização adicional possa ocorrer. } } O código define o valor da propriedade MasterPageFile da página atual para o valor na variável de sessão.Master novamente. 3. Você pode configurar seu site para todas as páginas usarem a mesmo página mestra. Em seguida. consulte Visão Geral sobre Filtragem de Dispositivo ASP. Para obter detalhes. Definir espaços reservados conteúdo conteúdo padrão. • • • • Visual Studio 158 . consulte Páginas Mestras ASP. como um layout para navegadores e outro para um tipo específico de telefone. a página mestra exibe o conteúdo padrão.NET não fornece conteúdo para o espaço reservado. Programaticamente acessar membros da página mestra de páginas de conteúdo.NET. Por exemplo.consulte "Escopo de Páginas Mestres" em Visão Geral de Páginas Mestras de ASP.NET. Para obter detalhes.aspx para cada página onde você deseja substituir a página mestra padrão. consulte Como: Referenciar o Conteúdo de Páginas Mestras ASP. • Você precisa adicionar o código da página Home. Se uma página ASP.NET Aninhadas. Isso permite que você dinamicamente altere o aspecto da página mestra em tempo de execução. você pode desejar: • Criar páginas mestras que têm vários espaços reservados de conteúdo. Usar filtragem de dispositivos com páginas mestras para criar diferentes layouts para diferentes dispositivos. você pode preencher um ou mais espaços reservados com conteúdo para cada página que você exibir.NET. Aprenda como você pode colocar páginas mestras em páginas mestras para criar partes em componentes. Próximas etapas Esta explicação passo a passo ilustra a funcionalidade básica de páginas mestras. Você pode desejar testar recursos adicionais de páginas mestras. Para obter detalhes. Passo-a-passo: personalizando um site usando temas no Visual Studio Esta explicação passo a passo ilustra como usar temas para aplicar uma aparência consistente a páginas e controles em seu site.NET Web Site. 2. clique na linguagem de programação que você preferir trabalhar. Abra Visual Web Developer. O Visual Web Developer cria a pasta e uma nova página chamada Default.NET para páginas individuais e para o site como um todo. que são usadas para definir o aspecto dos controles individuais. e um controle Label. Para criar um site do sistema de arquivos 1. Um tema pode incluir arquivos de capa que definem um aspecto comum para controles individuais. Criando o site da Web Se você já criou um site no Visual Web Developer (por exemplo.aspx. 4. 6. Alterne para modo Design. uma ou mais folhas de estilo e elementos gráficos comuns para uso dos controles. para que você possa ver como esses controles são afetados por temas. seguindo as etapas no Passo-a-passo: Criando uma página da Web básica em Visual Web Developer). Visual Studio 159 . O . clique New Web Site. como o Controle TreeView Controle. digite o nome da pasta C:\WebSites. No menu File. Por exemplo. Na caixa Location. 3. clique em ASP. insira o nome da pasta onde você deseja manter as páginas do seu site. Na lista Language.NET Framework. Clique em OK. um controle Calendar. A caixa de diálogo New Web Site aparece. Caso contrário. Pré-requisitos Para concluir esta explicação passo a passo. Para colocar controles na página 1. Criando seu próprio tema que inclui capas.NET em sites da Web As tarefas ilustradas nesta explicação passo a passo incluem: • • Aplicar temas predefinidos ASP. Esta explicação passo a passo mostra como trabalhar com temas ASP. Em Visual Studio installed templates. crie um novo site e página seguindo estas etapas. 5. irá configurar um controle Button. Para iniciar o trabalho com temas nesta explicação passo a passo. será necessário: • • Visual Web Developer Microsoft (Visual Studio). você pode usar esse site e ir para a próxima seção. NET torna fácil aplicar um tema predefinido a uma página. Em Visual Web Developer. Observação As características exatas que você define são não importantes. 2. e denomineosampleTheme. Alterne para modo de origem. 3. sampleTheme). Criando e aplicando um tema a uma página O ASP. 4. clique com o botão direito do mouse no nome de seu site. Clique com o botão direito do mouse na pasta sampleTheme. mas você tem que se lembrar dele quando você for aplicar o tema personalizado. O nome desta pasta será o nome do tema que você criar (aqui. Salve a página. clique Add ASP.2. A partir do grupo Standarddo Toolbox. adicione um novo arquivo de texto.NET. O nome exato é não importante. você irá criar um tema com algumas capas simples. (Para obter detalhes.skin.Net Folder. e depois com diferentes temas. arraste um controle Calendar. 3.) Nesta parte da explicação passo a passo. No arquivo sampleTheme. você desejará ver a página antes de um tema ser aplicado. <asp:Label runat="server" ForeColor="red" Font-Size="14pt" Font-Names="Verdana" /> <asp:button runat="server" Borderstyle="Solid" Borderwidth="2px" Bordercolor="Blue" Backcolor="yellow"/> 4. Para criar um novo tema 1. que definem a aparência dos controles. Para testar a página. e em seguida. clique em Theme. um controleButton. não use o comando AutoFormat para definir o aspecto do controle Calendar. selecione Add New Item. ou criar um tema exclusivo. consulte COMO: Definir temas ASP.skin. Por exemplo. As definições de capa são semelhantes à sintaxe para criação de um controle. Observação Não aplique qualquer formatação para qualquer um dos controles. exceto que as definições incluem apenas configurações que afetam a Visual Studio 160 . Os valores da seleção anterior são sugestões que serão mais óbvias quando você testar o tema posteriormente. e um controle Label para a página. O layout exato da página não é importante. Certifique-se de que o elemento <head> da página tem o atributo runat="server" para que ela seja lida da seguinte maneira: <head runat="server"></head> 5. adicione definições de capa conforme mostrado no exemplo de código a seguir. Renomeie a pasta Theme1sampleTheme. A pasta chamada App_Themes e uma subpasta chamada Theme1 são criadas. Um tema de folhas de estilo usa os mesmos arquivos de tema como um tema personalizado. 3. 2. Para testar temas 1. Porque você não foi criou uma entrada no arquivo sampleTheme. Por exemplo. Temas de Folhas de Estilo vs. a ordem de prioridade é: • • • Configurações de temas. Configurações de Temas de Folhas de Estilo. equivalente a um arquivo CSS.config. Configurações de página local. Personalização de Temas Após ter criado seu tema. mas sua prioridade nos controles e propriedades da página é inferior. 6. Os controles são exibidos com sua aparência padrão. Pressione CTRL+F5 para executar a página.skin para o controle Calendar. Visual Studio 161 . e seguida.skin. incluindo temas definidos em seu arquivo Web. Agora você pode testar a página antes de que qualquer temas seja aplicado. Desta vez. Salve o arquivo de capa. 5. feche-o. as definições capa não incluem uma configuração para a propriedade ID. Em Visual Web Developer. ele será exibido com a aparência padrão. 5. Pressione CTRL+F5 para executar a página novamente. o arquivo sampleTheme. você pode adaptar como ele é usado no seu aplicativo associando-o com a página tanto como um tema personalizado (como feito na seção anterior). se disponível.. No modo de exibição origem. 4. os controles são processados com o esquema de cores definido no seu tema..skin que você definiu anteriormente). Os controles Label e Button serão exibidos com as configurações feitas no arquivo sampleTheme. ou como um tema de folhas de estilo. %> Observação Você deve indicar o nome de um tema real no valor do atributo (neste caso. e depois retorne ao Visual Web Developer.NET. No ASP. Pressione CTRL+F5 para executar a página novamente.aparência do controle. adicione o atributo a seguir para a diretiva @ Page: <%@ Page Theme="sampleTheme" . defina o tema com o nome de outro tema. Os controles alterarão sua aparência novamente. ele será aplicado a todas as páginas que usam o tema. Observação Se você adicionar um arquivo de folhas de estilo em cascata (CSS) para a sua pasta sampleTheme. Feche o navegador. e também em qualquer tema de folhas de estilo em uso. se você usar um tema personalizado. 8. A propriedade ForeColor de Label1 estará vermelho novamente. No modo Design. defina a propriedades do controle Calendar para que o controle tenha um aspecto diferente. 4. As configurações a seguir são sugestões: BackColor Cyan Red 4 8 Arial Large Red BorderColor BorderWidth CellSpacing Font-Name Font-Size o o o o o o o SelectedDayStyle-BackColor Visual Studio 162 . Pressione CTRL+F5 para executar a página. 5. Selecione Label1 e. Para usar um tema de folhas de estilo e consultar ordem de prioridade 1. Pressione CTRL+F5 para executar a página. se você optar por usar um tema de folhas de estilo. 7. Da mesma forma. as propriedades do seu tema irão substituir qualquer coisa dentro a página local. defina ForeColor como blue. em Properties. Alterne para modo de origem. 6.Quanto a isso. Alternar para modo Design. Baseando um tema personalizado em controles existente Uma maneira fácil para criar definições de capa é usar o designer para definir as propriedades de aparência. Pressione CTRL+F5 para executar a página. Altere a declaração da página para declarar um tema. alterando: <%@ Page StyleSheetTheme="sampleTheme" %> De volta para: <%@ Page Theme="sampleTheme" %> 9. Altere a declaração da página: <%@ Page theme="sampleTheme" %> Para uma declaração de tema de folhas de estilo: <%@ Page StyleSheetTheme="sampleTheme" %> 3. e então copiar a definição de controle em um arquivo de capas. A propriedade ForeColor de Label1 fica azul. 2. as propriedades do seu tema serão substituídas por qualquer coisa declarada localmente na página. Para basear um tema personalizado em controles existentes 1. em vez de um tema de folhas de estilo. Observe que a propriedade ForeColor do controle Label1 está vermelho. Alterne para modo de origem. você pode substituir as configurações dos temas em uma página. Cole a definição do controle Calendar no arquivo sampleTheme. Observação Você não precisa escrever um nome. 2. 2. 3. Alterne para a página Default. 5. Alterne para ou abra o arquivo sampleTheme. 2. 6. Visual Studio 163 . porque o arquivo é denominado sempre de Web. Salve e feche o arquivo Web.config diferencia maiúsculas de minúsculas e os valores estão caixa-mista (alta e baixa). 7.skin. Em Templates. 3.skin. Os valores da lista anterior são sugestões que serão mais óbvios quando você testar o tema posteriormente. Aplicando temas a um site Você pode aplicar um tema a um site inteiro. Adicionar o seguinte atributo ao elemento <pages>. (Por exemplo: tema e styleSheetTheme). No Solution Explorer.skin. Não defina qualquer outra de suas propriedades. 8. O segundo controle Calendar herda suas propriedades de aparência da definição de capa que você fez no arquivo sampleTheme.) Para configurar um tema para um site 1.aspx. Alterne para o modo de origem e copie o elemento<asp:calendar> e seus atributos.skin.config. 4. Execute a página Default. Remova a propriedade ID da definição no arquivo sampleTheme. e clique Add New Item. <pages theme="sampleTheme" /> Observação Web.config. Salve o arquivo sampleTheme. selecione Web Configuration File. Adicione o elemento <pages> se ele ainda não existir. e arraste um segundo controle Calendar para a página.skin.web>.config se um não foi adicionado automaticamente ao seu site.aspx. e clique Add. Ambos os controles Calendar irão aparentar o mesmo. O primeiro controle Calendar reflete as configurações que você fez nas propriedades explicitamente. seguindo etapas seguintes: 1. (Se você desejar. clique com o botão direito do mouse no nome do site. O elemento <pages> deve aparecer dentro do elemento <system. Crie um arquivo Web. 4. que significa que você não precisa reaplicar o tema a páginas individuais.o o SelectedDayStyle-ForeColor TodayDayStyle-BackColor Observação Yellow Pink As características exatas que você definir não são importantes. ele substituirá qualquer tema especificado no seu arquivo Web.aspx. Pressione CTRL+F5 para executar Default. consulte COMO: aplicar temas ASP. Remova o atributo theme="themeName" da declaração de sua página.NET Programaticamente Visual Studio 164 .NET Criar seus próprios temas e capas. Se você optar por especificar um nome de tema na declaração de sua página.NET Usando temas com código.aspx e alterne para o modo de origem. Por exemplo. Para mais informações. 6.NET para temas oferece uma variedade de opções para adaptar do aspecto e percepção de um aplicativo inteiro. mas você pode estar interessado em aprender mais. Agora a página é exibida com o tema que você especificou no arquivo Web. Para mais informações.config. consulte Visão geral sobre temas e capas ASP. Alterne para Default. pode desejar aprender mais sobre: • • • Uso de temas em geral.config.5. Próximas etapas O suporte ASP. 7. Esta explicação passo a passo abordou algumas das noções básicas. consulte COMO: Definir temas ASP. Para mais informações. Permitir que os usuários personalizem o leiaute dos controles Web Parts na página. Caso contrário. Durante esta explicação passo a passo.NET. Para obter uma introdução geral a Web Parts. Em vários aplicativos da Web é útil ser capaz de alterar a aparência do conteúdo. você pode usar esse site como um ponto de partida para esta explicação passo a passo. Personalização de Web Parts é ativada por padrão e usa o provedor de personalização SQL (SqlPersonalizationProvider) do Microsoft SQL Server Express Edition para armazenar os dados de personalização. consulte Visão geral sobre Web Parts do ASP.NET e configurar o provedor de personalização SQL para se • • Visual Studio 165 .NET. você criará uma página que usa o conjunto de controles Web Parts para criar uma página da Web que o usuário pode modificar ou personalizar. você deve instalar e configurar um banco de dados de serviços de aplicativos ASP. Esta explicação passo a passo usa o Visual Studio. Permitir que os usuários selecionem um controle de um catálogo de controles Web Parts disponíveis. O recurso Web Parts do ASP. Esta explicação passo a passo usa o SSE e o provedor SQL padrão. Pré-requisitos Para concluir esta explicação passo a passo. As tarefas apresentadas nesta explicação passo a passo incluem: • • • • • Adicionar controles Web Parts a uma página. O SSE está disponível com o Microsoft Visual Studio 2005 como uma parte opcional da instalação ou como um download gratuito de Microsoft. Um ambiente de design visual para criar páginas da Web. a explicação passo a passo fornece instruções sobre como configurar seu site para identificá-lo por seu nome de conta de usuário do Windows.com.NET consiste de um conjunto de controles para criar páginas da Web que apresentam conteúdo modular e que permitem a usuários alterar a aparência e o conteúdo para atender a suas preferências. Permitir que os usuários editem a aparência de um controle Web Parts. vários dos quais são usados nesta explicação passo a passo. consulte Visão geral sobre controles Web Parts. Para uma visão geral dos componentes principais do conjunto de controles Web Parts. nenhuma configuração será necessária. bem como permitir que os usuários selecionem e organizem o conteúdo que desejam ver. Criar um controle de usuário personalizado e usá-lo como um controle Web Parts. Se você tiver o SSE instalado. Um provedor de personalização configurado e um banco de dados. será necessário: • Um site que possa identificar usuários individuais.Explicação passo a passo: Criando uma página Web Parts no Visual Web Developer Esta explicação passo a passo é uma demonstração prática dos componentes e tarefas essenciais para criar páginas da Web que usam controles Web Parts em uma ferramenta de design visual como o Microsoft Visual Studio. Se você tiver um site já configurado com participação (membership) do ASP. Para usar uma das versões completas do SQL Server. 5. Feche a página padrão e adicione uma nova página ao site. Segundo. Alterne para o modo de exibição Design. Posicione o ponto de inserção antes do caractere de nova linha. uma página Web Parts precisa de uma ou mais zonas. consulte Explicação passo a passo: Criar um site com associação (mebership) e login de usuário (Visual Studio). Se você já tiver um site configurado para usar associação (membership). Para criar uma página para conter controles Web Parts 1. Para obter mais informações sobre personalização. consulte Visão geral sobre personalização Web Parts. o ASP. crie um novo site da Web do ASP. 6. posicionando-o logo após o caractere de nova linha e antes das marcas <div>. para que suas configurações Web Parts possam ser mapeadas para você.aspx. certifique-se de que as opções Non-Visual Controls e Details estão selecionadas para que você possa ver marcas de layout e controles que não têm uma interface de usuário Coloque o ponto de inserção antes das marcas <div> na superfície de design e pressione ENTER para adicionar uma nova linha. então ele aparece como uma caixa cinza na superfície de design. você vai criar uma página que usa controles Web Parts para mostrar conteúdo estático. Para obter detalhes. chamada WebPartsDemo. Criar e configurar um site da Web Esta explicação passo a passo requer que você tenha uma identidade de usuário. é recomendável que você use esse site. que são controles compostos que contêm controles WebPart ou outros controles de servidor e ocupam uma região especificada de uma página. 4. consulte Criar e configurar o banco de dados de serviços de aplicativos para o SQL Server. 2. Selecione a opção Heading 1 na lista Block Format na barra de ferramentas. A primeira etapa para trabalhar com Web Parts consiste em criar uma página com dois elementos estruturais necessários.NET configura um provedor de personalização padrão para armazenar as configurações de personalização do usuário. esta é ativada por padrão para o conjunto de controles Web Parts. Visual Studio 166 . 3. Criando uma página simples com Web Parts Nesta parte da explicação passo a passo. A partir do menu View. O controle WebPartManager não gera nenhuma saída. adicione o texto Web Parts Demonstration Page. Para obter detalhes. Observação Você não precisa fazer nada para permitir personalização de Web Parts. Na primeira vez que executar uma página Web Parts em um site. uma página Web Parts precisa de um controle WebPartManager para controlar e coordenar todos os controles Web Parts. Primeiro. Caso contrário. Na guia WebParts da caixa de ferramentas. Para criar um novo site • No Visual Studio. você pode criar um novo site e usar seu nome de usuário do Windows atual como a identidade do usuário. arraste um controle WebPartManager para a página.NET.conectar a este banco de dados. No modo de exibição Design. Arraste um segundo controle WebPartZone para a coluna do meio da tabela e defina as seguintes propriedades: ID: MainZone HeaderText: Main 11. quer seja um controle Web Parts personalizado. Posicione o ponto de inserção nas marcas <div>. clique em OK e clique em OK novamente para criar a tabela. escolha Properties e defina as propriedades a seguir: ID: SidebarZone HeaderText: Sidebar 9. Para esta explicação passo a passo. clique em Insert Table e crie uma nova tabela que tenha uma linha e três colunas. você pode adicionar qualquer controle ASP. 4. Clique com o botão direito do mouse no controle WebPartZone. Clique no botão Cell Properties. 10. adicione algum texto como <h2>Welcome to my Home Page</h2>.NET trata o controle como um controle Web Parts em tempo de execução. A página agora tem duas zonas diferentes que você pode controlar separadamente. arraste um controle Label da guia Standard da caixa de ferramentas para a área de conteúdo da zona cuja propriedade ID estiver definida como MainZone. Observe que um elemento <zonetemplate> foi adicionado para ajustar o controle Label na MainZone. ao qual você está simplesmente adicionando texto estático. 8. você trabalhará com controles Web Parts que exibem apenas conteúdo estático. Salve o arquivo. então criar o conteúdo é a próxima etapa. Dentro do modelo da zona. Depois. um controle de usuário ou um controle de servidor já existente. Alterne para o modo de visualização Source. Remova o atributo Text="Label" do elemento <asp:label>.NET. No menu Layout. No entanto. o que habilita recursos Web Parts no controle. <asp:webpartzone id="MainZone" runat="server" headertext="Main"> <zonetemplate> <asp:label id="Label1" runat="server" title="Content"> <h2>Welcome to My Home Page</h2> </asp:label> </zonetemplate> </asp:webpartzone> 2. Quando você coloca um controle de servidor em uma zona WebPartZone. o ASP. O layout de uma zona Web Parts é especificado por um elemento <zonetemplate>. Adicione um atributo chamado title ao elemento <asp:label> e defina seu valor como Content. Seu código deve se parecer com o a seguir. Dentro do elemento <asp:label>. Para criar conteúdo para a zona principal 1. Arraste um controle WebPartZone para a coluna esquerda da tabela.7. Visual Studio 167 . crie um controle de usuário que também pode ser adicionado à página como um controle Web Parts. nenhuma das zonas tem qualquer conteúdo. Salve o arquivo. 3. Observe que aqui você está usando o controle Label. selecione top da lista drop-down Vertical align. Para criar um controle de usuário 1. Adicione um novo controle de usuário da Web ao seu site para servir como um controle de pesquisa denominado SearchUserControl.ascx, certificando-se que a opção Place source code in a separate file está desmarcada. Observação O controle de usuário para esta explicação passo a passo não implementa a funcionalidade de pesquisa de verdade; ele é usado somente para demonstrar os recursos Web Parts. 2. 3. 4. 5. 6. Alterne para o modo de exibição Design. Na guia Standard da caixa de ferramentas, arraste um controle TextBox para a página. Coloque o ponto de inserção após a caixa de texto que você adicionou e pressione ENTER para adicionar uma nova linha. Arraste um controle Button para a página na nova linha abaixo da caixa de texto que você adicionou. Alterne para o modo de exibição Source e certifique-se que o código fonte para o controle de usuário parece com o exemplo a seguir: C# <%@ control language="C#" classname="SearchUserControl" %> <asp:textbox runat="server" id=" TextBox1"></asp:textbox> <br /> <asp:button runat="server" id=" Button1" text="Search" /> 7. Salve e feche o arquivo. Observação de segurança Esse controle tem uma caixa de texto que aceita entrada do usuário, o que é uma ameaça potencial de segurança. Dados entrados pelo usuário em uma página da Web potencialmente pode conter scripts de cliente mal intencionados. Por padrão, páginas da Web do ASP.NET validam a entrada do usuário para garantir que a entrada não contenha elementos HTML ou script. Enquanto essa validação estiver ativada, você não precisa verificar explicitamente se há elementos HTML ou scripts nos dados entrados pelo usuário. Para mais informações, consulte Visão geral sobre scripts maliciosos. Agora você pode adicionar controles Web Parts à zona Sidebar. Você vai adicionar dois controles à zona Sidebar, um contendo uma lista de links e outro que é o controle de usuário que você criou no procedimento anterior. Os vínculos são adicionados como um controle de servidor padrão Label, semelhante ao modo com que você criou o texto estático para a zona principal. Entretanto, embora os controles de servidor individuais contidos no controle de usuário pudessem estar contidos diretamente na zona (como o controle de rótulo), nesse caso eles não estão. Em vez disso, eles fazem parte do controle de usuário que você criou no procedimento anterior. Isso demonstra uma maneira comum de empacotar controles e funcionalidade adicionais que você deseje em um controle de usuário e depois referenciar tal controle em uma zona como um controle Web Parts. Em tempo de execução, o conjunto de controles Web Parts envolve ambos os controles com controles GenericWebPart. Quando um controle GenericWebPart envolve um controle do servidor Web, o controle da parte genérica é o controle pai Visual Studio 168 e você pode acessar o controle de servidor através da propriedade ChildControl do controle pai. Esse uso de controles de parte genérica permite que controles de servidor da Web padrão tenham o mesmo comportamento básico e atributos que controles Web Parts que derivam da classe WebPart. Para adicionar controles Web Parts à zona da barra lateral 1. 2. 3. Abra a página WebPartsDemo.aspx. Alterne para o modo de exibição Design. Arraste a página de controle de usuário que você criou, SearchUserControl.ascx, do Solution Explorer para a zona cuja propriedade ID estiver definida como SidebarZone. Salve a página WebPartsDemo.aspx. Alterne para o modo de visualização Source. Dentro do elemento <asp:webpartzone> da SidebarZone, adicione um elemento <asp:label> com contendo links, adicione também um atributo Title com um valor de Search à marca de controle de usuário, conforme mostrado no exemplo a seguir: <asp:label runat="server" id="linksPart" title="My Links"> <a href="http://www.asp.net">ASP.NET site</a> <br /> <a href="http://www.gotdotnet.com">GotDotNet</a> <br /> <a href="http://www.contoso.com">Contoso.com</a> <br /> </asp:label> <uc1:SearchUserControl id="searchPart" runat="server" title="Search" /> </zonetemplate> </asp:WebPartZone> 7. Salve e feche o arquivo. Agora você pode testar sua página. Para testar a página • Carregue a página em um navegador. A página exibe as duas zonas. A tela a seguir mostra a página. Demonstração de Web Parts com duas zonas <asp:WebPartZone id="SidebarZone" runat="server" headertext="Sidebar"> <zonetemplate> 4. 5. 6. Na barra de título de cada controle há uma seta para baixo que fornece acesso a um menu de ações disponíveis que podem ser executadas em um controle. Clique no menu de verbos para um dos controles, clique no verbo Minimize e note que o controle é minimizado. No menu de verbos, clique em Restore e o controle retornará ao seu tamanho normal. Habilitando usuários para editar páginas e alterar layout Web Parts fornece a funcionalidade para usuários alterarem o layout de controles Web Parts arrastando-os de uma zona para outra. Além de permitir que os usuários movam controles WebPart de uma zona para outra, você pode permitir que usuários editem várias características dos controles, inclusive sua aparência, layout e comportamento. O conjunto de controles Web Parts fornece a funcionalidade básica para a edição de controles WebPart. Embora você não faça isso nesta explicação passo a passo, você também pode criar controles de edição personalizados que permitem que os usuários editem os recursos dos controles WebPart. Assim como alterar a localidade de um controle WebPart, editar as propriedades de um controle depende da personalização do ASP.NET para salvar as alterações feitas pelos usuários. Visual Studio 169 Nesta parte da explicação passo a passo, você adicionará o recurso que permite aos usuários editar as características básicas de qualquer controle WebPart em a página. Para ativar esses recursos, você adicionará outro controle de usuário personalizado à página, juntamente com um elemento <asp:editorzone> e dois controles de edição. Para criar um controle de usuário que permita modificações do layout da página 1. 2. 3. 4. 5. No Visual Studio, no menu File, clique em New e então em File. Na caixa de diálogo Add New Item, selecione Web User Control. Nomeie o novo arquivo DisplayModeMenu.ascx. Desmarque a caixa de opção Place source code in separate file. Clique em Add para criar o novo controle. Alterne para o modo de visualização Source. Remova todo o código existente no novo arquivo e cole neste o código a seguir. Este código de controle de usuário usa recursos do conjunto de controles Web Parts para permitir que uma página tenha seu modo de exibição ou visualização alterado, e também permite que você altere a aparência física e o layout da página quando estiver em certos modos de exibição. C# <%@ control language="C#" classname="DisplayModeMenuCS"%> <script runat="server"> // Use a field to reference the current WebPartManager control. WebPartManager _manager; void Page_Init(object sender, EventArgs e) { Page.InitComplete += new EventHandler(InitComplete); } void InitComplete(object sender, System.EventArgs e) { _manager = WebPartManager.GetCurrentWebPartManager(Page); String browseModeName = WebPartManager.BrowseDisplayMode.Name; // Fill the drop-down list with the names of supported display modes. foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes) { String modeName = mode.Name; // Make sure a mode is enabled before adding it. if (mode.IsEnabled(_manager)) { ListItem item = new ListItem(modeName, modeName); DisplayModeDropdown.Items.Add(item); } } // If Shared scope is allowed for this user, display the // scope-switching UI and select the appropriate radio // button for the current user scope. if (_manager.Personalization.CanEnterSharedScope) { Panel2.Visible = true; if (_manager.Personalization.Scope == PersonalizationScope.User) RadioButton1.Checked = true; else RadioButton2.Checked = true; } } // Change the page to the selected display mode. void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e) { String selectedMode = DisplayModeDropdown.SelectedValue; WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode]; if (mode != null) _manager.DisplayMode = mode; } // Set the selected item equal to the current display mode. void Page_PreRender(object sender, EventArgs e) { ListItemCollection items = DisplayModeDropdown.Items; int selectedIndex = items.IndexOf(items.FindByText(_manager.DisplayMode.Name)); DisplayModeDropdown.SelectedIndex = selectedIndex; } // Reset all of a user's personalization data for the page. protected void LinkButton1_Click(object sender, EventArgs e) { _manager.Personalization.ResetPersonalizationState(); } // If not in User personalization scope, toggle into it. protected void RadioButton1_CheckedChanged(object sender, EventArgs e) { if (_manager.Personalization.Scope == PersonalizationScope.Shared) _manager.Personalization.ToggleScope(); } // If not in Shared scope, and if user has permission, toggle // the scope. protected void RadioButton2_CheckedChanged(object sender, EventArgs e) { if (_manager.Personalization.CanEnterSharedScope && _manager.Personalization.Scope == PersonalizationScope.User) _manager.Personalization.ToggleScope(); } </script> <div> Visual Studio 170 <asp:Panel ID="Panel1" runat="server" Borderwidth="1" Width="230" BackColor="lightgray" Font-Names="Verdana, Arial, Sans Serif" > <asp:Label ID="Label1" runat="server" Text="&nbsp;Display Mode" Font-Bold="true" Font-Size="8" Width="120" /> <asp:DropDownList ID="DisplayModeDropdown" runat="server" AutoPostBack="true" Width="120" OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" /> <asp:LinkButton ID="LinkButton1" runat="server" Text="Reset User State" ToolTip="Reset the current user's personalization data for the page." Font-Size="8" OnClick="LinkButton1_Click" /> <asp:Panel ID="Panel2" runat="server" GroupingText="Personalization Scope" Font-Bold="true" Font-Size="8" Visible="false" > <asp:RadioButton ID="RadioButton1" runat="server" Text="User" AutoPostBack="true" GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" /> <asp:RadioButton ID="RadioButton2" runat="server" Text="Shared" AutoPostBack="true" GroupName="Scope" OnCheckedChanged="RadioButton2_CheckedChanged" /> </asp:Panel> </asp:Panel> </div> 6. Salve o arquivo, clicando no ícone de gravação na barra de ferramentas, ou selecionando Save no menu File. Para permitir que os usuários alterem o layout 1. 2. 3. Abra a página WebPartsDemo.aspx. Alterne para o modo de exibição Design. Posicione o ponto de inserção imediatamente após o controle WebPartManager que você adicionou anteriormente. Digite ENTER para criar uma linha em branco após o controle WebPartManager. 4. 5. 6. 7. Arraste o controle de usuário recém-criado (DisplayModeMenu.ascx) para a página WebPartsDemo.aspx e solte-o na linha em branco. Arraste um controle EditorZone da seção WebParts da caixa de ferramentas para a célula aberta restante da tabela na página WebPartsDemo.aspx. A partir da seção WebParts da caixa de ferramentas, arraste um controle AppearanceEditorPart e um controle LayoutEditorPart para o controle EditorZone. Alterne para o modo de visualização Source. O código resultante na célula da tabela deve ter aspecto semelhante ao do código a seguir. <td valign="top"> <asp:EditorZone ID="EditorZone1" runat="server"> <ZoneTemplate> <asp:AppearanceEditorPart ID="AppearanceEditorPart1" runat="server" /> <asp:LayoutEditorPart ID="LayoutEditorPart1" runat="server" /> </ZoneTemplate> </asp:EditorZone> </td> Observação Embora os controles AppearanceEditorPart e LayoutEditorPart sejam usados nesta explicação passo a passo, os controles PropertyGridEditorPart e BehaviorEditorPart não são, pois eles requerem configurações além do escopo desta explicação passo a passo. 8. Grave o arquivo WebPartsDemo.aspx. Você criou um controle de usuário que permite que você altere os modos de exibição e o layout da página e você referenciou o controle na página da Web primária. Agora você pode testar a funcionalidade de editar páginas e alterar layout. Visual Studio 171 Para testar alterações de layout 1. 2. 3. Carregue a página em um navegador. No menu Display Mode, clique em Edit. Os títulos de zona são exibidos. Arraste o controle My Links pela sua barra de título a partir da zona Sidebar para a parte inferior da zona Main. Sua página deve ter aspecto como o da seguinte tela: Demonstração de página Web Parts com o controle My Links movido 4. Clique em Display Mode, e depois clique em Browse. A página será atualizada, os nomes de zona desaparecem e o controle My Links permanecerá onde você o posicionou. 5. 6. Para demonstrar que a personalização está funcionando, feche o navegador, e em seguida, carregue a página novamente. As alterações feitas são salvas para sessões futuras do navegador. No menu Display Mode, clique em Edit. Agora cada controle na página é exibido com uma seta para baixo na sua barra de título, a qual contém o menu drop-down de verbos. 7. 8. Clique na seta para exibir o menu de verbos sobre o controle My Links, e então clique em Edit. O controle EditorZone aparecerá, exibindo os controles EditorPart que você adicionou. Na seção Appearance do controle de edição, altere o Title para My Favorites. Na lista Chrome Type, selecione Title Only e, em seguida, clique em Apply. A tela a seguir mostra a página no modo de edição Demonstração de página Web Parts no modo de edição 9. Clique no menu Display Mode, depois clique em Browse para retornar para o modo de navegação. O controle agora tem um título atualizado e nenhuma borda, como mostrado na tela a seguir. Demonstração de página Web Parts editada Adicionar Web Parts em tempo de execução Você também pode permitir que usuários adicionem controles Web Parts à suas páginas em tempo de execução. Para fazer isso, configure a página com um catálogo Web Parts, que contém uma lista dos controles Web Parts que você deseja tornar disponíveis para os usuários. Observação Nesta explicação passo a passo, você criará um modelo contendo os controles FileUpload e Calendar. Isso permitirá que você teste a funcionalidade básica do catálogo, mas os controles Web Parts resultantes não têm qualquer funcionalidade real. Se você tiver uma página da Web ou controle de usuário personalizados, você pode substituir o conteúdo estático por eles. Para permitir que os usuários adicionem Web Parts em tempo de execução 1. Abra a página WebPartsDemo.aspx. Visual Studio 172 2. 3. Alterne para o modo de exibição Design. Na guia WebParts da caixa de ferramentas, arraste um controle CatalogZone para a coluna direita da tabela, sob o controle EditorZone. Ambos os controles podem estar na mesma célula da tabela pois eles não serão exibidos ao mesmo tempo. 4. 5. 6. 7. 8. No painel Properties, atribuia a seqüência Add Web Parts para a propriedade HeaderText do controle CatalogZone. A partir da seção WebParts da caixa de ferramentas, arraste um controle DeclarativeCatalogPart para a área de conteúdo do controle CatalogZone. Clique na seta no canto direito superior do controle DeclarativeCatalogPart para expor seu menu Tasks, e selecione Edit Templates. A partir da seção Standard da caixa de ferramentas, arraste um controle FileUpload e um controle Calendar para a seção WebPartsTemplate do controle DeclarativeCatalogPart. Alterne para o modo de visualização Source. Inspecione o código fonte do elemento <asp:catalogzone>. Observe que o controle DeclarativeCatalogPart contém um elemento <webpartstemplate> com os dois controles de servidor incluídos que você poderá adicionar à sua página a partir do catálogo. Observação Se você tiver um controle personalizado, este é o local para substituir um dos controles servidor do exemplo por ele, embora isso necessite de etapas além do escopo desta explicação passo a passo. Para obter mais detalhes, consulte o exemplo de código na documentação para a classe WebPart. 9. Adicione uma propriedade Title a cada um dos controles adicionados ao catálogo, usando o valor de seqüência de caracteres mostrado para cada título no exemplo de código abaixo. Embora o título não seja uma propriedade que normalmente você possa definir nesses dois controles de servidor em tempo de design, quando um usuário adiciona esses controles a uma zona WebPartZone a partir do catálogo em tempo de execução, eles são empacotados por um controle GenericWebPart. Isso permite que eles atuem como controles Web Parts, portanto, eles poderão exibir títulos. O código para os dois controles contidos no controle DeclarativeCatalogPart devem ter aspecto como a seguir. <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" runat="server"> <WebPartsTemplate> <asp:Calendar ID="Calendar1" runat="server" title="My Calendar" /> <asp:FileUpload ID="FileUpload1" runat="server" title="Upload Files" /> </WebPartsTemplate> </asp:DeclarativeCatalogPart> 10. Salve a página. Agora você pode testar o catálogo. Para testar o catálogo Web Parts 1. 2. 3. Carregue a página em um navegador. No menu Display Mode, clique em Catalog. O catálogo intitulado Add Web Parts é exibido. Arraste o controle My Favorites da zona Main de volta para o parte superior da zona Sidebar. Visual Studio 173 4. 5. No catálogo Add Web Parts, selecione as duas caixas de seleção e então selecione Main na lista de zonas disponíveis. Clique em Add no catálogo. Os controles são adicionados à zone Main. Se você desejar, você pode adicionar várias ocorrências dos controles do catálogo à sua página. As telas a seguir mostram a página com o controle de envio de arquivo e o calendário na zona Main: Controles adicionados à zona Main do catálogo 6. 7. No menu Display Mode, clique em Browse. O catálogo desaparece e a página é atualizada. Feche o navegador e carregue a página novamente. As alterações feitas vão persistir. Próximas etapas Esta explicação passo a passo ilustrou os princípios básicos do uso de controles Web Parts simples em um página da Web do ASP.NET. Você pode desejar testar recursos Web Parts adicionais, mais sofisticados. Sugestões para explorações adicionais incluem: • Criar controles Web Parts que ofereçam funcionalidades mais sofisticadas que as Web Parts estáticas desta explicação passo a passo. Você pode criar controles Web Parts como controles de usuário ou controles personalizados. Para obter detalhes, consulte a documentação para a classe WebPart. Visual Studio 174 Proteger uma ou mais páginas em seu aplicativo para que somente os usuários autorizados possam vê-las. o aplicativo deve solicitar um nome e uma senha para o usuário. Acesso a um servidor de email que pode encaminhar mensagens de email. Se você estiver usando o Microsoft Windows XP ou Windows Server 2003. se você estiver usando o Microsoft Windows 2000.NET e serviços de associação do ASP.NET e como definir os usuários. (O servidor não precisa ter capacidade para receber mensagens. um servidor de email que é adequado para esta explicação passo a passo. Criando o Site Web • Se você já criou um site Web no Microsoft Visual Studio (por exemplo.NET para criar um aplicativo que executa todas essas tarefas. consulte o artigo "Instalação do Microsoft Data Access Components (MDAC)" na biblioteca MSDN. trabalhando com o tópico Explicação Passo a Passo: Criando uma Página Web Básica no Visual Web Developer). consulte HOW TO: Instalar e Configurar Servidores Virtuais SMTP em IIS. Microsoft Data Access Components (MDAC) versão 2. Para mais informações. você já tem MDAC 2.) O IIS inclui o servidor virtual Default SMTP. Microsoft Internet Information Services (IIS) instalado localmente em seu computador. As tarefas ilustradas nesta explicação passa a passo incluem: • • • • • Configurar um aplicativo para incluir os serviços de associação do ASP.7. Entretanto. Permitir que usuários novos se registrem em seu site.Explicação Passo a Passo: Criando um Site Web com Associação e Login de Usuário (Visual Studio) Um requisito comum para sites Web é permitir que somente alguns membros ou outros usuários autenticados vejam determinadas páginas. consulte Introdução a Associação. Para obter mais informações. O aplicativo também deve incluir uma maneira para ocultar informações de usuários anônimos (usuários que não estão autorizados). Visual Studio 175 . crie um novo site Web e uma página seguindo estas etapas. Nesse caso. Permitir que os membros alterem e redefinam suas senhas. Usar os controles de login para obter credenciais de usuário e exibir informação para os usuários autorizados. Se você estiver trabalhando em uma rede local. Pré-requisitos Para concluir esta explicação passo a passo. você pode precisar atualizar o MDAC já instalado no seu computador.7 ou posterior. Esta explicação passo a passo mostra como usar os controles do ASP. você pode usar esse site Web e ir para "Configurando Associação" posteriormente nesta explicação passo a passo. Para obter mais informações sobre configuração do servidor. contate o seu administrador de rede para obter informação sobre o acesso a um servidor de email. você precisará de : • • • MIcrosoft Visual Web Develper. Caso contrário. 2. você definirá um único usuário. Clique no ícone Create New Web Application ( ) acima da lista de sites Web e em seguida. Para criar um usuário da associação 1. No Solution Explorer. 7. Você pode usar a ferramenta Web Site Administration. clique em New Web Site. Sob oVisual Studio installed templates.aspx. 10. mas você pode definir as linguagens de programação para cada página individualmente. 2. e em seguida. A caixa de diálogo Choose Location fecha. 5. Clique em Browse. A linguagem de programação que você escolher será o padrão para seu site Web. Na caixa Languages. clique com o botão direito do mouse no nome do seu site Web e clique em New Folder. clique em ASP. Selecione o guia Security. A caixa de diálogo New Web Site aparece. No menu File. Clique em OK na caixa de diálogo New Web Site. No menu Website.NET. selecione HTTP. Você deve criar o subdiretório agora para que você possa configurar a segurança para ele posteriormente na explicação passo a passo. 2. Nomear uma pasta MemberPages. Para esta explicação passo a passo. A caixa de diálogo Choose Location aparece. selecione o ASP. Para adicionar uma nova pasta ao site Web 1. 3. 3. 8.Para criar um site Web local no IIS 1.NET Web Site. clique o link para Use the security Setup Wizard to configure security step by step. Na caixa de listagem Location . 9.NET Configuration. Abra o Local Web Servers. 6. Configurando a Associação Posteriormente nesta explicação passo a passo você colocará páginas em um subdiretório protegido. Visual Studio 176 . que fornece uma interface do tipo assistente para realizar esta configuração. Abrir o Visual Studio. 4. Antes de você trabalhar com a associação do ASP. O Visual Web Developer cria o site Web e uma nova página chamada Default. clique a linguagem de programação com a qual você prefere trabalhar. Clique em Open. Selecione Local IIS. Selecione o Default Web Site. nomeie a associação do novo site Web. você deve configurar seu aplicativo para ativar a associação e configurar os usuários. 11. clique em Next Vá para a etapa 2 do assistente e selecione a opção From the Internet. Nesta parte da explicação. Clique em Next. 4. O assistente exibe uma opção para criar funções. 5. No assistente. O assistente exibe uma página que permite que você crie regras de acesso. 7. se você precisar redefinir sua senha. Esta opção especifica que seu aplicativo usará a autenticação Forms. onde os usuários poderão efetuar o login em seu aplicativo usando uma página de login que você criará nesta explicação passo a passo posteriormente. portanto você precisa de um endereço de e-mail legítimo. 6. expanda o nó para o seu site Web. 2. Use os seguintes valores como diretrizes (você pode utilizar quaisquer valores. O assistente exibe uma página onde você pode criar novos usuários. Portanto. a pasta que você criou anteriormente. você criará uma regra em que somente os usuários autorizados poderão acessar as páginas daquela pasta. o o o o 8. Clique em Next. Clique em Next. Posteriormente na explicação passo a passo.O assistente exibe uma página onde você pode selecionar o método de autenticação que seu site Web usará. Para configurar as regras de acesso para o subdiretório MemberPages 1. Password Uma senha. na explicação passo a passo. a informação da associação é armazenada em um arquivo de banco de dados do Microsoft SQL Server Express na pasta App_Data do seu site Web. Na caixa Add New Access Rule. não selecione a caixa de seleção Enable roles for this web site. O assistente exibe uma mensagem indicando que a informação do usuário será armazenada usando o Advanced provider settings. Insira a informação que define um usuário de seu aplicativo. você enviará para si uma mensagem. Clique em Create User. E-mail Seu endereço de e-mail pessoal. Visual Studio 177 . 3. Selecione MemberPages. Security Questione Security Answer Digite uma questão e responda o que pode ser usado mais tarde. Mais tarde nesta explicação passo a passo você executará essa etapa separadamente. mas certifique-se de anotar as suas entradas para a explicação passo a passo posterior): User Name Seu nome (sem espaços) ou um nome simples. você criou uma pasta chamada MemberPages. O assistente exibe uma página de confirmação. clique em Next. pontuação e que tenha pelo menos oito caracteres). Observação Deixe a ferramenta Web Site Administration aberta. Anteriormente. Por padrão. Uma senha segura é necessária (uma que inclua letras maiúsculas e minúsculas. 6. 3.4. 4. clique em OK. 7.config não aparecerá no Solution Explorer até você atualizar a exibição. No SMTP Settings. Clique em Add This Rule. clique em Configure SMTP e-mail settings. O IIS inclui o servidor virtual Default SMTP como um componente opcional. Para configurar o aplicativo para usar um servidor SMTP específico 1.config (se já não existir um) com as configurações que você fez. Quando os usuários solicitam uma página do subdiretório MemberPages.config do site Web. contate o seu administrador de rede para obter informação sobre o acesso a um servidor de e-mail. Na caixa From. Se você estiver trabalhando em uma rede local. Configurando o Aplicativo para E-mail Para parte desta explicação passo a passo. Você pode fazer uma entrada em seu arquivo Web. o aplicativo precisa ser ativado para enviar mensagens de e-mail. Para enviar mensagens. as regras são verificadas para determinar se o usuário tem permissão de acesso para a página. Clique em Finish. usuários que não estejam autorizados. A regra que você está criando nega acesso a usuários anônimos — ou seja. Agora você terminou a configuração com o assistente. seu aplicativo deve ter acesso a um servidor Simple Mail Transport Protocol (SMTP). caso contrário. selecione Anonymous users. digite localhost como o Server Name. clique na guia Application. digite um endereço de e-mail válido. 5. Clique em Save e na a página de confirmação. que encaminha mensagens de e-mail do seu aplicativo para um destinatário de email. A nova regra é exibido na grade abaixo. consulte HOW TO: Instalar e Configurar os Servidores Virtuais SMTP no IIS. Na ferramenta Web Site Administration. que é adequado para esta explicação passo a passo. Inclua informação para o número da porta e para a autenticação de acordo com os requisitos do seu servidor SMTP. A ferramenta Web Site Administration cria um arquivo Web. A ferramenta exibe uma página onde você pode configurar e-mail. Visual Studio 178 . Para obter mais informações sobre como configurar este servidor. Consulte o seu administrador para obter mais informações sobre como configurar estas opções. Depois de ter configurado ou determinado como acessar um servidor SMTP. 2. Em Permission. Ele fecha e você retorna para a guia Security da ferramenta Web Site Administration. selecione Deny. 5. Se você está usando o servidor virtual SMTP que está em seu computador. Em Rule applies to. Observação O arquivo Web. digite o nome do servidor apropriado. você deve configurar seu aplicativo para rotear as mensagens de e-mail para o servidor. que contém uma série de configurações que determinam como o seu aplicativo executa. 6. Feche a ferramenta Web Site Administration. Para obter a identidade do usuário. você criará esta página de login. O controle Login é um controle único que solicita e valida as credenciais do usuário. 2. A partir do grupo Login do Toolbox. Adicione um Web Form chamado Login.é preciso que o usuário execute o login. você adicionará um link na página que leva os usuários para uma página de login. Exibindo os Erros de Login O controle Login inclui validação para ajudar os usuários a inserir informações corretas. Quando os usuários clicam neste controle. o aplicativo exibe uma página de login.aspx do seu site. A partir do grupo Login do Toolbox. use a lista drop-down Block Format para formatar o texto como "Heading 1". 3. 4. alterne para o modo Design. Abra ou alterne para a página Default. um controle validator exibe um asterisco (*) ao lado da caixa Password.aspx. Visual Studio 179 . Por padrão. Por exemplo. na barra de ferramenteas Formatting. Digite um texto estático como Welcome to our site e. se um usuário ignora a senha. 2. Você pode fornecer informações mais completas para erros de login adicionando um controle ValidationSummary para a página. Para criar uma página de login 1. Para criar uma página com um botão de login 1. autenticação de formulários é configurada para trabalho com uma página com este nome. arraste um controle Login para a página. você pode adicionar uma ou usar uma página diferente. clique com o botão direito do mouse em seu aplicativo Web e selecione Add New Item. você pode alterar a página de login padrão — a página para a qual os usuários são redirecionados — no arquivo Web. Agora você pode criar a página de login. Autorizando o Usuário Como parte do seu aplicativo.aspx. Na página Login. e então. arraste um controle LoginStatus para a página. você precisa estabelecer a identidade do usuário para que o aplicativo possa realizar ações — como mostrar ou ocultar informação — com base em quem é o usuário. (Se você não tem uma página Default. o controle LoginStatus é desenhado como um link. Nesta explicação passo a passo.aspx. Embora você não vá fazer isso nesta explicação. a página deve ter o nome de Login. No Solution Explorer.aspx em seu site Observação Para esta explicação passo a passo. Por padrão. 3.config.) Alterne para o modo Design. Os usuários anônimos verão uma mensagem genérica convidando-os a executar o login. Este modelo permite que você defina o conteúdo que os usuários verão antes de se conectarem. Clique no link Login. A partir do gupo Login do Toolbox. 4. Para testar o login 1. Os usuários conectados verão uma mensagem de boas vindas com seu nome autorizado. Isso configura o site para que. Na área de edição do modelo Anonymous Template do controle LoginView. 2. 2. No painel LoginView Tasks.aspx) aparece no navegador. digite Você não está autorizado. 3. Exibindo Informações para os Usuários Autorizados Agora você modificará a página para personalizar a exibição se o usuário estiver conectado. A ???home page??? (Default. A partir do grupo Login do Toolbox. Alterne para ou abra a página Default. Clique na área de edição do controle LoginView para ativar a edição. digite Você está autorizado. O controle LoginView é exibido com seu modelo AnonymousTemplate aberto. clique com o botão direito do mouse no título do controle LoginView e selecione Show Smart Tag. 2. arraste um controle ValidationSummary para a página. clique com o botão direito do mouse em Default. Se você não conseguir ver o painel LoginView Tasks. A partir do grupo Validation do Toolbox..aspx e clique em Set As Start Page. ao executar o site Web. arraste um controle LoginView para a página. e em seguida.aspx apareça primeiro. 5. 3. na lista Views. 7.aspx. defina a propriedade ValidationGroup para Login1. A página de login que você criou é exibida.Para exibir erros de login detalhados 1. Na janela Properties do controle ValidationSummary. Bem-vindo. Clique no link Login para entrar. clique em LoggedInTemplate. Agora você está definindo o conteúdo que será exibido aos usuários que já estão autorizados. arraste o controle LoginName para o modelo após o texto. Clique na área de edição do controle LoginView para ativar a edição. 6. Pressione CTRL+F5 para executar o site Web. Testando o Login Agora você pode testar a funcionalidade de login do seu aplicativo. a página Default. Visual Studio 180 . Para personalizar a exibição para usuários conectados 1. No Solution Explorer. mostrando o link Login e a mensagem genérica. que é o padrão de identificação do controle Login que você adicionou anteriormente. provavelmente. e a mensagem de boas-vindas que você definiu para o usuário autorizado.aspx. Para criar a página Exclusiva 1.aspx para apontar para a página que você criou anteriormente. defina a propriedade Text para o Members page e a propriedade NavigateUrl para o ~/MemberPages/Members. Limitando o Acesso para Páginas Exclusivas Uma tarefa comum em muitos sites Web é configurar páginas para que somente usuários autorizados podem visualizar. Dessa forma. arraste um controle HyperLink para a página. colocar o link da página exclusiva no modelo conectado do controle LoginView. o seu nome de usuário. 2. membros!. Se você inseriu credenciais corretas. Feche o navegador. e adicione uma nova Web Form chamada Members. Para adicionar um link para a página exclusiva 1. 3. 2. você tornará o link disponível para todos os usuários para que você possa ver o efeito das tentativas fracassadas de exibir uma página excluvisa. Alterne para ou abra a página Default. adicione um texto para a página. Em um aplicativo real. contanto que você seja capaz de reconhecer esta página. Visual Studio 181 . clique com o botão direito do mouse na pasta MemberPages. como Bem-vindo. A partir do grupo Standard do Toolbox. Para esta explicação. Agora você pode adicionar um link para a página exclusiva.4. Digite o nome de login do usuário que você criou anteriormente na explicação passo a passo. Na janela Properties para o controle HyperLink. acessando-a como um usuário anônimo ou como um usuário conectado. Testando a Página Exclusiva Você pode testar a página excluvisa. Anteriormente na explicação passo a passo. entretanto. 6. e depois. você adicionará uma página ao subdiretório protegido e testará a regra de acesso. clique em Log In. Observação Certifique-se de criar a página na pasta MemberPages. você criou o subdiretório MemberPages e criou uma regra que limita o acesso a páginas no subdiretório. Nesta seção da explicação. (Não entre ainda com uma senha. você retornada para a página inicial.) Um asterisco (*) é exibido ao lado da caixa Password e uma mensagem de erro é exibida no controle ValidationSummary. No modo Design. e depois clique em Log In. os visitantes de seu site não veriam o link até eles estarem autorizados. O texto exato não faz diferença.aspx. clique em Add New Item. você deve. No Solution Explorer. 5. Digite tanto um nome de usuário e uma senha. A página agora exibe um link Logout. os usuários têm permissão para se registrarem. Para criar uma página de registro 1. Para iniciar. se você estiver criando usuários para uma equipe pequena. alterne para o modo Design e digite um texto estático. 3. Você é redirecionado para a página Login. defina a propriedade Text para Home e a propriedade NavigateUrl para ~/Default. Isso configura o controle para que a execução retorne para a home page. Entretando.aspx porque o acesso para a página para membros foi negada para usuários anônimos. Na página Register.NET inclui o controle CreateUserWizard que executa a mesma tarefa que você executou anteriormente usando a ferramenta Web Site Administration. 5.aspx. Na barra de ferramentas Formatting.aspx aparece no navegador. digite o nome de usuário e a senha que você utilizou anteriormente na explicação passo a passo para se conectar.aspx. defina a propriedade ContinueDestinationPageUrl para ~/Default. use a lista drop-down Block Format para formatar o texto como "Heading 1". 3. A partir do grupo Login do Toolbox. você adicionará um recurso que permite aos usuários se registrarem em seu site Web. No Solution Explorer. clique no link Members page. você criará uma página de registro. Visual Studio 182 . 4. Pressione CTRL+F5 para executar o site Web. Na janela Properties para o controle CreateUserWizard. arraste um controle CreateUserWizard para a página. O ASP. Em vez disso. Essa estratégia é útil se você estiver trabalhando com uma lista de usuários pequena. em muitos sites Web. como Registro. clique com o botão direito do mouse no nome do seu site Web. 2.aspx. A partir do grupo Standard do Toolbox. para a página. Quando a página Default. Na janela Properties para o controle HyperLink. clique em Add New Item e adicione uma nova Web Form chamada Register.aspx porque o nome de usuário que você utilizaou foi autorizado para acessar a página. assim que os usuários clicarem em Continue após a criação de um usuário. Observação Certifique-se de criar a página na raiz do site Web e não na pasta MemberPages. você criou um usuário com a ferramenta Web Site Administration. 2. Na página de login. Feche a janela do navegador. arraste um controle HyperLink para a página. 4. Você é redirecionado para a página Members.Para testar a página Excluvisa 1. por exemplo. Criando Novos Usuários Na primeira parte da explicação passo a passo. . não faça o login. Nesta parte da explicação passo a passo.aspx. 5. No painel LoginView Tasks. 2. não da propriedade AnonymousTemplate. Alterando Senhas Eventualmente os usuários podem querer alterar suas senhas e é freqüentemente impraticável executar essa tarefa de forma manual.aspx. suponha que você deseja exibir o link de registro somente para os usuários que não estão autorizados. você adicionará uma página onde os usuários conectados podem alterar suas senhas. Na janela Properties para o controle HyperLink. você pode usar um outro controle do ASP. Alterne para ou abra a página Default. e selecione Show Smart Tag. defina a propriedade Text para Register e a propriedade NavigateUrl para Register. 6. 7. A partir do grupo Standard do Toolbox. os usuários devem conhecer sua senha atual. Observe que o link Login foi alterado para Logout e que a informação exibida no controle Login é da propriedade LoggedInTemplate. 2. 3. Clique o botão Continue. Pressione CTRL+F5 para executar o site Web e exibir a página Default.) Clique em Create User.NET para permitir que os usuários alterem suas próprias senhas.Agora você pode adicionar um link para a home page que exibe a página de registro. Clique no link Logout. Clique com o botão direito do mouse no controle LoginView adicionado anteriormente. Insira as credenciais para o usuário que você acabou de criar. 9. Por você não estar conectado. Portanto. Feche a janela do navegador. a página contendo o link Register é exibida. A página de registro é exibida. digite um novo nome de usuário. um endereço de e-mail e uma pergunta de segurança e de resposta. A página muda para exibir a informação para os usuários anônimos.aspx. Um mensagem de confirmação é exibida. Para alterar uma senha. Você está conectado como o novo usuário. 8. Nas caixas de texto. Agora você pode testar o processo de registro. O link Register será exibido somente para os usuários que não estão autorizados. Clique no link Login. Visual Studio 183 . Você retorna para a home page como um usuário autorizado. Nesta explicação passo a passo. (Todas as cinco peças de informação são necessárias. 3. uma senha forte. Para testar o registro 1. arraste um controle HyperLink para um modelo anônimo. Clique no link Register. Para esta explicação. 4.aspx. Para criar um link de registro na home page 1. selecione AnonymousTemplate da caixa de listagem Views para ativar a edição no modelo anônimo. aspx. Na janela Properties para o controle ChangePassword. clique com o botão direito do mouse na pasta MemberPages. Observação Certifique-se de criar a página na pasta MemberPages. clique em Add New Item e adicione uma nova Web Form chamada ChangePassword. Na página ChangePassword. 2. sendo o oposto do link Register que você criou anteriormente. Isso configura o controle para que. 2. Alterne para ou abra a página Default. O link Change password será exibido somente aos usuários que estão conectados. Para testar a alteração de senha 1.Para criar uma página de alteração de senha 1. na lista Views. Quando você tiver terminado. 3.aspx. 3. No Solution Explorer. No menu LoginView Tasks. Visual Studio 184 . Isso alterna o controle LoginView para o modo de edição para o conteúdo que será exibido para usuários que estão conectados. alterne para o modo Design e digite um texto estático como Alterar Senha. use a lista drop-down Block Format para formatar o texto como "Heading 1". você retorna para a home page como um usuário autorizado.aspx. Agora você pode adicionar um link para a home page que exibe a página de alteração de senha.aspx. 5. Você está colocando a página na pasta Members-Only porque somente os usuários autorizados podem alterar suas senhas.aspx. Clique com o botão direito do mouse no controle LoginView e depois clique em Show Smart Tag. quando os usuários clicarem em Continue após alterar uma senha. arraste um controle HyperLink para a região de edição. clique no link Login e se conecte como um dos usuários que você criou. Para criar um link de alteração de senha na home page 1. defina a propriedade Text para Change password e a propriedade NavigateUrl para ~/MemberPages/ChangePassword. arraste um controle ChangePassword para a página. A partir do grupo Standard do Toolbox. Clique no link Change password.aspx. Na janela Properties para o controle HyperLink. o controle retorne para a home page. Na barra de ferramentas Formatting. Pressione CTRL+F5 para executar o site Web. 3. Na página Default. clique em LoggedInTemplate. defina a propriedade ContinueDestinationPageUrl para ~/Default. 4. Você disponibilizará o link apenas aos usuários que estão conectados. 6. Agora você pode testar o processo de alteração de senha. A partir do grupo Login do Toolbox. 2. aspx. os usuários esquecerão suas senhas. 8. Você pode enviar aos usuários uma nova senha. para essa parte da explicação. que eles podem alterar usando a página de alteração de senha que você criou anteriormente. Para sites de alta segurança. Feche a janela do navegador. Observação A recuperação de senha requer que o seu site Web possa enviar mensagens de e-mail. Clique no link Login. No Solution Explorer. como o Secure Sockets Layer (SSL). Observação • Retornando uma senha em texto não criptografado usando e-mail não é recomendado para sites que requerem um nível alto de segurança. 5. digite a senha antiga e uma nova senha. Na barra Visual Studio 185 . seu site Web enviará aos usuários uma nova senha. clique com o botão direito do mouse no nome do seu site Web. 7.aspx. Na página RecoverPassword.NET protege senhas por hashing. Esta opção requer que o site armazene a senha usando criptografia reversível. Observação Certifique-se de criar a página na raiz do site Web. clique em Logout. Recuperando uma Senha Ocasionalmente. é recomendável que você retorne senhas usando criptografia. A recuperação de senha pode ter duas formas: • Você pode enviar aos usuários a senha que eles selecionaram (ou a que você criou para eles quando você configurou o site). o sistema de associação do ASP. Na home page. 6. 9. Você pode adicionar uma página de recuperação de senha ao seu site Web para que eles possam efetuar novamente a conexão para seu site. Para adicionar recuperação de senha 1. e depois clique em Change Password. Digite a nova senha. não na pasta MemberPages.4. Essa opção é útil se o site Web armazena senhas usando um esquema de criptografia não reversível como hashing. 2. alterne para o modo Design digite um texto estático como Redefinir minha senha para um novo valor. o que significa que as senhas não podem ser recuperadas. Você está conectado com a nova senha. clique em Add New Item e adicione uma nova Web Form chamada RecoverPassword. Se você não consegue configurar o seu site Web para enviar email (conforme explicado em "Configurando o Aplicativo para E-mail" anteriormente). Clique em Continue. Por padrão. não conseguirá adicionar uma recuperação de senha ao seu site. Portanto. Na página de alteração de senha. A partir do grupo Standard do Toolbox. 3. 4. arraste um controle HyperLink para um modelo.aspx. A página RecoverPassword. 2. arraste um controle PasswordRecovery para a página. Por padrão. A partir do grupo Standard do Toolbox. Altere o provedor da associação de provedor Access padrão para um provedor SQL. Clique com o botão direito do mouse no controle LoginView e depois clique em Show Smart Tag. Na janela Properties para o controle HyperLink. Você pode criar páginas e aplicativos mais sofisticados usando as técnicas e controles ilustrados na explicação. A partir do grupo Login do Toolbox. Digite seu nome de usuário e clique em Submit. Para obter detalhes. 6. Próximas Etapas Esta explicação passo a passo tem ilustrado um cenário simples mas completo para criar um aplicativo que solicita credenciais de usuários. No menu LoginView Tasks. consulte Explicação Passo a Passo: Gerenciando Usuários de Site Web Usando Funções. Se você inseriu uma resposta correta. use a lista drop-down Block Format para formatar o texto como "Heading 1". você não está autorizado.de ferramentas Formatting. 7. mas se o seu site passará por • Visual Studio 186 . defina a propriedade Text para Forgot your password? e a propriedade NavigateUrl para ~/RecoverPassword. permite que os usuários recuperem uma senha esquecida e limita o acesso às páginas. Para testar a recuperação de senha 1. 3. você pode desejar: • Criar usuários adicionais e definir funções (grupos) como gerentes. o site Web redefine sua senha e envia para você uma mensagem de e-mail com a nova senha.aspx. na lista Views.aspx. 5. defina a propriedade Text para Home e a propriedade NavigateUrl para ~/Default.aspx aparece. Pressione CTRL+F5 para executar o site Web. Digite a resposta e clique em Submit. Armazenar as informações de associação em um banco de dados Access é adequado para sites pequenos e médios. Isso alterna o controle LoginView para o modo de edição para o conteúdo que aparecerá para os usuários que não estão autorizados. 5. Na janela Properties para o controle HyperLink. então você vê o modelo anônimo do controle LoginView. arraste um controle HyperLink para a página. Clique no link Forgot your password?. A pergunta de segurança é exibida e é solicitado que você digite a resposta de segurança. Alterne para a página Default. 4. Por exemplo. vendas ou membros e associar membro para diferentes funções. clique em AnonymousTemplate. Agora você pode testar a recuperação de senha. exibe informação para os usuários autorizados. Combinar a associação com as propriedades de perfil. Para obter detalhes. que permitem a você armazenar configurações específicas para cada usuário. • • • • Visual Studio 187 . As páginas mestras permitem que você defina um layout da página que pode ser usado para todas as páginas em seu aplicativo. mas para usuários ou funções específicos. PasswordRecovery e CreateUserWizard possuem suporte para modelos. consulte Explicação Passo a Passo: Mantendo a Informação do Usuário do Site Web com Propriedades de Perfil. que permiteme que você configure o texto e os botões que ele contêm. a fonte e outras características de aparência. • Alterar a aparência dos controles de login.Para obter mais informações.NET. Para mais informações. consulte os tópicos na seção Controles de Login do ASP. consulte Web Site Administration Tool Provider Tab e Criando Banco de Dados de Serviços do Aplicativo para SQL Server. consulte Explicação Passo a Passo: Criando e Usando as Páginas Mestras do ASP. Para obter detalhes. Combinar os controles de login com as páginas mestras. Para obter mais informações. você desejará utilizar o Microsoft SQL Server para armazenas os dados de associação.NET em Visual Web Developer. Adicionar o recurso para recuperar uma senha esquecida. consulte HOW TO: Ativar a Recuperação de Senha de Usuário Usando o Controle PasswordRecovery do ASP.tráfego pesado. Os controles Login.NET: Criar regras que limitam o acesso às páginas ou pastas não apenas para usuários anônimos. assim como a cor. Clique em Default Web Site. A caixa de diálogo New Web Site aparece com o nome do novo site no canto mais a direita da lista Location. Clique em Local IIS. Clique em Create New Web Application. A localidade inclui o protocolo (http://) e a localidade (localhost).NET XML. será necessário: • Serviços de Informações da Internet da Microsoft (IIS) instalado localmente em seu computador. No menu File. 5. clique em New Web Site. 7. Digite o nome TemperatureWebService. 3. Você também pode usar a ferramenta de desenvolvimento Web do Microsoft Visual Web Developer para referenciar e usar serviços da Web que estão em uma solução do Visual Web Developer em seu computador local ou em um diretório UDDI local ou externo. Para criar um serviço da Web 1. Visual Studio 188 . Em Visual Studio installed templates.NET no Visual Web Developer Além de permitir que você crie páginas da Web. Observação Você deve usar um site do IIS para esta explicação passo a passo. 8. O Visual Web Developer cria um novo aplicativo da Web do IIS. 6. 9. Isso Indica que você está trabalhando com um site local do IIS. Criando um serviço da Web na raiz do IIS Crie um novo serviço e uma página da Web seguindo estas etapas.NET Web Service. A criação de um serviço da Web no Visual Studio é semelhante a criar uma página da Web. As tarefas ilustradas nesta explicação passo a passo incluem: • • Criar um XML Web Service simples no Visual Web Developer. Pré-requisitos Para concluir esta explicação passo a passo. 4. clique em ASP. o Microsoft Visual Studio também deixa que você crie serviços da Web que usem ASP.Passo-a-passo: Criando e usando um serviço da Web ASP. você irá criar o serviço da Web em uma solução e usá-lo em outra. 2. A caixa de diálogo New Web Site aparece. Clique em Browse. Nesta explicação passo a passo. Clique em Open. Criar um site em separado que usa o serviço da Web. Abra o Visual Web Developer. Feche a classe Service.asmx é o arquivo que pode ser chamado para chamar os métodos do serviço da Web e ele aponta para o código do serviço da Web. } Observe que os nomes das funções são precedidos com um atributo ([System. O Visual Web Developer cria o novo serviço da Web e abre uma nova classe chamada Service.WebMethod()] public double FahrenheitToCelsius(double Fahrenheit) { return ((Fahrenheit . você pode usar mais de uma linguagem no mesmo aplicativo da Web.Web. O primeiro método converte temperaturas Fahrenheit para Celsius. } [System. Convert. Adicione o seguinte código dentro a classe.Services. O código propriamente dito está em um arquivo de classe (Convert. Para obter mais informações sobre como criar componentes usando diferentes linguagens.jsl. No Solution Explorer. e o segundo método converte temperaturas Celsius para Fahrenheit. 3. dependendo da linguagem de programação) na pasta App_Code. digite Convert. Para criar os métodos de conversão 1.Services.Web. Clique em OK. Certifique-se de que a caixa de seleção Place code in separate file está selecionada e clique em Add. Criando o serviço da Web Você criará um serviço da Web que converte a temperatura de Fahrenheit para Celsius e vice-versa. após o método HelloWorld: C# [System.WebMethod()] public double CelsiusToFahrenheit(double Celsius) { return ((Celsius * 9) / 5) + 32. Visual Studio 189 .Services. 12.10. consulte Pastas de código compartilhadas em sites do ASP. Na lista Language. salve o arquivo.32) * 5) / 9. A linguagem de programação que você escolher será o padrão para o site. criando páginas e componentes em linguagens de programação diferentes. ou Convert. Para criar o serviço da Web 1. Em Visual Studio installed templates.cs.Services. Entretanto.Web. e clique em Add New Item. O arquivo Convert. clique na linguagem de programação com a qual você prefere trabalhar. Depois que você inseriu as funções.WebMethod()>) como parte da declaração da função 2. O arquivo de código inclui um código para um método do serviço da Web.vb. Você criará dois métodos no serviço da Web. e na caixa Name.Web. Entretanto. 2. que é o serviço da Web padrão. clique com o botão direito do mouse no nome do site (http://localhost/TemperatureWebService).WebMethod()] ou <System. clique em Web Service. O arquivo de código contém um modelo para um serviço da Web. O Visual Web Developer cria um novo serviço da Web que é composto de dois arquivos. no procedimento a seguir será criado um novo serviço da Web com um nome diferente e não você usará a classe Service.NET. 11. O Visual Web Developer cria um novo site local do IIS e uma nova página chamada Default. O serviço da Web é chamado e aparece uma página no navegador que mostra os métodos que são expostos pelo serviço da Web. clique em New Web Site. 5. 8. 6. No navegador original. Aparece uma página que solicita que você entre os valores dos parâmetros para o método CelsiusToFahrenheit. 4. Para a explicação passo a passo. Clique em Browse. você irá criar um site onde você irá referenciar e usar o serviço da Web que você criou. 6. No Solution Explorer. 3. o método FahrenheitToCelsius retornará 100. Feche o navegador. Se você digitar 212. Digite o nome TemperatureWeb. 9. Na lista Language. 2. 7. que chama esse método. O valor 212 aparece no XML. clique em Back para retornar para a lista de métodos. digite 100 e clique em Invoke. clique em ASP.asmx e pressione CTRL+F5. Você terminou de criar o serviço da Web. Visual Studio 190 . Clique em Default Web Site. Clique em Create New Web Application. Em Visual Studio installed templates. Para criar um site para usar o serviço da Web 1. Clique em Local IIS. Na caixa Celsius. Clique em FahrenheitToCelsius e teste para certificar-se de que o método está retornando os resultados que você espera. No menu File. clique em Convert. 3. Para testar o serviço da Web 1.NET Web Site. 7. você irá criar um site separado que tenha uma página onde você inicia os métodos do serviço da Web recém-criado. 2.aspx.Agora você pode testar o serviço da Web no Visual Web Developer. 5. Usando o serviço da Web Agora que você tem um serviço da Web. Clique em CelsiusToFahrenheit. Adicionando o serviço da Web como um componente 10. Clique em Open. clique na linguagem de programação com a qual você prefere para trabalhar. Feche o navegador que contém os resultados do método. 4. O Visual Web Developer cria um novo aplicativo da Web do IIS. Clique em OK. Uma nova janela aparece exibindo o XML que o serviço da Web retorna quando o método CelsiusToFahrenheit é chamado. a próxima etapa é usá-lo. Por padrão. defina o endereço do servidor proxy com o nome exato do servidor proxy em vez de permitir que o Internet Explorer detecte o servidor proxy. No Solution Explorer. O página de teste para o método aparece. Portanto. Clique em Add Reference. Ele também adiciona arquivos de suporte. 3. Para obter mais informações. Para criar uma referência para o serviço da Web 1.discomap).WSDL que referencia o serviço da Web. que incluem informações sobre onde o serviço da Web está localizado.aspx. O Visual Web Developer cria uma pasta App_WebReferences e lhe adiciona uma pasta para a nova referência da Web. como arquivos de busca (. Observação Se o nome do servidor para o serviço da Web contiver caracteres que não podem ser usados para um nome de classe. localhost). Anote o nome do namespace para a referência da Web. como um hífen (-). Portanto. Observação Se você não puder adicionar uma referência para um serviço da Web. digite a seguinte URL para o serviço da Web e. são atribuídas às referências da Web um namespace correspondente ao seu nome de servidor (neste caso. Visual Studio 191 . as informações sobre o serviço da Web aparecem na caixa de diálogo Add Web References. Nesta explicação passo a passo. clique em Conexões e clique em Configurações de LAN. como mostrado no seguinte instantâneo: Caixa de diálogo Add Web Reference 2. em seguida. Clique em um dos links dos métodos. clique com o botão direito do mouse no nome do site e clique em Add Web Reference. clique em Go: http://localhost/TemperatureWebService/Convert. e depois programar os controles para converter uma temperatura especificada em Fahrenheit e em Celsius. Na pasta.disco e . no menu Ferramentas. você deve criar uma referência a ele. o Visual Web Developer adiciona um arquivo . A caixa de diálogo Add Web Reference aparece. contate o administrador de rede. Selecione a caixa de seleção Ignorar servidor de proxy para endereços locais. No Microsoft Internet Explorer.O serviço da Web é um componente que você pode referenciar no seu aplicativo. Agora você pode usar o serviço da Web. o Visual Web Developer converte os caracteres em um caractere sublinhado (_). pode ser que o servidor proxy não esteja configurado corretamente. Quando a página estiver sendo executada. Na lista URL. ela parecerá com a seguinte ilustração. o namespace no Visual Web Developer para o serviço da Web pode não corresponder exatamente ao nome do servidor. você irá adicionar controles ao Default. clique em Opções da Internet. Além disso. 4.asmx Quando o Visual Web Developer encontra o serviço da Web. 7. A página exibe o resultado da conversão do valor da temperatura em Fahrenheit e em Celsius. Visual Studio 192 .Text = "Celsius To Fahrenheit = " + wsConvert. CelsiusLabel. FahrenheitLabel. como 100. Depurando o serviço da Web Você pode depurar um serviço da Web da mesma maneira que você depura páginas da Web.Text). e clique em Convert. Clique duas vezes em ConvertButton para criar um manipulador de eventos para o evento Click.ToString(). double temperature = System. 2. Verifique se o código do seu manipulador de eventos corresponde ao código de exemplo a seguir: C# protected void ConvertButton_Click(object sender. Abra a página Default.FahrenheitToCelsius(temperature). A partir do grupo Standard na caixa de ferramentas. Opcionalmente. Pressione CTRL+F5 para executar a página.Text = "Fahrenheit To Celsius = " + wsConvert. 5.Convert. Na caixa de texto.ToString(). 4.aspx e alterne para o modo Design.CelsiusToFahrenheit(temperature). } 6.Temperature conversion page Para chamar os métodos do serviço da Web 1. O layout de página para esta explicação passo a passo não é importante.Convert wsConvert = new localhost.ToDouble(TemperatureTextbox. digite um valor.Convert(). EventArgs e) { localhost. arraste os seguintes controles para a página e definia suas propriedades conforme o indicado: Controle Textbox Propriedades IDTemperatureTextbox Text: (vazio) Button IDConvertButton Text: Convert Label IDFahrenheitLabel Text: (vazio) Label IDCelsiusLabel Text: (vazio) 3. adicione texto à página nas legendas. Agora você deve ativar a depuração para o site que usa o serviço da Web. 3. Se você estiver usando o Visual Web Developer Express Edition ou o Visual Studio Standard Edition. clique em Configure debugging and tracing e selecione a caixa de seleção Enable debugging. Visual Studio 193 . clique em Open Web Site. Clique em Local IIS. 2. Clique em Application. Para iniciar. na barra de ferramentas do Solution Explorer. Feche o Web Site Administration Tool. 4. Para ativar a depuração do site 1. 2. 8. No menu Website. O Web Site Administration Tool cria um arquivo Web. clique em Configure debugging and tracing. 3. clique em Refresh. ignore esta seção e as seguintes. Feche o Web Site Administration Tool. Para ativar a depuração no site de serviços da Web 1.NET Configuration para abrir o Web Site Administration Tool. Em Debugging and Tracing. Observação Para consultar o arquivo Web. 6. clique em Application Configuration em Debugging and Tracing. clique em ASP. clique no nome do site e. 5.config no Solution Explorer. 4. No menu Website.NET Configuration para abrir o Web Site Administration Tool. você deve configurar o site que contém o serviço da Web para ativar a depuração. Para obter mais informações sobre como depurar sites da Web. consulte Passo-a-passo: Depurando páginas da Web no Visual Web Developer. 7. Observação Se esta for a primeira vez que você tiver executado o Web Site Administration Tool. clique em ASP.config para o site e define uma opção de configuração para ativar a depuração. No menu File. Abra o site TemperatureWeb.Observação O Visual Web Developer Express Edition e o Visual Studio Standard Edition não oferecem suporte passo a passo por dentro das chamadas em um serviço da Web de uma página que o referencia. Clique em Application e clique em Application Configuration. Clique em TemperatureWebService e clique em Open. Selecione a caixa de seleção Enable debugging. pode demorar um pouco antes de ele aparecer. Observação Para consultar o arquivo Web.config no Solution Explorer, selecione o nome do site e clique em Refresh na barra de ferramentas do Solution Explorer. 5. No Solution Explorer, clique com o botão direito do mouse em Default.aspx e clique em View Code. O Visual Web Developer abre o arquivo de código para a página. 6. Posicione o ponteiro do mouse na seguinte linha: C# double temperature = System.Convert.ToDouble(TemperatureTextbox.Text); 7. Pressione F9 para definir um ponto de interrupção na linha. Testando a depuração O site e o serviço da Web estão configurados para a depuração, para que você agora possa começar a depurar. Você irá iniciar na página Default.aspx e depurar o código até que o código chame o serviço da Web. O depurador alternará para o serviço da Web e continuará a depuração através do código. Para depurar a página e o serviço da Web 1. 2. Pressione F5 para executar a página Default.aspx usando depuração. A página aparece no navegador. Na caixa, digite um valor, como 100, e clique em Convert. O Visual Web Developer começa a executar o código da página, mas pára e realça a linha com o ponto de interrupção sobre ele. 3. 4. Pressione F11 para ir para a próxima linha. Pressione F11 novamente. Como a linha seguinte chama o serviço da Web, o depurador vai para o serviço da Web, parando na primeira linha do método FahrenheitToCelsius. 5. Continue pressionando F11. O depurador avança através do restante do método e retorna para a página que chamou o método. Se você continuar a depuração, o depurador irá de volta para o serviço da Web e para o método CelsiusToFahrenheit. 6. Feche o navegador, que também fecha o depurador. Próximas etapas Esta explicação passo a passo ilustrou os princípios básicos de criação de um serviço da Web muito simples e de usá-lo em um aplicativo ASP.NET. Você pode desejar experimentar serviços da Web com recursos adicionais e mais complexos. Sugestões para explorações adicionais incluem o seguinte: • Compreender o processamento que ocorre quando você faz uma chamada XML Web Service. Para mais informações, consulte Anatomia do tempo de vida de um XML Web Service. • Entender como usar XML Web Services. Visual Studio 194 Para mais informações, consulte Cenários do XML Web Service. • Criar XML Web Services que oferecem funcionalidades mais sofisticadas do que o serviço da Web simples desta explicação passo a passo. Você pode criar e encadear chamadas de métodos de serviços da Web assíncronas, usar transações, proteger os serviços da Web, configurar serviços da Web para autenticação do Microsoft Windows, e assim por diante. Para mais informações, consulte XML Web Services utilizando ASP.NET . Aprender sobre os recursos específicos da linguagem e da tecnologia fornecidos pelo XML Web Service. Para obter mais informações, consulte XML Web Services no Visual FoxPro, Introdução à programação de XML Web Services em código gerenciado, Serviços da Web (como faço no Visual Basic), XML Web Services criados com o servidor ATL e Explicações passo a passo sobre a criação e o acesso a XML Web Services. • Visual Studio 195 Criando e Acessando Explicações Passo a Passo de XML Web Services XML Web Services fornecem acesso programático a lógica do aplicativo usando protocolos padrão da Web, como XML e HTTP. XML Web Services podem ser aplicativos autônomos ou subcomponentes de um aplicativo maior da Web. XML Web Services são acessíveis de praticamente qualquer outro tipo de aplicativo, incluindo outros XML Web Services, aplicativos Web, aplicativos do Windows e aplicativos console. O único requisito é de que o cliente possa enviar, receber, e processar mensagens de e para um XML Web Service. Para obter mais informações, consulte Programação na Web com XML Web Services. Essas explicações passo a passo cobrem dois caminhos de desenvolvimento logicamente separados, criando XML Web Services e acessando XML Web Services. Embora você possa ser tanto o criador e o usuário de um XML Web Services específico, os processos são distintamente separados. É claro, você precisará criar um XML Web Services antes de poder acessá-lo. As explicações passo a passo de criação de XML Web Services usar duas tecnologias separadas para implementar um XML Web Services. Em todos os casos, você cria a mesma funcionalidade XML Web Services; a única diferença é o método de implementação. As explicações passo a passo de acesso a XML Web Services concentram nas etapas necessárias para acessar XML Web Services no código gerenciado e código não gerenciado. Em cada explicação passo a passo, o aplicativo cliente acessa o XML Web Services usando uma classe proxy gerada pelo Visual Studio. Observação Em cada explicação passo a passo você irá acessar um XML Web Services criado em uma das explicações passo a passo acima "Criando um XML Web Service...". Ou seja, não é necessário concluir pelo menos uma das explicações passo a passo "Criando um XML Web Service..." antes de tentar um das explicações passo a passo " Acessando um XML Web Service ". Para uma demonstração de um XML Web Services que retorna um DataSet altamente tipado de SQL Server e processa atualizações de aplicativos Windows e da Web, consulte Criando um aplicativo distribuído Walkthrough:. Visual Studio 196 Explicação Passo a Passo: Criando um XML Web Services usando Visual Basic ou Visual C# Explicação passo a passo a seguir descreve o processo para criar um XML Web Services que converte temperaturas medidas em Fahrenheit para Celsius usando Visual Basic ou C# visual. Você durante esta explicação passo a passo, você irá realizar as atividades a seguir: • • • • Criar um XML Web Services usando o modelo projeto serviço ASP.NET Web. Implementar o XML Web Services. Executar o XML Web Services no modo de depuração. Implantar o XML Web Services. Para concluir o explicação passo a passo, você precisará ter acesso a uma máquina que atende aos requisitos para criar um projeto da Web. Para obter mais informações, consulte Tour guiado da criação de sites no Visual Web Developer e Passo a passo: Criando e usando um serviço da Web do ASP.NET no Visual Web Developer. Criar projeto serviço XML da Web O Visual Studio fornece um modelo de projeto ASP.NET Web Service para ajudá-lo a criar XML Web Services no Visual Basic e Visual C#. Para criar um ASP.NET Web Service Project 1. 2. 3. No menu File, escolha New Web Site. Na caixa de diálogo New Web Site, selecione o ícone ASP.NET Web Service. Digite o endereço do servidor Web no qual você irá desenvolver o XML Web Services e especifique TempConvert1 como o nome do diretório, tal como " http://MyServer/TempConvert1 ". Por padrão, o projeto usa seu computador local, " http://localhost ". Observação Para alguns tipos de projeto, o caixa de texto Name está disponível porque especificando a localidade define em vez disso o nome do projeto. Por exemplo, aplicativos da Web e XML Web Services estão localizados em um servidor Web e derivam seus nomes do diretório virtual especificado no servidor. Observação Você desenvolve XML Web Services em um servidor de desenvolvimento. Por padrão, o servidor de desenvolvimento é sua máquina local. Normalmente, voce desenvolve e constrói o projeto em um servidor de desenvolvimento, e então você o implementa em outro servidor (o servidor se implementação) que irá hospedar o XML Web service usando um projeto de implementação. Entretanto, se você estiver desenvolvendo diretamente no servidor que hospedará o XML Web Services, o servidor de desenvolvimento e o servidor de implantação são os mesmos. Visual Studio 197 4. Clique OK para criar o projeto. O Visual Studio automaticamente cria os arquivos necessários e inclui as referências necessárias para suportar um XML Web Services. Quando você criar um projeto XML Web Services no Visual Studio, verá o criador de componente para Service1.asmx. Implementar o serviço da Web XML A próxima etapa é escrever o código para implementar a funcionalidade do XML Web Services que os clientes irão acessar. Para XML Web Services criados no Visual Studio, um arquivo oculto code-behind associado ao arquivo.asmx do XML Web Services que o Visual Studio criou para você contém esse código. Para obter mais informações, consulte COMO: Criar um Método de Serviço da Web XML. Para adicionar um método de XML Web Service 1. No arquivo código Service.vb, localize o código para a declaração de classe Service. Substituia o código de atributo System.Web.Services.WebService com o seguinte código antes da declaração de classe (mostrada em negrito): Visual Basic <System.Web.Services.WebService( _ Namespace:="http://Walkthrough/XmlWebServices/", _ Description:="A temperature conversion service.")> _ Public Class Service [System.Web.Services.WebService( Namespace="http://Walkthrough/XmlWebServices/", Description="A temperature conversion service.")] public class Service : System.Web.Services.WebService Unindo o atributo WebService à classe Public se torna possível a inclusão de informação adicional sobre o XML Web Service, como um namespace para o XML Web Service e uma descrição para o XML Web Service. A propriedade description desse atributo está incluída na página de ajuda de Service. Para obter mais informações, consulte COMO: Usar o Atributo WebService. 2. Na classe Service, adicione o seguinte código para declarar a função ConvertTemperature: Visual Basic <WebMethod(Description:="This method converts a temperature in " & _ "degrees Fahrenheit to a temperature in degrees Celsius.")> _ Public Function ConvertTemperature(ByVal dFahrenheit As Double) _ As Double Return ((dFahrenheit - 32) * 5) / 9 End Function [WebMethod(Description="This method converts a temperature in " + "degrees Fahrenheit to a temperature in degrees Celsius.")] public double ConvertTemperature(double dFahrenheit) { return ((dFahrenheit - 32) * 5) / 9; } Anexando o atributo WebMethod a um método Public expõe esse método como parte do XML Web Services. A propriedade description deste atributo está incluído na página ajuda de Service e na página de ajuda Service Methods. Para obter mais informações, consulte COMO: Usar o Atributo WebMethod. 3. 4. Clique com o botão direito do mouse Service.asmx em Solution Explorer e clique Set as Start Page no menu de atalho. Salvar a solução. Depurar o XML Web Service O Visual Studio oferece vários métodos para criar e executar um XML Web Services a partir da IDE, tais como: Visual Studio 198 • • • Iniciar (com depuração) Iniciar sem depuração Modo de Exibição no navegador Como um projeto Visual Studio, este XML Web Services tem configurações separadas para as versões de lançamento e depuração. Como você criou este projeto usando o modelo de projeto do serviço da Web ASP.NET, Visual Studio automaticamente criou essas configurações e definiu as opções padrão apropriadas e outras configurações. Para obter mais informações, consulte HOW TO: definir depuração e configurações de versão. Nesta explicação passo a passo, será colocado um ponto de interrupção no XML Web Services e usado o método Start (with Debugging). Para obter mais informações, consulte Como Depurar XML Web Services em Código Não Gerenciado. Antes de depuração, verifique as configurações de depuração. Para obter mais informações, consulte Projetos Serviço da Web XML depuração preparação:. Para usar um ponto de interrupção e iniciar o XML Web Services com depuração 1. No menu Debug, escolher New Breakpoint, então Break At Function. Na guia Function, digite ConvertTemperature na caixa Function e clique OK para adicionar um ponto de interrupção na declaração de método ConvertTemperature. 2. No menu Debug, clique em Start, clique Ok na janela Debugging Not Enabled para iniciar depuração. Este comando instrui o Visual Studio a executar o XML Web Services no depurador. O Visual Studio cria o projeto e o implanta para o servidor de desenvolvimento designado. Após a conclusão, o navegador padrão exibe o arquivo.asmx a partir do servidor de implantação. Quando você abre um arquivo.asmx em um navegador, o XML Web Services retorna uma página Service auxiliar que fornece informações sobre o XML Web Services. O Service Description link leva você para um documento XML que contém a descrição serviço formal do XML Web Services. Para obter mais informações, consulte XML Web Service Description. 3. 4. Na página de ajuda Service, clique no link ConvertTemperature. Na caixa dFahrenheit, digite o número 212, e clique no botão Invoke. Quando o processamento atingir a função ConvertTemperature, o processamento pára. O depurador Visual Studio realça a linha que contém o ponto de interrupção; enquanto ele é interrompido, você pode executar uma variedade de tarefas. Para obter mais informações, consulte Explicação detalhada sobre o depurador e Exibindo Dados no Depurador. 5. 6. No menu Debug, clique em Continue para continuar o processamento. O XML Web Services responde retornando o valor convertido em um documento XML semelhante ao seguinte: <?xml version="1.0" encoding="utf-8" ?> <double xmlns="http://Walkthrough/XmlWebServices/">100</double> Para interromper a execução do XML Web Services e retornar ao editor de código, no menu Debug, clique em Stop Debugging. Visual Studio 199 7. No menu Debug, clique em Delete All Breakpoints. Implantando o XML Web Service Para tornar seu XML Web Services disponível para outros, você deve implantá-lo em um servidor Web que seja acessível para os clientes que você queira dar suporte. Para distribuir o XML Web Services para um servidor que não seja o servidor de desenvolvimento, você pode adicionar um projeto Web Setup ou copiar os arquivos necessários para o servidor de destino. Nesta explicação passo a passo, você pode escolher como implantar este XML Web Services. Para obter mais informações, consulte COMO: Implantar Serviços da Web XML no Código Gerenciado. Para implantar o XML Web Services usando um projeto Web Setup 1. 2. 3. No menu File, aponte para Add, e clique New Project. Selecionar o nó Other, e o nó Setup and Deployment Projects, e clique em Web Setup Project. Na caixa Name, digitar TempConvert1WebSetup, e clique OK. Observação Por padrão, o instalador usa o nome do projeto de implantação ao criar o diretório virtual em seu servidor de implantação. 4. 5. 6. No painel esquerdo do File System Editor, selecione Web Application Folder. Para obter mais informações, consulte File System Editor. No Solution Explorer, clique com o botão direito do mouse em TempConvert1WebSetup, aponte para Add, e clique Project Output. Na caixa de diálogo Add Project Output Group, selecione Content Files. Para obter mais informações, consulte Como adicionar e remover Outputs Project no File System Editor:. O grupo Content Files consiste dos seguintes arquivos para o XML Web Services: Service1.asmx, GLOBAL.asax, e Web.config. Para obter mais informações, consulte COMO: Implantar Serviços da Web XML no Código Gerenciado. Clique em OK. No Solution Explorer, clique com o botão direito do mouse no projetoTempConvert1WebSetup, e no menu de atalho, clique Build. Isso cria um arquivo do Windows Installer no diretório de projeto local. Executar este arquivo instala o aplicativo da Web. Para implantar o XML Web Services, copiando o projeto 1. 2. 3. No Solution Explorer, selecione o projeto TempConvert1. No menu Project, clique em Copy Web Site. Clique no ícone ao lado da caixa suspensa Connect To para abrir a caixa de diálogo Open Web Site. Navegue para a localidade para a qual você deseja copiar o projeto. No painel Source Web Site, selecione os arquivos para copiar e movê-los para o painel Remote Web Site, clicando no ícone de seta à direita. . o 7. 8. 4. Visual Studio 200 5. Clique Copy Web Site para copiar o site. para criar um aplicativo cliente que acesse esse XML Web Services. Finalmente. consulte um destes procedimentos: • • • Passo-a-Passo: acessando um XML Web Services utilizando Visual Basic ou Visual C# Acessar um serviço da Web XML usando C++ Walkthrough: Acessar um serviço da Web XML usando C++ e o CLR Walkthrough: Visual Studio 201 . Quando o servidor Web recebe uma solicitação para o serviço da Web XML. Visual Studio cria automaticamente um projeto do serviço XML da Web que usa C++. Usando essa sintaxe. consulte Requisitos de hardware do Visual Studio. Para criar um projeto Serviço da Web ASP. Criar projeto serviço XML da Web Usando o ASP. os desenvolvedores podem criar classes gerenciadas usando C++.NET Web Service modelo de projeto. Para concluir o explicação passo a passo. em seguida. 3. que por sua vez chama este código. você precisará ter acesso a uma máquina que atende aos requisitos para criar um projeto da Web. O modelo de projeto fornece automaticamente os arquivos necessários e referências a suporte um serviço XML da Web.NET Web Service modelo de projeto. Dica No Solution Explorer Consulte o arquivo ReadMe. Selecione a Visual C++ Projects pasta.asmx da mesma maneira como os Serviços XML da Web no Visual Basic e Visual C#.txt que descreve os projetos e arquivos gerados.Passo-a-passo: Criando um XML Web Service usando C++ e o CLR Os desenvolvedores podem usar a nova sintaxe C++ para expor funcionalidade escrita em C++ como um serviço XML da Web.NET com C++ 1. você irá realizar as atividades a seguir: • • • • Criar um serviço XML da Web usando o ASP. Para obter mais informações. e. e clique Project para abrir a New Project caixa de diálogo.asmx. Depurar o serviço da Web XML.NET Web Service ícone. No menu File. Essas classes e seus métodos públicos então podem ser expostos como serviços XML da Web usando arquivos. aponte para New. Você também precisará de permissões suficientes para ser capaz de criar projetos XML Web Services no computador onde seu servidor Web está. Implantar o XML Web Services. Implementar o serviço da Web XML A próxima etapa é para gravar o código para implementar a funcionalidade do que os clientes podem acessar o serviço da Web XML. Observação Visual Studio 202 . clique no ASP. Na caixa Name. Durante o curso desta explicação passo a passo. digite TempConvert3 e depois clique em OK. ele chama TempConvert3. Implementar o XML Web Services. 2. asmx e clique Open With no menu de atalho. A propriedade description desse atributo está incluída na página de ajuda de Service. clique com o botão direito do mouse no arquivo. Anexar o System::Web::Services::WebMethod atributo a este método indica que você deseja o método exposto como parte do serviço da Web XML.h. A propriedade description deste atributo está incluído na página ajuda de Service e na página de ajuda Service Methods. Você irá adicionar um método público para esta classe e expor esse método como parte do serviço da Web XML. Clique duas vezes o Component Designer na superfície do design para exibir o código para esse arquivo.TempConvert3Class" %> Dica Se você optar por renomear a classe. consulte WebServiceAttribute. Para obter mais informações. Visual Studio 203 . Localize a declaração de classe: public ref class TempConvert3Class : public System::Web::Services::WebService Insira o seguinte código antes que declaração: [System::Web::Services::WebServiceAttribute( Namespace="http://Walkthrough/XmlWebServices/".asmx diretiva de processamento. 2.asmx Especifica a classe que é a implementação do serviço da Web XML na propriedade Class do arquivo WebService. TempConvert3Class.")] Anexar o System::Web::Services::WebServiceAttribute atributo a essa classe torna possível para que você possa incluir informações adicionais sobre o serviço XML da Web.Para exibir o conteúdo do arquivo. Os métodos da classe TempConvert3Class fornecer a implementação do serviço da Web XML. no Solution Explorer. Description="A temperature conversion XML Web Service.")] double ConvertTemperature(double dFahrenheit). Na caixa Open With de diálogo. Localize o método HelloWorld de exemplo: public: [System::Web::Services::WebMethod] String ^HelloWorld(). consulte WebMethodAttribute. 3. Herda TempConvert3Class da classe System::Web::Services::WebService base. selecione Source Code (Text) Editor e clique em OK O arquivo. Para adicionar um método de XML Web Service 1. Para obter mais informações. certifique-se alterar o nome de classe no Class atributo da diretiva WebService. // TODO: Add the methods of your Web Service here Substituir esse método com o seguinte: public: [System::Web::Services::WebMethod( Description="Converts temperatures from F to C.asmx. que lembra o seguinte: <%@ WebService Class="TempConvert3. como especificar um espaço para nome e uma descrição. NET Web Service modelo de projeto.asmx a partir do servidor de implantação. No menu Build.32) * 5) / 9. localize TempConvert3Class. Para obter mais informações. Para usar um ponto de interrupção e iniciar o XML Web Services com depuração 1. será anexar ao processo do sistema em que estiver sendo executado para depurá-la. será colocar um ponto de interrupção no serviço XML da Web e use o Start Debugging método. clique em Build Solution. verifique as configurações de depuração. o XML Web Services retorna uma página Service auxiliar que fornece informações sobre o XML Web Services. Este comando instrui Visual Studio para executar o serviço XML da Web como ele faria normalmente. No menu Debug. clique em Start Debugging.cpp na pasta Source Files do Projeto TempConvert3 e abrir este arquivo para edição. 6. Depurar o XML Web Service O Visual Studio oferece vários métodos para criar e executar um XML Web Services a partir da IDE. } }. O Visual Studio compila o projeto e o implanta no servidor de desenvolvimento designado. Nessa explicação passo a passo. 5. digite TempConvert3::TempConvert3Class::ConvertTemperature lado para Function e clique OK para colocar um ponto de interrupção na declaração ConvertTemperature de método. No menu Debug. Para obter mais informações. Quando o serviço da Web XML estiver sendo executado. 7. Após a conclusão. selecione New Breakpoint. Para obter mais informações. Antes da depuração. Quando você abre um arquivo. Localizar e substituir o conteúdo do espaço para nome TempConvert3 com o seguinte: namespace TempConvert3 { double TempConvert3Class::ConvertTemperature(double dFahrenheit) { return ((dFahrenheit . este XML Web Services tem configurações separadas para as versões de lançamento e depuração. consulte HOW TO: definir depuração e configurações de versão. Criadas essas configurações porque você criado este projeto usando o ASP. Visual Studio 204 . Na caixa New Breakpoint de diálogo. Para obter mais informações.asmx em um navegador. consulte Descrição do XML Web Service. tais como: • • • Start Debugging Start Without Debugging View in Browser Como um projeto Visual Studio. Clicar no Service Description Link retorna um documento XML que contém o descrição do serviço formal do serviço XML Web. 2.4. consulte Como Depurar XML Web Services em Código Não Gerenciado. Salve a solução. o navegador padrão exibe o arquivo. Visual Studio automaticamente e definir as opções padrão apropriado e outras configurações. No Solution Explorer. e selecione Break at Function. consulte Preparação da Depuração: Web Services XML (C++). Na caixa dFahrenheit. e clique no Invoke botão. Quando processamento atinge a ConvertTemperature função. 5. No painel esquerdo da guia File System (TempConvert3WebSetup). No menu Debug. clique com o botão direito do mouse TempConvert3WebSetup. Para implantar o XML Web Services usando um projeto Web Setup 1.3. o Visual Studio 205 . 5. O depurador do Visual Studio realça a linha que contém o ponto de interrupção e. aponte para Add. 6. consulte Como adicionar e remover resultados Project no editor do sistema de arquivos:. selecione Web Application Folder. aponte para New e clique em Project. enquanto interrompido. 7. clique em Delete All Breakpoints. 6. no menu Debug. clique no ConvertTemperature Link. clique Continue para continuar o processamento. clique em Stop Debugging. Na lista suspensa Solution Selecionar Add to Solution. 7. e clique em OK Observação Por padrão. selecione Content Files.asax. clique em Web Setup Project. Global. O grupo arquivos conteúdo consiste os seguintes arquivos para o serviço da Web XML: TempConvert3. Na página TempConvert3Class Serviço da Web. Na caixa Name. 4. Implantando o XML Web Service Para implantar esse serviço XML da Web. o instalador usa o nome do projeto de implantação ao criar o diretório virtual em seu servidor de implantação. Para 3. Para obter mais informações. e clique em Project Output.asmx. você deve criar um projeto de implantação. O XML Web Services responde retornando o valor convertido em um documento XML semelhante ao seguinte: <?xml version="1. consulte Passo-a-passo: Depuração de um serviço XML da Web. No Solution Explorer. expanda o Other Project Types nó e selecione Setup and Deployment. 2. Para obter mais informações. digite TempConvert3WebSetup.0" encoding="utf-8" ?> <double xmlns="http://Walkthrough/XmlWebServices/">100</double> Para interromper executando o serviço XML da Web e retornar ao editor de código. Para obter mais informações. você poderá executar uma variedade de tarefas. consulte Editor do sistema de arquivos. No menu File.config. 4. No painel Templates. processamento pára. consulte Debugger and Language Overview e Exibindo Dados no Depurador. No menu Debug. Para obter mais informações. digite o número 212. No painel Project types. e Web. Na caixa Add Project Output Group de diálogo. 8.dll. TempConvert3. Clique em OK.obter mais informações. clique em Build. no menu de atalho.pdb. Isso cria um arquivo do Windows Installer no diretório do projeto local. No painel esquerdo da guia File System (TempConvert3WebSetup). para criar um aplicativo cliente que acesse esse XML Web Services. Para obter mais informações. Finalmente. selecione Primary output e Debug Symbols. 9. 12. e suas dependências. consulte Implantando serviços da Web XML em código gerenciado. Clique em OK. aponte para Add. 10. 13. O grupo símbolos de depuração consiste do arquivo PDB projeto. o o O grupo primário de saída consiste do projeto DLL. e seguida. Executar este arquivo em um servidor Web para instalar este serviço da Web XML. consulte um destes procedimentos: • • • Passo-a-Passo: acessando um XML Web Services utilizando Visual Basic ou Visual C# Passo-a-passo: Acessando um XML Web Service usando C++ Passo-a-passo: Acessando um XML Web Service usando C++ e o CLR Visual Studio 206 . Para obter mais informações. e clique em Project Output 11. Na caixa Add Project Output Group de diálogo. consulte Implantando aplicativos e componentes. clique com o projeto de implantação. expanda Web Application Folder e localize a pasta rotulada bin. consulte Como adicionar e remover resultados Project no editor do sistema de arquivos:. No Solution Explorer. Clique com o botão direito do mouse na bin pasta. TempConvert3. e clique Project para abrir a New Project caixa de diálogo. que contém dois projetos separados: um projeto do manipulador e um projeto de extensão ISAPI. 4. No entanto. clique no ATL Server Web Service ícone. O assistente cria uma solução. Para obter mais informações. Durante o curso desta explicação passo a passo. consulte Criando Serviços da Web XML. que combina a funcionalidade ISAPI com o código do aplicativo. consulte Criar um Projeto ATL Server. 3.Walkthrough: Criando um serviço da Web XML usando ATL Server Explicação passo a passo o seguir descreve o processo para criar um serviço XML da Web que converte temperaturas medidas em Fahrenheit para Celsius usando C++ e ATL Server. Para obter mais informações. Para obter mais informações. consulte Fornecer serviços XML da Web. Na caixa Name. você precisará criar um cliente que acesse este serviço da Web XML para explorar sua funcionalidade. Esta opção está localizada na página Project Settings do assistente. 5. Criar projeto serviço XML da Web O Visual Studio fornece um modelo de projeto Serviço da Web Server ATL para ajudá-lo criar serviços da Web XML usando ATL Server. Para obter mais informações. Para criar um projeto do serviço da Web ATL Server 1. para essa explicação passo a passo. Observação Você tem a opção de criar uma DLL combinado. No ATL Server Project Wizard. Visual Studio 207 . Para concluir o explicação passo a passo. 2. você irá criar DLLs separados. clique Finish para aceitar os padrões do projeto. 6. Implantar o XML Web Services. Implementar o XML Web Services. Selecione a Visual C++ Projects pasta. Para obter mais informações. Clique OK Para iniciar o ATL Server Project Wizard. digite TempConvert4. aponte para New. você irá realizar as atividades a seguir: • • • Criar um serviço XML da Web usando o modelo do projeto Serviço da Web Server ATL. você precisará ter acesso a uma máquina que atende aos requisitos para criar um projeto da Web. e. No menu File. em seguida. consulte Criar um Projeto ATL Server. ATL Server torna possível para os desenvolvedores a usar o Active Template Library para facilmente implementar serviços XML da Web como uma extensão ISAPI. Desde que os Serviços XML da Web usando ATL Server não responda a solicitações HTTP-GET ou POST HTTP-. consulte Requisitos de hardware do Visual Studio. No Solution Explorer. o Você criará um projeto de implantação como a etapa final dessa explicação passo a passo. Além disso. Visual Studio 208 . Para obter mais informações. Para adicionar um método de XML Web Service 1. return S_OK. retval] double* pdCelsius). /*[out. 3. request_handler e soap_handler. 4. Ele oferece suporte um método.Dica O Assistente para Servidor ATL fornece um ReadMe. Neste projeto.txt mais que explica a finalidade de cada arquivo gerado. você não necessitará personalizar a DLL ISAPI. Você pode personalizar o código usado para criar a extensão DLL ISAPI no projeto de extensão ISAPI. ajudar a simplificar a tarefa de fornecer a infra-estrutura de serviço da Web XML. clique duas vezes TempConvert4. é ITempConvert4Service a definição de interface para o serviço da Web XML.txt arquivo que descreve os projetos e arquivos gerados no Solution Explorer. Quando o servidor recebe uma solicitação para o serviço da Web XML. você encontrará um arquivo ReadMe.32) * 5) / 9. localize e substituir a definição de classe de CTempConvert4Service exemplo com o seguinte: class CTempConvert4Service : public ITempConvert4Service { public: [ soap_method ] HRESULT ConvertTemperature( /*[in]*/ double dFahrenheit. 2. }. o soap_method atributo identifica qual método para expor como um serviço XML da Web. a extensão ISAPI chama este código.h para abrir o arquivo para edição. A CTempConvert4Service classe fornece a implementação de serviço da Web XML. localize a Header Files Pasta do projeto TempConvert4. e seguida. } }. que se torna o manipulador personalizado DLL posteriormente. Para essa explicação passo a passo. Localizar e substituir a definição de ITempConvert4Service interface de exemplo com o seguinte: __interface ITempConvert4Service { [id(1)] HRESULT ConvertTemperature( [in] double dFahrenheit. [out. Salve a solução. consulte Atributos ATL Server. TempConvert4. No mesmo arquivo. Para obter mais informações. que você irá declarar como ConvertTemperature. consulte Criando Serviços da Web XML. Implementar o serviço da Web XML Você fornecer a funcionalidade do seu serviço da Web XML com o código você escrever para a classe do manipulador. // class CTempConvert4Service Observação Os atributos ATL Server que estão localizados entre as definições de interface e classe. Você irá adicionar um método público para esta classe e expor esse método como parte do serviço da Web XML.h. *pdCelsius = ((dFahrenheit . retval]*/ double* pdCelsius) { if (!pdCelsius) return E_INVALIDARG. o Você irá escrever o código que fornece a funcionalidade para o serviço da Web XML no projeto do manipulador. dll.dll. selecione Content Files. clique em Build Solution. Na caixa Name. tais como TempConvert4. No Solution Explorer. e selecione Primary output e Debug Symbols. Para implantar o XML Web Services usando um projeto Web Setup 1. o o 10. você pode adicionar um projeto de instalação da Web ou você pode copiar os arquivos necessários para o servidor de destino manualmente. e depois clique em OK. O grupo primário de saída consiste do projeto DLL. Clique em OK. alterar o projeto para TempConvert4Isapi. consulte Como adicionar e remover resultados Project no editor do sistema de arquivos:. aponte para Add. Para obter mais informações. Primary output e Debug Symbols. TempConvert4. Visual Studio 209 . 8. aponte para Add. O grupo primário de saída consiste do projeto DLL. O grupo símbolos de depuração consiste do arquivo PDB projeto. No Solution Explorer. TempConvert4Isapi. e clique em Web Setup Project. o instalador usa o nome do projeto de implantação ao criar o diretório virtual em seu servidor de implantação. 6. Selecione a Setup and Deployment Projects pasta. selecione Web Application Folder. 5. clique com o botão direito do mouse TempConvert4WebSetup novamente.pdb. O grupo arquivos conteúdo consiste os arquivos restantes para o serviço XML da Web. e suas dependências. 2. No menu File. Clique em OK. você deve implantá-lo em um servidor Web que seja acessível para os clientes que você queira dar suporte. O grupo símbolos de depuração consiste do arquivo PDB projeto. clique com o botão direito do mouse TempConvert4WebSetup. e clique em New Project.pdb. 3.disco. digite TempConvert4WebSetup. Para obter mais informações. e clique em Project Output Na caixa Add Project Output Group de diálogo. Implantando o XML Web Service Para tornar seu XML Web Services disponível para outros. Para implantar o serviço da Web XML em um servidor que não seja o servidor de desenvolvimento. e suas dependências. aponte para Add Project. No menu Build. o o o 7. Para obter mais informações. No painel esquerdo da File System Editor. e clique em Project Output Na caixa Add Project Output Group de diálogo. consulte Como adicionar e remover resultados Project no editor do sistema de arquivos:. TempConvert4Isapi. 4. 9. consulte Editor do sistema de arquivos. TempConvert4.htm e TempConvert4. Observação Por padrão.5. clique em Delete. Finalmente. clique em Build Isso cria um arquivo do Windows Installer no diretório do projeto local. o File System Editor. consulte um destes procedimentos: • • • Passo-a-Passo: acessando um XML Web Services utilizando Visual Basic ou Visual C# Passo-a-passo: Acessando um XML Web Service usando C++ Passo-a-passo: Acessando um XML Web Service usando C++ e o CLR Visual Studio 210 . para criar um aplicativo cliente que acesse esse XML Web Services. consulte Implantando aplicativos e componentes. Para obter mais informações. clique com o TempConvert4WebSetup projeto. clique com o botão direito do mouse bin e. No Solution Explorer. em seguida.11. e no menu de atalho. Executar este arquivo em um servidor Web para instalar este serviço da Web XML. No painel esquerdo de expandir Web Application Folder. 12. 3. Execute o aplicativo do cliente no modo de depuração. 4. Alterar o nome do projeto para TempConvertClient3. e selecione CLR. Escrever código para acessar o XML Web Services. Adicionando uma referência da Web Descoberta de XML Web Services é o processo pelo qual um cliente localiza um XML Web Services e obtém sua descrição de serviço. 5. O processo de descoberta de XML Web Services no Visual Studio envolve interrogar um site da Web seguindo um Visual Studio 211 . e clique Project para abrir a New Project caixa de diálogo. você deve fornecer o seguinte: • • o o o Para essa explicação passo a passo. você irá realizar as atividades a seguir: • • • • Criar um aplicativo do cliente usando o CLR Console Application modelo de projeto. 2.Passo-a-passo: Acessando um XML Web Service usando C++ e o CLR Explicação passo a passo o seguir descreve o processo para acessar um serviço XML da Web de um aplicativo criado usando C++. Clique no CLR Console Application ícone. aponte para New. Para criar um aplicativo de console 1. Durante o curso desta explicação passo a passo. No menu File. Uma máquina atendendo aos requisitos encontrado no Requisitos de hardware do Visual Studio. Expanda o Visual C++ nó. Clique OK para criar o projeto. Observação Para acessar uma implementação diferente do serviço da Web XML. Adicionar uma referência da Web para um XML Web Services. a conversão de temperatura simplesmente substitua os nomes apropriados onde aparece o nome TempConvert3 em toda essa explicação passo a passo. você irá criar um aplicativo de console simples que acessa o serviço da Web XML TempConvert3. que era o nome dado para a Web XML serviço criado no Passo-a-passo: Criando um XML Web Service usando C++ e o CLR. Um serviço XML da Web criado de uma das orientações a seguir: Explicação Passo a Passo: Criando um XML Web Services usando Visual Basic ou Visual C# Walkthrough: Criando um serviço da Web XML usando ATL Server Passo-a-passo: Criando um XML Web Service usando C++ e o CLR Criando um projeto cliente de XML Web Services Para concluir a explicação passo a passo. Sem uma descrição de serviço. 4. O Visual Studio baixa o descrição do serviço e adiciona-o ao seu projeto. Este arquivo de cabeçalho referencia espaços para nome do . Você pode acessar os métodos do XML Web Service da mesma maneira que você acessar métodos qualquer do objeto chamando os métodos da classe de proxy. A descrição de serviço descreve quais serviços estão disponíveis e como interagir com os serviços. de cabeçalho. consulte Descoberta de XML Web Service.h. Em seguida. Para obter mais informações.algoritmo predeterminado.cpp na pasta Source Files e abra este arquivo para edição. Visual Studio adiciona um novo arquivo WebService. Visual Studio 212 . such as http://localhost/TempConvert3WebSetup/TempConvert3. a próxima etapa é para criar uma instância de classe de proxy do serviço da Web XML. Para obter mais informações. OuSe o serviço da Web XML existir na máquina local. consulte Descrição do XML Web Service. renomear a referência da Web. clique no Web services on the local machine Link no painel do navegador. consulte Como: Adicionar e remover referências da Web.asmx. Clique no Go botão para recuperar informações sobre o serviço da Web XML.NET Framework para usar os Serviços XML da Web e a DLL criado necessário. 3. Clique no link para o serviço da Web XML TempConvert3 na lista fornecida para recuperar informações sobre o serviço da Web XML. Se explorar o diretório do projeto local. a ConvertSvc Qual é o espaço para nome será usado para esta referência da Web. A meta do processo é localizar a descrição de serviço. selecione o TempConvert3Client nó de projeto. No Solution Explorer. No menu Project. ao seu projeto. Na caixa Web reference name. digite a URL para obter o descrição do serviço do serviço XML Web você deseja acessar. Adicionar uma referência da Web 1. Acessar o XML Web Services 1. clique em Add Web Reference. 2. ele gera uma classe de proxy e compila uma DLL do descrição do serviço. Acessando o XML Web Services Depois de adicionar uma referência para o serviço da Web XML ao seu projeto. Quando o aplicativo chama esses métodos. você também encontrará o arquivo de fonte Visual C# para a DLL. localize TempConvertClient3. o código gerado pelo Visual Studio trata as comunicações entre o aplicativo e o serviço da Web XML. O aplicativo precisa um meio para se comunicar com o serviço da Web XML e para localizá-lo em tempo de execução. consulte Referências da Web e COMO: Gerar um Proxy de Serviço da Web XML. Na Solution Explorer. Na caixa URL da caixa Add Web Reference de diálogo. Finalmente. Adicionar uma referência da Web ao seu projeto para o XML Web Services faz isso por gerar uma classe proxy que interfaceia com o XML Web Services e fornece uma representação local do XML Web Services. é impossível interagir com um XML Web Services programaticamente. que é um documento XML que usa o WSDL (Web Services Description Language). Clique Add Reference para adicionar uma referência da Web para o destino XML Web Service. Para obter mais informações. Para obter mais informações. ele acessa o serviço da Web XML e exibe o Celsius temperatura equivalente do Fahrenheit digitado. Visual Studio oferece vários métodos para criar e executar um aplicativo de dentro o IDE. Para obter mais informações.exiting: {0}". ou —— Clique à esquerda dessa linha de código na margem indicador. Depurando o cliente de XML Web Services Quando você executar o aplicativo. verifique as configurações de depuração. } Observação O nome da classe do serviço da Web XML gerado quando adicionando uma referência da Web pode diferir daquele mostrado acima como TempConvert3Class. Antes da depuração. Para obter mais informações. clique em Build Solution. Console::Write("Temperature in degrees Fahrenheit: "). 3. 2. 3. Console::Write("Temperature in degrees Celsius: "). consulte HOW TO: definir depuração e configurações de versão. Para obter mais informações. Substituir o conteúdo do arquivo com o seguinte: #include "stdafx. int main(void) { while (true) { try { ConvertSvc::TempConvert3Class^ proxy = gcnew ConvertSvc::TempConvert3Class(). Visual Studio automaticamente e definir as opções padrão apropriado e outras configurações. coloque o cursor na linha de código que chama a função proxy: double dCelsius = proxy->ConvertTemperature(dFahrenheit). Para utilizar um ponto de interrupção e iniciar o aplicativo com depuração 1. } catch (System::FormatException^ e) { Console::WriteLine("Invalid value. break. este aplicativo tem separadas configurações para versões liberação e DEBUG. No menu Build. } } return 0. Visual Studio 213 .h" #include "WebService. consulte COMO: Depurar Código no Editor.ToString()). System::String^ sInput = Console::ReadLine().h" using namespace System. No menu Debug. Pressione F9 para colocar um ponto de interrupção nesta linha de código. consulte Preparação da depuração: Projetos de console. Nessa explicação passo a passo. e->Message). double dFahrenheit = System::Convert::ToDouble(sInput). O Visual Studio cria o projeto e inicia o aplicativo.2. como: • • Start Debugging Start without Debugging Como um projeto do Visual Studio.. No Editor do código.. double dCelsius = proxy->ConvertTemperature(dFahrenheit). Salve a solução. Criadas essas configurações porque você criado este projeto usando o CLR Console Application modelo de projeto. clique em Start Debugging. Este comando instrui Visual Studio para executar o aplicativo no depurador. será colocar um ponto de interrupção no aplicativo e use o Start Debugging método. 4. Console::WriteLine(dCelsius.. O aplicativo cria uma mensagem de solicitação SOAP.4. Em retorno. clique Continue para continuar o processamento. Visual Studio 214 . digite o número 212 e pressione ENTER. no menu Debug. 5. Para obter mais informações. Na janela do console. o aplicativo recebe uma mensagem de resposta SOAP. clique em Delete All Breakpoints. O depurador do Visual Studio realça a linha que contém o ponto de interrupção e. 6. que ele envia para o serviço XML da Web. O aplicativo então analisa a resposta e exibe uma mensagem indicando que 212 Fahrenheit graus é o equivalente de 100 Celsius graus. enquanto interrompido. Quando processamento atingir do ponto de interrupção. Para parar execução do aplicativo e retornar ao editor de código. consulte Explicação detalhada sobre o depurador e Exibindo Dados no Depurador. No menu Debug. você poderá executar uma variedade de tarefas. processamento pára. No menu Debug. clique em Stop Debugging. que era o nome dado para a Web XML serviço criado no Walkthrough: Criando um serviço da Web XML usando ATL Server. clique em Console application. Uma máquina que atenda aos requisitos encontrado no Requisitos de hardware do Visual Studio. Na Win32 Application Wizard. você irá realizar as atividades a seguir: • • • • Criar um aplicativo do cliente usando o modelo Project Win32. 3. Para criar um aplicativo do cliente do serviço XML da Web 1. Durante o curso desta explicação passo a passo. 4. 5. Observação Para acessar uma implementação diferente do serviço da Web XML. clique no Win32 Project ícone. Expanda a Visual C++ Projects pasta. Execute o aplicativo do cliente no modo de depuração. em seguida. e clique Project para abrir a New Project caixa de diálogo. 2. Selecione ATL Para adicionar suporte de Biblioteca ATL. 3. Na página Application Settings. No menu File. Visual Studio 215 . Adicionar uma referência da Web para um XML Web Services. a conversão de temperatura simplesmente substitua os nomes apropriados onde aparece o nome TempConvert4 em toda essa explicação passo a passo. aponte para New. Clique OK Para iniciar o Win32 Application Wizard. 2. Escrever código para acessar o XML Web Services. Alterar o nome do projeto para TempConvertClient4. Clique em Finish. e.Passo-a-passo: Acessando um XML Web Service usando C++ Explicação passo a passo o seguir descreve o processo para acessar um serviço XML da Web de um aplicativo criado usando C++. execute o seguinte: 1. você deve fornecer o seguinte: • • o o o Para essa explicação passo a passo. você irá criar um aplicativo de console simples que acessa o serviço da Web XML TempConvert4. Um serviço XML da Web criado de uma das orientações a seguir: Explicação Passo a Passo: Criando um XML Web Services usando Visual Basic ou Visual C# Walkthrough: Criando um serviço da Web XML usando ATL Server Passo-a-passo: Criando um XML Web Service usando C++ e o CLR Criando um projeto cliente de XML Web Services Para concluir a explicação passo a passo. O aplicativo deve ter um meio para se comunicar com o serviço da Web XML e para localizá-lo. o Output Window. consulte Como: Adicionar e remover referências da Web.asmx. Acessando o XML Web Services 4. clique em Add Web Reference. Para obter mais informações. O descrição do serviço ou contrato. O Visual Studio gera um novo arquivo de cabeçalho mas não adiciona-lo para o projeto.Adicionando uma referência da Web Descoberta de XML Web Services é o processo pelo qual um cliente localiza um XML Web Services e obtém sua descrição de serviço. Para obter mais informações. ele não salvar o arquivo de cabeçalho gerado para a pasta do projeto. 3. Sem uma descrição de serviço. Adicionar uma referência da Web ao seu projeto para o XML Web Services faz isso por gerar uma classe proxy que interfaceia com o XML Web Services e fornece uma representação local do XML Web Services. que é o namespace que você usará para essa referência da Web.h. digite a URL para obter o descrição do serviço do serviço XML Web você deseja acessar. é impossível interagir com um XML Web Services programaticamente. consulte Referências da Web. O processo de descoberta de XML Web Services no Visual Studio envolve interrogar um site da Web seguindo um algoritmo predeterminado. Este arquivo de cabeçalho é re-Generated sempre que você criar o projeto. examine o conteúdo da seção janela saída do log de compilação (BuildLog. A meta do processo é localizar a descrição de serviço. consulte Descoberta de XML Web Service. Clique no botão Go para recuperar informações sobre o XML Web Services. Na caixa URL da caixa Add Web Reference de diálogo. que é um documento XML que usa o WSDL (Web Services Description Language). consulte Como: Adicionar e remover referências da Web. Para obter o nome correto do arquivo de cabeçalho. Clique Add Reference para adicionar uma referência da Web para o destino XML Web Service. O nome de arquivo correto aparece em uma linha que lembra o seguinte: /out:ConvertSvc. No menu Project.htm no diretório Arquivos intermediário) ou Output Window o. descreve quais serviços estão disponíveis e como interagir com os serviços. 2. Clique no link para o serviço da Web XML TempConvert4 na lista fornecida para recuperar informações sobre o serviço da Web XML. No entanto. Para obter mais informações. such as http://localhost/TempConvert4/TempConvert4Service. Na caixa Web reference name. clique no link Web services on the local machine no painel do navegador. Para exibir no menu View Aponte para Other Windows e clique em Output. Adicionar uma referência da Web 1. Visual Studio 216 . Para obter mais informações. Para obter mais informações. renomeie a referência da Web para ConvertSvc. OuSe o XML Web Services está na máquina local. O nome do arquivo de cabeçalho depende do serviço da Web XML você optar por acessar. consulte Descrição do XML Web Service. cin >> dFahrenheit. Para exibir no menu View Aponte para Other Windows e clique em Output. Para obter mais informações. &dCelsius). while (1){ cout << "Enter a temperature in degrees Fahrenheit: ". Em seguida. aparece o código abaixo 6. #include "stdafx. 5. Acessar o XML Web Services 1. consulte Criar clientes do serviço XML da Web.h. Insira o código a seguir: Observação O código a seguir usa uma classe denominada TempConvert4Service::CTempConvert4Service. Você irá exibir o valor retornado pelo serviço da Web XML no console. TempConvert4Service::CTempConvert4Service ws. a próxima etapa é para criar uma instância da classe proxy. if (!cin. #define ATL_SOCK_TIMEOUT INFINITE // Minimum system requirements are Windows 98. Add the following #include statements after the existing #include for <atlbase. você criará uma instância da classe de proxy do serviço da Web XML. o Output Window. No Solution Explorer. No Solution Explorer. Adicione o seguinte # definir instruções (em negrito) após o # existente definir instrução WIN32_LEAN_AND_MEAN: #define WIN32_LEAN_AND_MEAN // Disable client timeout for testing. você irá levar um valor. double dFahrenheit = 0.0. double dCelsius = 0.h" void AccessService(){ using namespace std. Primeiro. Quando o aplicativo chama esses métodos.h> #include <iostream> Observação O nome do arquivo de cabeçalho gerado quando adicionando uma referência da Web pode diferir daquele mostrado acima como ConvertSvc. if (SUCCEEDED(hr)) cout << dFahrenheit << " F = " << dCelsius << " C\n" << endl. 2. e fazer uma chamada ao método do serviço ConvertTemperature da Web XML chamando o método na classe proxy.h>: #include "ConvertSvc. que o console fornece.htm no diretório Arquivos intermediário) ou Output Window o. localize TempConvertClient4. O nome de arquivo correto aparece em uma linha que lembra o seguinte: /out:ConvertSvc. else cout << Visual Studio 217 . Para obter o nome correto do arquivo de cabeçalho.0.h" #include <conio. break.h. localize stdafx. Windows NT 4. } HRESULT hr = ws. or later #define _WIN32_WINDOWS 0x0410 3.good()){ cout << "Not a temperature" << endl. 4. Aponte para o arquivo de cabeçalho gerado na sua pasta do projeto para determinar o nome de classe adequado para o serviço da Web XML e substitua-onde TempConvert4Service::CTempConvert4Service.h na pasta Header Files e abra este arquivo para edição.Após seu projeto tem uma referência para o serviço XML da Web.0. consulte Criar clientes do serviço XML da Web. Você pode acessar os métodos do XML Web Service da mesma maneira que você acessar métodos qualquer do objeto chamando os métodos da classe de proxy.cpp na pasta Source Files e abrir este arquivo para edição. o código gerado pelo Visual Studio trata as comunicações entre o aplicativo e o serviço da Web XML. Default is 10000 milliseconds. Para obter mais informações. examine o conteúdo da seção janela saída do log de compilação (BuildLog.ConvertTemperature(dFahrenheit. CoUninitialize(). clique em New Breakpoint. Visual Studio automaticamente e definir as opções padrão apropriado e outras configurações."An error occurred: " << hr << endl. clique em Build Solution. Dica é SHIFT+F5 o atalho do teclado padrão para Stop Debugging. Na janela do console. o navegador padrão exibe o arquivo. Salve a solução. 4. como: • • Start (with Debugging) Start without Debugging Como um projeto do Visual Studio. 8. Criadas essas configurações porque você criado este projeto usando o modelo do projeto Project Win32. No menu Build . } return 0. Visual Studio 218 . Nessa explicação passo a passo. No menu Debug. Para utilizar um ponto de interrupção e iniciar o aplicativo com depuração 1. clique em Stop Debugging. Para interromper a execução do XML Web Service e retornar para o Code Editor. 2. ele acessa o serviço da Web XML e exibe o Celsius temperatura equivalente do Fahrenheit digitado. Dica é F5 o atalho do teclado padrão para Start. Depurando o cliente de XML Web Services Quando você executar o aplicativo. _TCHAR* argv[]){ if (SUCCEEDED(CoInitialize(NULL))){ AccessService(). } } int _tmain(int argc. O Visual Studio compila o projeto e o implanta no servidor de desenvolvimento designado.asmx a partir do servidor de implantação. ou —— No menu Debug. Após a conclusão. feche o navegador. No menu Debug . será colocar um ponto de interrupção no aplicativo e use o Start (with Debugging) método. clique em Start. digite o número 212 e pressione ENTER. este aplicativo tem separadas configurações para versões liberação e DEBUG. } 7. Na guia Function. 5. Este comando instrui Visual Studio para executar o aplicativo no depurador. consulte HOW TO: definir depuração e configurações de versão. Para obter mais informações. digite AccessService na caixa Function e clique OK para colocar um ponto de interrupção na declaração AccessService de método. O Visual Studio oferece vários métodos para criar e executar um aplicativo de IDE. 3. clique Continue para continuar o processamento. enquanto interrompido. 6. Visual Studio 219 . 9. o aplicativo recebe uma mensagem de resposta SOAP. no menu Debug. No menu Debug. O depurador do Visual Studio realça a linha que contém o ponto de interrupção e.Quando processamento atinge a AccessService função. 8. Dica + CtrlShift + F9 é o atalho do teclado padrão para Clear All Breakpoints. processamento pára. clique em Stop Debugging. Para obter mais informações. Em retorno. No menu Debug. Dica é F5 o atalho do teclado padrão para Continue. clique em Clear All Breakpoints. consulte Explicação detalhada sobre o depurador e Exibindo Dados no Depurador. 7. que ele envia para o serviço XML da Web. O aplicativo cria uma mensagem de solicitação SOAP. você poderá executar uma variedade de tarefas. Para parar execução do aplicativo e retornar ao editor de código. O aplicativo então analisa a resposta e exibe uma mensagem indicando que 212 Fahrenheit graus é o equivalente de 100 Celsius graus. Você criará o aplicativo é um aplicativo de dados simples com pesquisa e editar. consulte Visão geral do ADO. será necessário: • Acesso a um servidor com o exemplo de SQL Server do Northwind. 3. Você criará um cliente Windows para exibir a tabela Clientes do banco de dados de exemplo Northwind SQL Server. No mesmo. você pode usar a autenticação do Windows para obter acesso ao banco de dados e testar seu aplicativo. Criar o objeto comercial da camada intermediária 1. A camada de negócio-Objeto tratará acessar os dados e distribui-lo para os clientes. Criar um Projeto Serviço da Web ASP. e interface de usuário. Essa organização de projetos. Processo para criar um aplicativo distribuídos • Um cenário possível para desenvolver um aplicativo distribuído consiste em criar uma camada ao mesmo tempo. O banco de dados Northwind é um banco de dados de exemplo que você pode instalar com SQL Server. você criará um aplicativo de várias camadas. Tanto o servidor de aplicativos e o servidor de banco de dados precisará que residam na mesma intranet. A camada de dados é um banco de dados no SQL Server. intranet.NET. embora o banco de dados pode residir em outro servidor. talvez começando com a camada de dados. Pré-requisitos A fim de concluir este explicação passo a passo. Você criará o serviço da Web XML e o cliente aplicativos no mesmo servidor. os dados já foi gerado e está disponível no banco de dados Northwind no SQL Server. 2.NET Criar e configurar uma conexão de banco de dados e um esquema DataSet Expor DataSet do seu objeto comercial Criar a interface de usuário Visual Studio 220 .NET. A camada da interface do usuário consistirá em tanto um aplicativo baseado na Web e um aplicativo Windows tradicional. 2. Você então criará um aplicativo do Windows que irão se comunicar com este serviço XML da Web para recuperar um DataSet que contém as informações do autor. Para essa explicação passo a passo. O processo para essa explicação passo a passo é a seguinte: 1. O aplicativo consiste em três camadas lógicas: Dados. Portanto. Essa organização pode não ser exatamente a arquitetura você deseja para aplicativos você Criar por conta própria. e finalmente criar a interface do usuário.Passo-a-passo: Criando um aplicativo distribuído Nessa explicação passo a passo. objeto comercial. Uma compreensão básica de como dados são manipulados no Visual Studio . configurado para autenticação Integrated Windows. distribuídos. o explicação passo a passo iniciará com criando o objeto — comercial o serviço — da Web XML seguido por criando as interfaces — dois usuário uma página de formulários da Web e um formulário do Windows. Você criará um serviço XML da Web para recuperar dados que contém informações clientes a partir do banco de dados. Para obter mais informações. essa organização remove muitos dos detalhes de acessar recursos para que você pode ver a interação do serviço XML da Web e os aplicativos cliente. e mover para o objeto regra negócio-camada intermediária. consulte Programação na Web com XML Web Services. 3. 3. 2. Você além disso.NET 1. 2. retornará um DataSet a partir do banco de dados O segundo. No menu Website. Selecione ASP. Na caixa Location.. defina a File Name propriedade de Service para CustomersService. UpdateCustomers. O componente serviço XML da Web nessa explicação passo a passo. aponte para New então Web Site para exibir a New Web Site caixa de diálogo. No menu File. Para obter detalhes. Métodos Serviço da Web XML depois serão adicionados para expor o DataSet. No Solution Explorer.. em seguida clique em OK Dica Como o servidor Web estiver em seu computador. Selecione Dataset e clique em Add 5. A Add New Item caixa de diálogo será aberta. Criar uma interface do usuário do Windows Implantar a solução ou adicionar mais recursos Criar o objeto Business Tier intermediáriaO objeto comercial você criar será executado em um servidor Web para fornecer o desempenho e escalabilidade necessária para um aplicativo distribuído. Criar e configurar uma conexão de banco de dados e um esquema DataSet Do TableAdapter Configuration Wizard irá adicionar um DataSet ao seu aplicativo e depois usar para gerar um tipo TableAdapter específico à tabela Clientes do banco de dados. que tornará possível para outros aplicativos para exibir e modificar DataSet. http://ServerName/CustomersWebService. poderá usar o nome do servidor LOCALHOST. clique Service. 4. Nesse componente será criar uma conexão com o armazenamento de dados e obter uma instância dos dados usando um DataSet.NET Web Service no painel Visual Studio Installed Templates. O serviço da Web XML será expor dois métodos. será implementar o objeto comercial como um serviço XML da Web para que os clientes podem usar protocolos padrão da Internet para se comunicar com o objeto comercial de qualquer plataforma. GetCustomers. Observe que o serviço da Web for inicializado no idioma padrão que você escolheu para Visual Studio. digite o nome do servidor Web (no seu computador de desenvolvimento) com o nome do projeto. O CustomersWebService projeto é adicionado à solução.. escolha Add New Item. Visual Studio 221 . e.asmx para selecioná-la. Para criar um adaptador conexão e dados de banco de dados 1.1. será mantenha as conexões de dados e definição DataSet. Na janela Propriedades. O primeiro. irá atualizar o banco de dados com alterações do usuário Para criar um projeto Serviço da Web ASP. 6. 6. for iniciado 3. No TableAdapter Configuration Wizard. tipo SELECT * FROM Customers e Enter a SQL Statement Clique em Next. clique OK para estabelecer a conexão. e Microsoft SQL Server é PreSelected como o tipo de banco de dados 4. 10. Você criou uma conexão com o banco de dados. 11. 13. Clique Test Connection para validar as informações fornecidas.DataSet é adicionado ao seu projeto. 7. Uma nova conexão de banco de dados é criado e adicionado à caixa suspensa no TableAdapter Configuration Wizard. Na caixa Add Connection de diálogo. digite o nome do SQL Server onde o banco de dados Northwind está instalado. e gerado o adaptador de tabela que interage com o banco de dados. No painel Choose a Command Type. A Add Connection caixa de diálogo Abrir. você deve alterar os arquivos de projeto e configurar o projeto usando a Internet Information Services ferramenta. É feito isso desativando o acesso anônimo e ativar a representação. 12. clique New Connection para criar sua conexão. 9. Se você tiver SQL Server no computador local. Selecione o Northwind banco de dados a partir da lista. Para configurar a autenticação integrada do Windows para o projeto. No painel. e. e a TableAdapter Configuration Wizard. Observação Se você não faça ter integrada segurança definida backup em seu sistema. Na. Selecione Use Windows Authentication para as informações de logon. consulte o administrador do banco de dados. 5. escolha Save All Você precisará definir as configurações de segurança do seu projeto para trabalhar com segurança integrada. Observação Se a conexão de banco de dados falhar. Verifique se seu banco de dados está selecionado na caixa suspensa e clique em Next. digite (local). clique Choose Methods to Generate Finish painel. 8. verifique se que Use SQL Statements está selecionado e clique em Next. Clique Next novamente para salvar a seqüência de conexão para o arquivo de configuração. No menu File. em seguida. um dataset digitado. Visual Studio 222 . consulte o administrador de rede. CustomersTableAdapter myAdapter = new DataSetTableAdapters. 2. Administrative Tools do Control Panel ele pode ser executado a partir de. Adicionar um método denominado GetCustomers para entregar uma DataTable para o cliente. 4. Expanda o Default Web Site nó. (Para obter mais informações sobre como iniciar essa ferramenta. Agora você configurou seu diretório de serviço da Web XML. 3. 10. clique duas vezes o arquivo web. Adicionar uma linha para o corpo de classe para criar uma nova instância do adaptador de tabela como mostrado abaixo: Visual Basic Dim myAdapter As New DataSetTableAdapters. 6. Clique com o botão direito do mouse no nó de CustomersWebService e escolha Properties No menu de atalho.Para configurar a autenticação integrada do Windows 1. 3. Clique na Directory Security guia.CustomersTableAdapter(). consulte o Windows ajuda documentação). Partir do Build menu. 4. Desmarque a Anonymous Access caixa de seleção. Adicionar a seguinte marca na linha após a <system. Visual Basic <WebMethod()> Public Function GetCustomers() As _ DataSet. Marque a Integrated Windows authentication caixa de seleção. 7. <identity impersonate="true"/> Expor o customersDataTable de seu objeto Business A próxima etapa nessa explicação passo a passo é para expor o objeto DataSet você apenas criado a partir seu objeto comercial.CustomersDataTable Return myAdapter. Expanda o nó para o servidor. Inicie a Internet Information Services ferramenta. 5. clique duas vezes Service.web> marca para configurar a segurança integrada para o serviço da Web XML. 8.config no Solution Explorer. 2.CustomersTableAdapter DataSetTableAdapters. mostrado a seguir retorna uma DataTable preenchido com os dados do cliente. Essa ação tornará DataSet disponíveis para aplicativos Windows ou da Web para usar. 9. Clique no Edit botão na seção Anonymous access and authentication control. Na Solution Explorer. Esse método.GetData End Function C# Visual Studio 223 . escolha Build Solution para a criação da solução. Adicionar métodos para o serviço da Web XML 1.vb para abrir o Editor de Código. Retornar para o projeto no Visual Studio. incluindo chamadas para o sistema de arquivos e o registro. Os dados no banco de dados serão exibidos em um DataGridView controle quando um Load botão no Visual Studio 224 . consulte Introdução aos adaptadores de dados. Além disso. Não é menor de uma carga no servidor que com um front-end da Web. apresenta um DataSet. uma interface do Windows fornece maior funcionalidade e uma experiência mais rica que uma interface baseada na Web.[WebMethod] public DataSet. mostrado abaixo.GetData(). 7. a próxima etapa é para criar o cliente interfaces. que consiste em um formulário do Windows. } 5. Esse método. Ambos são criados.CustomersDataTable parâmetro que contém os dados alterados e atualiza o banco de dados através do CustomersTableAdapter. Não é necessário para que você possa criar as duas interfaces. irá conter uma referência da Web para CustomersWebService. Interface do Usuário do Windows Uma interface do Windows usa recursos do computador cliente para manipular parte do processamento do aplicativo. neste exemplo como separados projetos na mesma solução. Do GetCustomers o cliente acessar essas funções através de e UpdateCustomers métodos Serviço da Web XML. C# [WebMethod] public void UpdateCustomers(DataSet.CustomersDataTable GetCustomers() { Return myAdapter. O Update método aceita as alterações no DataSet. Partir do File menu. você deve adicionar a verificação de erros e exceção tratamento para esses métodos.Update(customerChanges). uma interface do Windows pode aproveitar dos recursos disponíveis através do sistema operacional. } Observação Em um aplicativo de produção. O cliente então usará este DataSet retornado para atualizar sua própria instância da Customers DataTable. 6. escolha Save All. Adicionar um método denominado UpdateCustomers para propagar alterações a partir do cliente de volta para o banco de dados. Há dois cenários nessa explicação passo a passo: um Windows Form tradicionais e uma página de formulários da Web. Para obter informações sobre o Update método e aceitando alterações em um DataSet. Partir do Build menu.Update método. você ter criado um objeto comercial da camada intermediária que contém um DataSet acoplado a um banco dados do SQL Server. escolha Build Solution.CustomersDataTable customerChanges) { myAdapter. Nas seções anteriores. DataSet é retornada para o cliente. O aplicativo do Windows. Você adicionou código ao meio-nível CustomersWebService da Web XML serviço para obter dados de uma fonte de dados e atualizar a fonte de dados com alterações. Crie a interface de usuário Depois de criar um objeto comercial da camada intermediária para acesso a dados e expondo-lo como um serviço XML da Web. porque o servidor não não precisa para executar todos os a lógica do aplicativo. Geralmente. e clique Add Web Reference no menu de atalho Clique em Web Services In This Solution e clique em CustomersService.DataSet. Selecione Windows Application no painel Visual Studio Installed Templates. criando uma instância da classe do Visual Studio 225 . No menu View. Arraste um DataGridView controle da guia Data da caixa de ferramentas para o formulário. O CustomersWinClient projeto é adicionado à solução.CustomersDataTable(). clique em Designer. O DataGridView controle permite direta edição. clique em OK. No Solution Explorer. O código para este botão será chamar método do serviço UpdateAuthors da Web XML para salvar as alterações de volta para o banco de dados. Agora você pode criar uma instância do DataSet DataSet em seu aplicativo. Clique duas vezes no LoadData botão para criar um manipulador de eventos vazio para o Click evento. clique com o CustomersWinClient projeto. Do Toolbox arraste um Button controle da guia Common Controls Da para o formulário. Clique em Add Reference. O formulário também terá um botão Salvar. Clique duas vezes no formulário para abrir o Code Editor. 2.formulário é clicado.CustomersDataTable localhost. aponte para Add e escolher New Project. Para adicionar os controles ao formulário 1. 3. Sob a declaração de classe.CustomersDataTable CustomerData = new localhost. 4. 5.DataSet. No menu File. seguida.DataSet. Adicionar uma referência da Web para o projeto Serviço da Web ASP. 4. Nome do Projeto CustomersWinClient e selecione um local para o projeto. para abrir a Add New Project caixa de diálogo. com alterações de dados passadas diretamente para o conjunto de dados subjacente. Do Toolbox Arraste outro Button controle da guia Common Controls Da para o formulário.DataSet Como mostrada abaixo: Visual Basic Dim CustomerData As New localhost. Métodos Serviço da Web XML são chamados.NET criado anteriormente: 1. 2. Para adicionar código para o LoadData e SaveData botões 1. Esse comportamento de carregamento é implementado por chamar método do serviço GetCustomers da Web XML. 3. criamos uma instância do localhost. Defina propriedades do botão Name para SaveData e sua Text propriedade para Save. Form1 automaticamente é adicionado ao projeto e aparece o Windows Forms Designer. 3. Defina propriedades do botão Name para LoadData e sua Text propriedade para Load. 2. Para criar o aplicativo Windows 1. Net.NET. ws. Observação Em um aplicativo de produção. System. Selecione CustomersWinClient no Solution Explorer.Service(). faça algumas alterações.EventArgs e) { localhost.Credentials = System.EventArgs e) { if (CustomerData. C# private void LoadData_Click(object sender. A Credentials propriedade do serviço da Web XML é usada para passar sua identidade para o serviço da Web XML. C# Adicione o seguinte código para os métodos: private void SaveData_Click(object sender. você precisará substituir localhost no exemplo de código com o nome do servidor que executa o serviço da Web XML. Clique duas vezes no SaveData botão para criar um manipulador de eventos vazio para o Click evento.Merge(ws. Partir do File menu. ws. escolha Save All.serviço primeiro e depois chamar os métodos do serviço.DefaultCredentials.DataSource = CustomerData. Na seção anterior. ws. que por sua vez passa-no para o servidor de banco de dados.DefaultCredentials. Para obter mais informações.GetCustomers()). você adicionou um projeto do Windows Forms para a solução para atuar como uma interface do Windows. 4. No menu View. System. DataGridView1. Próximas etapas Visual Studio 226 . clique em Designer. CustomerData.CredentialCache. } 2. clique Save para salvar as alterações feitas. 2.UpdateCustomers(CustomerData). e seguida. Uma janela é exibida que contém um DataGridView vazia. clique com o botão direito do mouse e escolha Set as StartUp Project.Net. 3.Service ws = new localhost. Você conectado o formulário Windows ao serviço da Web XML você criado a primeira seção e usado DataGridView e Button controles para criar a interface do usuário para carregar e atualizando os dados. DataSet retornado será mesclado com DataSet CustomerData .Credentials = System. seria deseja considerar questões de simultaneidade de dados na etapa.HasChanges()) { localhost.CustomersService().CredentialCache.Service ws = new localhost. o GetCustomers método for chamado. Pressione CTRL + F5 para executar o aplicativo. Observação Se o serviço XML da Web não está sendo executado no computador local. Clique Load para preencher a tabela. Nesse caso. consulte Introdução ao Concurrency de dados no ADO. } } Para executar o aplicativo 1. 3. Adicione o código mostrado abaixo para o método. • Acesso da Web à Internet de suporte Essa explicação passo a passo trata autenticação para aplicativos da intranet. O aplicativo pode ser acessado pelos usuários através da Internet. consulte Usando a autenticação do IIS com representação ASP. se que você deseja dar a funcionalidade adicional de programa. A segurança de banco de dados é apenas uma preocupação para aplicativos da Web. portanto você pode precisa uma solução de autenticação diferente.Neste ponto você pode implantar seu aplicativo ou. Para obter mais informações.NET. • Implantar a solução Você pode implantar seu aplicativo da Web em um servidor ou criar um projeto de instalação para o aplicativo Windows. Visual Studio 227 . Você também pode investigar criando uma interface da Web para seu aplicativo em combinação com protocolos de acesso da Web. Algumas das sugestões são fornecidos abaixo. consulte Práticas recomendadas de segurança básicas para aplicativos da Web (Visual Studio). Para obter uma discussão de segurança de aplicativo da Web. • Considere segurança Essa explicação passo a passo usa autenticação integrada do Windows para controlar o acesso ao banco de dados. Para obter informações sobre como implantar seu aplicativo Windows consulte Passo a passo: Distribuindo um aplicativo baseado no Windows. Alterações feitas em um item compartilhado são refletidas em todos os projetos e soluções. O controle de código fonte do Visual Studio permite que você: • Gerencie o acesso ao banco de dados. Você pode usar essa interface em arquivos em lotes para automatizar as tarefas de controle de código fonte executadas regularmente. por exemplo. embora eles possam ser implementados como outros tipos de módulos de software. consulte a ajuda do Visual SourceSafe. Para obter detalhes do plug-in. Automatizar as operações de controle de código fonte mais comuns. é possível que diferentes projetos e soluções compartilhem o mesmo item sob controle de versão. Recuperar versões sucessivas de itens sob controle de versão. A maioria dos pacotes do controle de código fonte do Visual Studio armazenam dados que distinguem as diferentes versões de um item sob controle de versão. Economizar espaço em disco no pacote do controle de código fonte e no servidor associado. você pode gerenciar seus projetos individuais e de equipe facilmente usando os recursos do controle de código fonte do Microsoft Visual Studio. Recuperar exclusões acidentais. Um exemplo de um plug-in de controle de origem é o plug-in SourceSafe LAN suportado pelo Visual SourceSafe. O controle de código fonte do Visual Studio fornece suporte ao acesso de arquivos compartilhados e individuais. Manter o histórico detalhado dos itens sob controle de versão. Trabalhar de modo colaborativo em projetos e soluções. Também provê mecanismos para mesclagem de arquivos. um pacote do controle de de código fonte do Visual Studio pode definir uma interface de linha de comando que ofereça suporte a recursos importantes do controle de código fonte. VSIP pode hospedar uma variedade de pacotes de controle de origem. geralmente implementados como plug-ins escritos para os protocolos apropriados. Visual Studio 228 .Controle de Código Fonte para o Visual Studio Sem sair do ambiente de desenvolvimento. Muitos pacotes fornecem mecanismos para armazenar e recuperar o histórico de um item. Com o compartilhamento de arquivos. • • • • • • Introdução ao controle de origem O Visual Studio oferece suporte ao controle de origem usando a camada Visual Studio Integration Protocol (VSIP) no seu Integrated Development Environment (IDE). Por exemplo. data e hora de criação. Observação O Visual Studio trata pacotes de controle de origem como plug-ins. O controle de código fonte do Visual Studio fornece suporte a restauração da última versão do arquivo em que foi realizado o check-in. estão disponíveis no menu File do Visual Studio. Envie um link. para todos os membros da equipe. esses comandos são ativados somente depois que você tiver escolhido o plug-in de Visual Studio 229 . Consulte "Visão Geral (controle de origem)" na ajuda do Visual Studio para obter detalhes de design de controle de origem no Visual Studio. Criar um banco de dados de controle de origem de acordo com a funcionalidade do determinado plug-in. Visual SourceSafe Explorer. Esta seção da Ajuda também fornece todas as informações que serão necessárias para desenvolver um pacote de controle de origem de terceiros que seja compatível com Visual Studio. As operações que estão ativas são variáveis. Check Out e Add to Source Control. dependendo do plug-in de controle de origem. você deve. geralmente. instalar o aplicativo de terceiros e/ou o(s) plug-in(s) de controle de origem nos computadores cliente e servidor para seu site. No entanto. Noções básicas de controle de origem suportados pelo Visual Studio O suporte de controle de origem básico no Visual Studio inclui a configuração de plug-in de controle de origem e opções de ambiente. no qual um usuário que quer modificar um arquivo deve verificá-lo exclusivamente. o estilo de trabalho Lock-Modify-Unlock. com o local do banco de dados. Antes que você e sua equipe possam aproveitar as vantagens dos recursos de controle de origem no Visual Studio IDE. por exemplo. e configurar as opções de ambiente para o plug-in.O controle de origem do Visual Studio é simplesmente um ambiente para plug-ins de controle de origem de terceiros. por exemplo. Esta entrada é acessível selecionando-se Options no menu Tools do Visual Studio. acesso ao banco de dados. Você usará a caixa de diálogo Options para selecionar o plug-in que você deseja utilizar para controle de origem. Depois de instalar como indicado pelas instruções de terceiros. Se o plug-in de controle de origem que você deseja usar não estiver instalado em seu computador. Para usar um plug-in de controle da origem de terceiros. O uso apropriado dos mecanismos de controle de origem no Visual Studio garante que somente arquivos corretos sejam adicionados ao controle de origem e que os arquivos de projeto e solução do Visual Studio sejam atualizados com os detalhes corretos do plug-in específico. por exemplo. É importante lembrar que você deve usar controle de origem em mecanismos do Visual Studio para interagir com um plug-in de controle de origem. Configuração de Plug-in de Controle de Origem e Comutação O controle de origem do Visual Studio suporta configuração e comutação de plug-in através da entrada Source Control na caixa de diálogo Options. versionamento e manipulação de projetos do Visual Studio. • • Acesso ao Banco de dados Comandos básicos de acesso ao banco de dados. soluções e arquivos e metadados associados. sua funcionalidade só é ativada pela instalação de um plug-in. instale o produto de terceiros que ofereça suporte ao plug-in e reinicie o Visual Studio para registrá-lo. comutação de plug-in. você deve: • • Determinar se qualquer plug-in de controle de origem está disponível. O controle de origem no Visual Studio também aplica protocolos do controle de acessos ao banco de dados. sua funcionalidade estará disponível através do Visual Studio. Você deve consultar a documentação de terceiros para detalhes operacionais de pacotes específicos. Por isso. Não use outras aplicações de cliente apresentadas por terceiros que forneçam o plug-in. user Arquivos de informação da Web. mas a raiz única de um controle de origem. por exemplo.exe. Propagação de alteração aplica-se a operações de exclusão.csproj. Esta raiz é um caminho ao diretório pai de todas as pastas de trabalho e arquivos que compõem a solução ou projeto. o plugin de controle de origem irá alterar a cópia de trabalho do item controlado por fonte. usados para controlar comportamento em tempo de execução de um projeto do Visual Studio. para usar um comando Check In. renomeação e mudança de local. Por exemplo. se uma solução contém arquivos ou projetos que residem em mais de uma unidade de disco. por exemplo. csproj.controle de origem que deseja usar. arquivos *. o controle de origem do Visual Studio apóia o conceito de uma raiz super-unificada.webinfo. a cópia principal no banco de dados. você pode usar um comando Add to Source Control depois de ter escolhido um plug-in. a primeira coisa que um plug-in de controle de origem deve fazer é identificar uma raiz única para o item que está sendo adicionado. Arquivos de opção de projeto de usuários.. *. e as cópias de outros usuários. arquivos *. por exemplo. Arquivos de configuração de aplicativos com base em XML.dll e *. o plug-in que você tiver escolhido chama a correspondente funcionalidade de terceiros e/ou o ambiente para concluir a operação associada. Entretanto. por exemplo.webinfo. Como Controle de Origem Trata Soluções e Projetos Quando você adiciona uma solução ou projeto ao controle de origem.suo). você deve ter um item selecionado no Solution Explorer. Manipulação de arquivo pelo controle de origem Você pode adicionar os seguintes arquivos ao controle de origem do Visual Studio: • • • Arquivos de solução (*. ou arquivo no Solution Explorer do Visual Studio. Quando você solicitar uma operação para qual a propagação de alteração estiver ativada. Contudo. Algumas operações de acesso são ativadas somente com o plug-in selecionado. que controlam o local da raiz virtual de um projeto da Web Criar arquivos de saída. arquivos *. vbproj. quando você fizer o check-in no item e os outros usuários o recuperarem. Arquivo de projeto. Para apoiar esta situação. enquanto outras operações estão somente disponíveis quando você também tiver selecionado um projeto do Visual Studio. *. não há nenhuma pasta física à qual uma raiz única pode fazer o mapa. *. Quando você usa um dos comandos básicos de acesso ao banco de dados. Arquivos que você não pode adicionar ao controle de origem incluem o seguinte: • • • • Arquivos de opção de solução de usuário (*. vbproj. Uma solução pode mapear a unidade de disco.SLN). não. Uma raiz única geralmente mapeia para um caminho físico no disco.user. *.vbproj. solução. Este tipo da raiz é um contêiner virtual e Visual Studio 230 .csproj. A propagação da alteração do espaço para nome O controle de origem do Visual Studio oferece suporte à propagação de alteração do espaço para nome em plug-ins controle de origem. Uma solução bem-formada é uma solução para a qual a estrutura hierárquica no disco combina com a sua estrutura no Solution Explorer. Se uma solução não é bem-formada. Geralmente. Visual Studio 231 . mas isso não é recomendável. Muitas tarefas de controle de origem são mais fáceis de executar quando não há um mapeamento um-para-um entre os elementos individuais desse modo de visualização.sln) e arquivos de opção de solução de usuários (*. consulte COMO: desativar a criação da pasta < nomedasolucao>.root.todos os projetos e os arquivos em uma solução controlada por fonte estão localizados abaixo dele.root para conter as cópias principais de arquivo de solução (*. organizados do mesmo modo no disco como eles estão no Solution Explorer e no banco de dados. o plug-in de controle de origem cria uma pasta sob a pasta . Quando você adiciona uma solução usando um plug-in de controle de origem com recursos avançados. é um retrato lógico do conteúdo de uma solução ou projeto. o plug-in do controle de origem cria uma pasta abaixo da pasta *. Soluções no Visual Studio são bem-formadas ou não. o modo design é limpo e significativo. O uso de solução raiz oferece os seguintes benefícios: • Menos prompt. A solução raiz garante que todos os projetos em uma solução possam ser identificados como pertencentes ao mesmo conjunto. • Você pode desativar a criação de pasta < nomedasolucao >. assim. essa pasta é < nomedasolucao >. se você criar as suas soluções e projetos e os acrescentar ao controle de origem usando as configurações padrões do Visual Studio. Finalmente. Para mais informações. a pasta . Observação Quando você adicionar um projeto único ao controle de origem. Arquivos desnecessários estão ocultos e arquivos de vários locais físicos diferentes são colocados em um contêiner de projeto único. suas soluções e projetos não serão. Em seguida. as pastas para cada projeto adicional são criadas em paralelo com a pasta de solução. Encapsulamento do projeto. o plug-in cria uma pasta raiz vazia de solução no banco de dados. controle de origem.suo) para a solução. e físico. minimiza o número de avisos aos usuários quando você adiciona uma solução para controle de origem e executa outras tarefas.root não será criada.sln para cada projeto adicional no banco de dados do controle de origem. A solução raiz minimiza o número potencial de ligações de controle de origem para uma solução e.root. que você vê no Solution Explorer. Por padrão. Todos os projetos em uma solução bem-formada são armazenados em subpastas da pasta solução no disco. Contudo. Se a solução é bemformada quando você a adiciona ao controle de origem. mesmo quando uma ou mais projetos residam em diferentes partições ou computadores. Modos de exibição de uma solução ou projetos Visual Studio fornece três modos diferentes de exibição de uma solução controlada por origem ou projeto: design. O modo design de uma solução ou projeto.root. o plug-in do controle de origem cria uma pasta para a solução e para o seu projeto inicial. Esta pasta conterá todos os itens em uma solução controlada por fonte. necessariamente. como uma casa com várias salas. provavelmente não refletirá a estrutura hierárquica da lógica ou visão do controle de origem. Isso o ajuda a manter a relação lógica pai-filho entre uma solução e seus projetos no armazenamento. Atribua a cada solução um nome exclusivo e descritivo que se diferencia do nome de cada um dos projetos contidos. você pode instalar uma linha de dados única de alta velocidade de uma sala à rua. crie uma solução em branco e adicione projetos a ela. Se uma solução controlada por origem não for bem formada. Quando você adiciona uma solução ou projeto ao controle de origem. Quando você abre uma solução controlada por fonte. que você vê no Windows File Explorer.O modo de controle de origem de uma solução ou projeto. é também um modo de exibição lógico de uma solução ou projeto. pelo menos. O número de vínculos e conexões depende de como você cria a solução inicialmente e se seus projetos e arquivos estão todos salvos na mesma partição. Você pode pensar em vínculo de controle de origem como representação da linha de dados única criada para a casa. os custos de manutenção são Visual Studio 232 . o plug-in de controle de origem vincula sua cópia de trabalho local de uma solução ou projeto à sua versão no banco de dados. Quando você constrói a casa. Uma pasta controle de origem é criada para cada pasta que contém um arquivo solução ou projeto. Tarifas de Internet são mais caras do que as da casa de conexão única. Evite adicionar arquivos de link para uma solução ou projeto controlado por fonte origem. uma conexão é criada através dessa ligação. Entretanto. Se possível. uma ligação de controle de origem. o plug-in de controle de origem copia o item e todo o seu conteúdo do disco para o banco de dados. Você instala um roteador atrás de um firewall para distribuir a alimentação de dados para outras salas e você paga um provedor de serviços de Internet para conectar sua casa com a Internet. um reflexo do modo de exibição lógico. As diretrizes a seguir podem ajudá-lo a obter fidelidade organizacional entre o modos de exibição de design. Em seguida. Após adicionar o item. Como um exemplo de vínculos e conexões. físico e controle de origem de suas soluções controladas por fonte e projetos: • Primeiro. armazene todos os arquivos de uma solução ou projeto em uma unidade de disco. que você vê em um aplicativo autônomo. • • • Conexões de controle de origem e ligações O Visual Studio define uma conexão como uma ligação de dados ativa entre o Visual Studio e um servidor de banco de dados. No entanto. você pode vê-la como uma casa na qual cada sala é unida à Internet diretamente. necessariamente. com vários projetos. o modo de exibição de controle de origem e design irá espelhar a hierarquia da solução no disco. o modo de exibição de controle de origem não é. um item pode ter várias ligações e requerer várias conexões com o banco de dados. pense em uma solução bem formada de controle de origem. quando você adicionar a solução ao controle de origem. como Visual SourceSafe Explorer. A conexão estabelece um 'aperto de mão' entre a sua cópia de trabalho da solução no disco e a cópia mestra da solução no banco de dados. O modo de exibição físico de uma solução ou projeto. Cada solução controlada por origem tem. Uma vez que uma ramificação tenha sido criada. Terminologia de controle de origem A documentação do Visual Studio usa um número de termos para descrever recursos e conceitos de controle de origem. Banco de dados Local onde todas as cópias mestre. Ramificar em uma etapa. Soluções Single-Binding são mais gerenciáveis do que soluções Multiple-Binding. Se você criar um par de solução de multiprojeto em uma etapa e não selecionar a opção Create Directory for Solution na caixa de diálogo New Project (desativado por padrão). Ramificação Processo de criar uma nova versão.superiores. e mudar para um provedor de serviços de Internet diferente é muito mais difícil e demorado. de um arquivo compartilhado ou projeto sob controle de origem. Versão base A versão do servidor de um arquivo do qual uma versão local é derivada. criando uma solução em branco antes de adicionar seus projetos. Vinculação Informação que correlaciona uma pasta de trabalho de uma solução ou projeto no disco à pasta no banco de dados. estruturas de projeto e informações do usuário são armazenados. Conflito Duas ou mais alterações diferentes para a mesma linha do código em situações em que dois ou mais desenvolvedores tenham feito o check-out e editado o mesmo arquivo. e vários bancos de dados podem ser usados. Elas tornam mais fácil: • • • Desconectar do controle de origem para trabalhar off-line. ou ramificação. Idealmente. Visual Studio) e um servidor de banco de dados do controle de origem. Um projeto sempre está contido em um banco de dados. uma segunda ligação será criada quando você adicionar um segundo projeto à solução. Uma ligação é criada para o projeto inicial e para a solução. Conectar-se ao banco de dados após a reconexão com a rede. ao criar um par de solução de multiprojeto. Outros termos Visual Studio 233 . Você também pode fazer isso. selecionando a opção Create Directory for Solution na caixa de diálogo New Project. Ligações adicionais são criadas para cada projeto adicional. A tabela a seguir define alguns dos termos comuns. uma solução e seu projeto compartilham uma ligação de controle de origem única. as duas versões sob controle de origem terão um histórico compartilhado até um determinado ponto e históricos divergentes após esse ponto. Você pode criar uma solução de multiprojeto com uma ligação única. histórico. Conexão Uma ligação de dados ativa entre um cliente do controle de origem (por exemplo. Vários projetos podem ser armazenados em um banco de dados. Mesclar pode afetar diferentes versões do mesmo arquivo ou alterações feitas a uma mesma versão do arquivo. Mesclar Processo de combinar diferenças entre duas ou mais versões modificadas de um arquivo em uma nova versão de arquivo. Raiz solução Uma pasta vazia em um banco de dados que contém todos os itens de uma solução controlada por origem. no controle de origem. Raiz Super-unificada Um contêiner virtual abaixo do qual todos os projetos e os arquivos em uma solução controlada por origem estão localizados. chamada de uma cópia de trabalho. às vezes. C:\Solucao\Proj1 e C:\Solucao\Proj2. é a raiz super-unificada de uma solução controlada por origem contendo projetos localizados em [SUR]:\C:\Solucao\Proj1 e [SUR]:\D:\Proj2. Raiz unificada Um caminho para a pasta pai de todas as pastas de trabalho e arquivos em uma solução ou projeto controlado por origem. Por exemplo. Outros termos para um arquivo compartilhado são cópia e atalho. Arquivo compartilhado Um arquivo com versões que residem em mais de uma localidade de controle de origem. inicialmente. Por padrão. C:\Solucao é a raiz unificada de uma solução controlada por origem contendo arquivos localizados em C:\Solucao. Visual Studio 234 . Cópia local Arquivo em uma pasta de trabalho do usuário para a qual são copiadas alterações antes que seja feito um check-in. Com o controle de versão. Por exemplo [SUR]: \.normalmente usados para um banco de dados são repositório e armazenamento. Pasta de trabalho Local no qual as cópias locais de itens controlados por origem são armazenados. Cópia mestra A versão mais recente do check-in de um arquivo controlado por fonte. geralmente no seu próprio computador.root. Histórico Registro de alterações de um arquivo desde que ele tenha sido adicionado. Rótulo Nome definido pelo usuário anexado a uma versão específica de um item controlado por fonte. em oposição à cópia local de um arquivo em sua pasta de trabalho. Outro termo para uma pasta de trabalho é espaço de trabalho. Outros termos para cópia mestra são versão do servidor e versão do banco de dados. essa pasta é < nomedasolucao >. Uma cópia local é. você pode retornar a qualquer ponto no histórico do arquivo e recuperar o arquivo como ele existia até esse momento. e marca projetos totalmente baixados para acesso assim que eles estiverem disponíveis. consulte "Novidades para controle de origem" Alternância de plug-in Controle de origem agora permite alternar entre todos os tipos de plug-ins de controle de origem em Options no menu Tools. Melhorias no acesso ao projeto via aberturas assíncronas Controle de origem do Visual Studio foi aprimorado para abrir soluções de forma assíncrona e refletir o progresso de uma operação de abertura modificando os ícones no Solution Explorer. Melhorias na caixa de diálogo do Visual Studio para dar suporte a controle de origem Os seguintes aperfeiçoamentos de acesso a arquivo foram feitos nas caixas de diálogo do Visual Studio: • Agora você pode adicionar projetos ao controle de origem e abri-los facilmente usando a nova guia Source Control Stores na caixa de diálogo Open Project. C#. Entretanto. renomeações e movimentações Para oferecer suporte a propagação de alteração de namespace. a versão atual inclui um número de aperfeiçoamentos de integração. Quando você fizer uma alteração você será solicitado a propagar a alteração. Você pode adicionar automaticamente soluções e projetos ao controle de origem marcando a caixa de seleção Add to Source Control na caixa de diálogo New Project. O recurso de abertura assíncrona marca projetos que ainda estão sendo baixados com uma ampulheta. Observação Este recurso está apenas disponível para Visual Basic. • • Sincronização de exclusões. Em versões anteriores. Esta alternância permite a substituição completa da interface do usuário e permite um plug-in por solução. Melhorias nas operações básicas de controle de origem Visual Studio 235 . Isso significa que você pode abrir e começar a trabalhar em um projeto mesmo que o Visual Studio esteja ainda abrindo os outros projetos na solução. e movimentações com o banco de dados. Você pode adicionar um arquivo existente do controle de origem a um projeto usando a caixa de diálogo Add Existing Item. se você excluía.O que há de novo no controle de origem para o Visual Studio O Visual Studio tem dado suporte a controle de origem e integração de plug-ins de controle de origem há algum tempo. ele permanecia na sua pasta de trabalho mesmo após a sincronização. renomeações. renomeava ou movia um item no servidor. Para informações sobre novos recursos da parte de controle de origem do SDK do ambiente Visual Studio. J# e projetos da Web e não possui suporte de todos os plug-ins de controle de origem. enquanto outros usuários poderão sincronizar através de operações de recuperação. a versão mais recente de controle de origem sincroniza exclusões. como baixar em qualquer local. clique em Source Control. 7. você pode adicionar um novo projeto a ela. No Visual Studio. COMO: Adicionar um projeto ao controle de origem O controle de origem do Visual Studio permite adicionar um projeto e seu arquivo de solução ao controle de origem ao mesmo tempo. Operações básicas de controle de origem como check in. crie um novo projeto. Selecione a solução que contém o novo projeto. Para tarefas de plug-in-específico. Se você tiver dúvidas sobre como fazer isso.Os seguintes aperfeiçoamentos foram feitos nas operações básicas de controle de origem do Visual Studio: • Você pode agora fazer um check-out de um arquivo de uma pasta de trabalho local sem precisar baixar pela rede a versão mais recente do arquivo no banco de dados. Em versões anteriores do Visual Studio. Você tem uma opção para configurar o Visual Studio para automaticamente obter do controle de origem a última versão de todos os itens da solução quando você abrir uma solução . Se uma solução já estiver sob controle de origem. Para adicionar um projeto e solução ao controle de origem 5. check out e exibição de histórico são amplamente específicas de plug-in. Execução de Tarefas de Controle de Origem Esta seção descreve tarefas gerais de controle de origem que você pode executar no Visual Studio para qualquer plug-in. Observação Muitos desses procedimentos referem-se à seleção de comandos básicos de controle de origem do menu File do Visual Studio. Clique em Add Solution to Source Control e selecione a base de dados de projeto à qual quer adicionar a solução usando os procedimentos do plug-in de controle de origem sendo utilizado. Visual Studio 236 . Agora checkouts são automáticos e número de solicitações é reduzido. 8. entretanto. Alternativamente. • • • Suporte ao Visual Web Developer O Visual Web Developer pode agora acessar recursos de controle de origem de projeto na Web. embora essas operações possam fazer uso de alguns dos elementos de interface de usuário padrão suportados pelo pacote de controle de origem do Visual Studio. procure a Ajuda do Visual Studio. você pode acessar muitos dos comandos clicando com o botão direito do mouse em um item controlado por fonte no Solution Explorer. No menu File. Você pode configurar o Visual Studio para fazer silenciosamente check-out de arquivos em edição e fazer automaticamente check-in das suas alterações quando você fechar a solução. Fazendo check-in de uma solução automaticamente coloca qualquer novos projetos que esta contém sob controle de origem. o local estava embutido em código para baixar em c:\inetpub\wwwroot. você deve consultar a documentação do plug-in de controle de origem específico. 6. pois o controle de origem precisa incluir os novos detalhes do projeto nesse arquivo. Você desejar iniciar uma nova ramificação sem nenhum histórico de controle de origem em uma pasta de banco de dados diferente. Para mais informações. Se você tiver dúvidas sobre como fazer isso. 8. Você desejar utilizar um outro plug-in de controle de origem . e desativando todos os comandos de controle de origem. 12. No Visual Studio. abra o Solution Explorer e selecione uma solução ou projeto a ser ligado. Para obter mais informações de como excluir um item. você deve adicionar os projetos à pasta da solução no banco de dados. e continuar trabalhando normalmente. clique em Source Control. clique em Add Selected Projects to Source Control 11. No menu File. No menu File. COMO: acoplar ou desacoplar uma solução ou projeto Você deve ligar uma solução ou projeto ao controle de origem de maneira que este item tenha acesso aos comandos básicos de controle de origem. consulte COMO: conectar ou desconectar uma solução ou projeto. Uma ligação associa a cópia local do item à cópia mestre no banco de dados. Talvez você precise desacoplar um item se: • Você precisar religá-lo à versão de backup do banco de dados quando o servidor primário for desligado.Para adicionar os projetos selecionados ao controle de origem 7. Check In. e Get. Crie novos projetos conforme necessário na solução. usando o procedimento de check-in específico para o plug-in de controle de origem em uso. depois em Change Source Control. 9. 10. Selecione o banco de dados e local ao qual ligar. desassociando a cópia local da cópia mestre no banco de dados. consulte COMO: excluir um item controlado por origem. clique em Source Control. Para ligar uma solução ou projeto ao controle de origem 5. clique em Bind. religar a sua cópia da solução à cópia mestre do servidor no banco de dados de backup. há vários procedimentos na Ajuda do Visual Studio. e em seguida. 6. No Visual Studio. Você será solicitado a decidir se deseja adicionar os projetos como subpastas da solução ou como pastas separadas. tais como Check Out. Use o procedimento de check-out específicos para o plug-in de controle de origem em uso. Você pode conectar a um servidor de backup. 7. Desacoplar uma solução ou projeto controlado por origem remove o item do controle de origem. Faça o check-in da solução de volta no controle de origem. Visual Studio 237 . e clique em OK. Na caixa de diálogo Change Source Control. 8. abra uma solução existente no Solution Explorer. Na maioria das situações. • • Desacoplar um item não o remove permanentemente do banco de dados. Faça o check-out do arquivo de solução. Para alterar o local da pasta de trabalho 5. 8.Para desacoplar uma solução ou projeto do controle de origem 5. abra a janela Solution Explorer e selecione os itens a serem conectados. torna-se editável. 7. e clique em OK. Se você desconectar seu computador da rede ou perder a conexão por alguma outra razão. No meu File . 6. clique em Connect. Clique no botão de reticências (…) Digite um caminho válido. No Visual Studio. Se a pasta ainda não existir. Quando você desconecta uma solução do controle de código fonte. uma solução no Visual Studio pode ter um ou mais vínculos com o controle de código fonte. você pode reconectar a solução e sincronizar sua cópia local com a cópia mestre mais recente. Uma conexão é criada automaticamente sempre que um item é vinculado ao controle de código fonte conforme descrito em Como vincular ou desvincular uma solução ou um projeto. 6. abra o Solution Explorer. Ao realizar o check-out de um item desconectado. o único comando básico que você pode usar é o comando de check-out. 6. No menu File. COMO: alterar o local da pasta de trabalho Às vezes o Solution Explorer indica locais de pasta por um sublinhado ondulado. Visual Studio 238 . No Visual Studio. contida na sua pasta de trabalho. clique em Source Control. Como conectar ou desconectar uma solução ou um projeto Conforme descrito em Introdução ao Controle de Código Fonte. 7. Quando for possível acessar o banco de dados novamente. o Visual Studio criará uma. Clique em OK. http://<host local>/pasta1. clique em Unbind. Para corrigir caminhos inválidos. você deve alterar o local da pasta de trabalho. Essas entradas representam caminhos inválidos relativos à pasta de trabalho. Pode-se criar uma conexão manualmente conforme descrito neste tópico. a cópia local do item. 7. depois em Change Source Control. Na caixa de diálogo Change Source Control. No Visual Studio. Na caixa de diálogo Change Source Control. Procedimentos Para conectar uma solução ou um projeto ao controle de código fonte 5. clique em Source Control e depois em Change Source Control. você deve desconectar temporariamente os vínculos da solução a fim de editar os projetos e os arquivos nela contidos. abra o Solution Explorer e selecione uma solução ou projeto a ser desacoplado. por exemplo. Clique em um caminho inválido na coluna Enter Working Copy Location Here. 8. 10. 9. No Visual Studio. abra o Solution Explorer. abra o Solution Explorer. 7. junto com o histórico e outros metadados do item. Clique duas vezes no banco de dados que contém o arquivo que você deseja copiar. Este projeto deve estar no mesmo banco de dados que o projeto de origem. clique no nome de seu plug-in de controle de origem. Na caixa de diálogo Change Source Control. 12. No menu File. e clique em Add. 11. clique em Add e depois em Existing Project. Observação Se você copiar um projeto sob controle de origem para uma solução que não está sob controle de origem. 14. 10. 13. 8. Para copiar um arquivo sob controle de origem 8. uma nova ramificação é criada no banco de dados. Para desconectar uma solução ou projeto de controle de código fonte COMO: copiar um item sob controle de origem Você pode copiar um projeto de uma solução sob controle de origem para outra. Criar ramificações permite que sua equipe desenvolva duas versões de um produto simultaneamente e independentemente. Clique em OK. Na caixa de diálogo Add Existing Project. Clique duas vezes no banco de dados contendo o projeto que você deseja copiar. No Visual Studio. Na caixa de diálogo Add Existing Item. abra a janela Solution Explorer e selecione os itens a serem desconectados. Clique com o botão direito do mouse no projeto de destino no Solution Explorer. clique em Source Control e depois em Change Source Control. 12. clique em Add e depois em Existing Item. clique em Disconnect. Clique em OK. 6. Clique com o botão direito do mouse na solução de destino no Solution Explorer. 9. Selecione o projeto. Quando você copia um item. No menu File. clique no nome de seu plug-in de controle de origem. Clique em OK. 11. No menu File.8. ou copiar um arquivo de um projeto sob controle de origem para outro. Visual Studio 239 . não poderão ser criadas ramificações no projeto. No Visual Studio. 5. Para copiar um projeto sob controle de origem 8. 14. 9. 8. clique em Delete the item(s) locally and in the source control store. consulte a documentação do produto de terceiros para seu plug-in. Eles receberão uma mensagem notificando-os da exclusão. você terá de informar aos outros usuários para removerem manualmente suas cópias locais do item excluído. No Visual Studio. Isso garante que a cópia local permanecerá sincronizada com a cópia mestra. Você será solicitado para fazer o check-out no item. e clique em Add. Como ativar recuperação automática Você pode configurar o Visual Studio para recuperar automaticamente a versão mais recente de um item sob controle de versão sempre que você abri-lo. Se houver suporte para a propagação de modificação de espaço para nome. Clique com o botão direito do mouse no item que deseja excluir. Se não houver suporte à propagação de modificação de espaço para nome. ele o consultará para obter instruções sobre exclusão. 10. Para excluir um item controlado por origem 3. permita que os outros usuários façam a atualização de suas cópias locais. o Visual Studio exclui automaticamente a cópia local. Para mais informações sobre propagação de modificação de espaço para nome. A maioria dos plug-ins para controle de origem para o Visual Studio não exclui permanentemente itens de um banco de dados. 11. como projetos C++. Se tiver clicado em Remove. Selecione o arquivo. Em Solution Explorer. 4. Caso contrário. anteriormente. COMO: excluir um item controlado por origem Quando você exclui um item controlado por origem. abra Solution Explorer. 12. depois clique Delete ou Remove. se o plug-in de controle de origem apoiar a propagação de modificação de espaço para nome. Visual Studio 240 . Para obter mais informações sobre como excluir permanentemente um item de controle de origem. Na caixa de diálogo Source Control. Clique em OK. consulte Introdução ao controle de origem. faça o check-in do item como apoiado pelo seu plug-in de controle de origem. Notifique a exclusão a qualquer pessoa que possa ter feito o check-out do projeto ao qual o item excluído pertence. Observação O comando Remove só estará disponível para projetos a base de referência. 14.13. Faça o check-out como apoiado pelo seu plug-in de controle de origem. clique em Delete na caixa de diálogo que aparece. 13. Por exemplo. Para ativar checkins automáticos 5. Clique em OK para aceitar a alteração do registro. clique em Start e. clique em Options. troque 0 por 1. Como desativar a criação da pasta <solutionname>. consulte Introdução ao controle de código fonte.root irá alterar o comportamento do plug-in sempre que uma solução com vários projeto for adicionada ao controle de código fonte. Na caixa de dados Value. você terá que responder a solicitações redundantes ao executar operações de controle de código fonte em vários projetos. 11. Selecione a chave DoNotCreateSolutionRootFolderInSourceControl e clique em Edit e depois em Modify. Abra \SourceControl HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\ < número de versão >. operações que adicionam projetos levarão mais tempo para concluir. No Visual Studio. 12. em seguida. Essa pasta irá conter a raiz unificada da solução. Para mais informações sobre a raiz unificada. Automatizar o processo de check-in garante que seus trabalhos mais recentes se tornem periodicamente disponíveis para outros membros da equipe.Procedimentos Para obter a versão mais recente automaticamente 5. no menu Tools. Marque a caixa de seleção Get everything when a solution or project is opened. 8. Cuidado Desativar a criação automática da pasta < solutionname >. Na área de trabalho do Windows. clique em Source Control e em seguida clique em Environment. Para desativar a criação automática da pasta < solutionname >. clique em Run Digite Regedit e clique em OK.root Quando você adiciona uma solução ao controle de código fonte. clique em Options. mesmo se você esquecer fazer check-in manualmente. 10. Além disso. Visual Studio 241 . No Visual Studio. 9.root vazia no banco de dados. COMO: Ativar Check-ins automáticos Você pode configurar o Visual Studio para que efetue automaticamente check-in nas suas alterações no controle de origem quando você fechar uma solução. o respectivo plug-in cria automaticamente uma pasta < solutionname >. Clique em OK.root 7. no menu Tools. 7. Na caixa de diálogo Options. 6. 8. clique em Options. clique em Source Control. Ela lista todos os plug-ins disponíveis na aba Plug-in Selection da entrada Source Control na caixa de diálogo Options. desmarque a caixa de seleção Check out automatically. fazer check-outs de itens de ambos os programas para a mesma pasta de trabalho não é recomendável. Se você não tiver nenhum plug-in de controle de origem compatível instalado em seu computador. 7. 8. Na caixa de diálogo Options. Procedimentos Para desativar check-outs automáticos 5. No Visual Studio. 7. Para ativar um determinado plug-in de controle de origem 5. Visual Studio 242 . o controle de origem no Visual Studio não está ativado. 7. Na caixa de diálogo Options. Clique em OK. clique em Environment. Marque a caixa de seleção Check in everything when closing a solution or project. COMO: ativar ou desativar controle de origem O controle de origem no Visual Studio estará disponível somente se um plug-in válido de controle de origem estiver instalado e registrado para ser usado em seu computador. No Visual Studio. O Visual Studio usa esse registro para localizar os plug-ins e as localidade de seus bancos de dados padrão sempre que você abrir a IDE do Visual Studio. no menu Tools. Na caixa Editing. clique em Options. Esta seção descreve como você pode configurar o Visual Studio para desativar check-outs automáticos. Clique em OK. O plug-in é registrado durante a instalação do software de terceiros. no menu Tools. Selecione o plug-in de controle de origem que deseja usar. Na caixa de diálogo Options . Você não verá nenhuma entrada Source Control no menu File.6. 6. e depois clique em Environment. clique em Plug-in Selection. COMO: desativar check-outs automáticos O controle de origem no Visual Studio permite check-outs automáticos por padrão. clique em Source Control. 6. Entretanto. Cuidado Você pode usar um plug-in de controle de origem no Visual Studio e o aplicativo autônomo de controle de origem correspondente para gerenciar o mesmo projeto ou solução. clique em Source Control. Isso pode levar a situações em que soluções e projetos não podem ser acessados no controle de origem. 8. Se a solução e o projeto compartilham uma ligação de controle de origem. abra o Solution Explorer e selecione um projeto que contém arquivos que estejam fora da pasta da solução ou raiz do projeto. COMO: mover uma raiz de ligação de projeto Você talvez necessite mover a raiz de ligação de um projeto se alguns arquivos que você deseja adicionar ao projeto estiverem localizados fora da raiz do projeto. clicar em Source Control e então desmarcar Exclude from Source Control. Selecione None na caixa Current source control plug-in.8. Na caixa de mensagem. 7. No Visual Studio. no menu Tools. clique em Unbind. de acordo com o conteúdo de outro arquivo do Visual Studio. 5. Para excluir um arquivo do controle de origem 4. clique em Source Control. Quando você estiver pronto para colocar o arquivo sob controle de origem. clique em Source Control. No menu File. clique em Unbind para confirmar que você deseja remover o projeto do controle de origem. COMO: excluir um arquivo de controle de origem Se a solução em você estiver trabalhando contém arquivos que não requerem controle de origem. Para desativar completamente o controle de origem 5. abra Solution Explorer e selecione o arquivo a ser excluído. Um arquivo gerado é um que pode ser recriado inteiramente pelo Visual Studio. você pode utilizar o comando Exclude from Source Control para marcar adequadamente o arquivo. 6. desacople a solução também. 13. Na caixa de diálogo Change Source Control. mas não é mais realizado check-in ou check-out do mesmo a partir do projeto que o contém. 11. 6. depois em Change Source Control. 8. você pode acessar o menu File. Visual Studio 243 . clique em Exclude from Source Control. 14. 12. Observação Arquivos gerados são excluídos do controle de origem por padrão. Na caixa de diálogo Options. No Visual Studio. clique em Source Control. Clique em OK. Clique em OK. Para mover uma raiz de ligação de projeto 10. Quando você fizer isso. clique em Options. No menu File. No Visual Studio. o arquivo permanecerá no banco de dados. clique em Plug-in Selection. você move todo o histórico e metadados de controle de origem associados se o plug-in de controle de origem apoiar a propagação de modificação de espaço para nome. consulte COMO: acoplar ou desacoplar uma solução ou projetos. Para uma mudança de local ser ativada. Quando você move um item. 18. consulte Introdução ao controle de origem. Na maioria dos casos. Tanto a origem quanto os itens de destino envolvidos em uma operação de mudança de local devem ser localizados no mesmo banco de dados de controle de origem. Cuidado Se você repetir um dos procedimentos neste tópico. Visual Studio 244 . 16. COMO: mover um item controlado por fonte No Visual Studio. abra o Solution Explorer. COMO: abrir um projeto ou solução do controle de origem Quando você abre um projeto ou solução do controle de origem. você deve religá-la a uma pasta de banco de dados. a pasta <nomesolução>. Depois que você recuperar uma cópia local do item. uma solução e seus projetos devem compartilhar uma vinculação de controle de origem. o Visual Studio baixa a cópia mestra mais recente do item e de todos os arquivos contidos para a pasta de trabalho local. Se você teve que desacoplar a solução juntamente com o projeto. acesse novamente a caixa de diálogo Change Source Control e clique em Bind. 4. No Visual Studio. Selecione a pasta pai na qual todos os arquivos no projeto estão armazenados. você não precisá abri-lo a partir do controle de origem novamente.root é esta pasta. você criará várias pastas de trabalho e várias instâncias dos arquivos que elas contêm. 17. ou entre duas soluções.15. Para mover um item controlado por origem 3. Para mais informações. você pode mover um item controlado por origem de uma pasta de projeto ou solução para outro. Para mais informações sobre propagação de modificação de espaço para nome. Você pode continuar a usar os comandos de controle de origem para o seu plug-in específico de controle de origem. Com o projeto selecionado. Clique no item que você deseja mover e arraste-o para a solução ou projeto de destino no Solution Explorer. faça logon no seu banco de dados de controle de origem. Se solicitado. Observação A operação de mudança só pode ocorrer entre dois projetos na mesma solução. 7. e depois clique em Open. altere a pasta de destino. Na caixa de diálogo Open Project . 9. clique em Rename or move the item(s) locally and in the source control store. ele consultará você para obter instruções de renomeação. No lado esquerdo da caixa. 12. clique em My <source control plugin> Stores. clique Rename. 8. Você será solicitado para fazer check-out do item. clique em Open. Caso contrário. Clique em Project/Solution. 9. você será solicitado a substituir a cópia local de todos os arquivos e projetos na solução.sln). Responda às perguntas conforme necessário. e depois clique em Open. consulte Introdução ao controle de origem. 15. Procure e selecione o seu arquivo de projeto (*. Clique em Web Site. Clique com o botão direito do mouse no arquivo a ser renomeado. Procure e selecione o projeto da Web. e depois clique em Open. no menu File. depois clique em Open. No Visual Studio. Para abrir um projeto da Web do controle de origem 6. Para renomear um item de origem controlada 10. selecione Close Solution if not already selected. abra o Solution Explorer. No Visual Studio. Se você já tiver uma cópia local do projeto da Web que você está abrindo do controle de origem. Efetue o check-out conforme o suporte de seu plug-in de controle de origem. você será solicitado a substituir a cópia local de todos os arquivos e projetos na solução. COMO: Renomear um item controlado por origem Quando você renomeia um item controlado por origem. 12. altere a pasta de destino. 10. o Visual Studio renomeia a cópia local automaticamente se o plug-in de controle de origem suporta propagação da alteração de namespace. Na caixa de diálogo Source Control. Visual Studio 245 . clique em Open. efetue o check-in do item conforme o suporte de seu plug-in de controle de origem. No Visual Studio. 14. no menu File. clique em My <source control plug-in> Stores. Se você já tiver uma cópia local da solução ou do projeto que você está abrindo do controle de origem. 10. Digite um novo nome e pressione Enter. 13. 11. 11. 8. Na caixa de diálogo Open Web Site.proj) ou de solução (*. Para mais informações sobre propagação de alterações de namespaces.Para abrir um projeto ou solução do controle de origem 7. Responda às perguntas conforme necessário. No Solution Explorer. Eles receberão uma mensagem notificando-os sobre a operação de renomeação.16. Se não houver suporte para a propagação da alteração do namespace. assegure-se que seu plug-in é o indicado. Quando concluir todas as configurações do plug-in. Personalize o perfil. Para definir opções de plug-in 10. Notifique qualquer pessoa que possa ter efetuado check-out do item que você renomeou. faça com que os outros usuários efetuem um get para atualizar suas cópias locais. COMO: definir opções de plug-in Dependendo da como você gerenciar seus itens em controle de origem. você pode definir configurações para cada função do plug-in. você pode desejar alterar algumas das opções padrão de controle de origem antes de usar o banco de dados. Na caixa de diálogo Options. é necessário informar aos outros usuários para que renomeiem suas cópias locais manualmente para refletir a alteração do nome. 16. 18. Clique em OK. O Visual Studio seleciona automaticamente as opções de controle de origem padrão para a função que você tiver selecionado. No Visual Studio. 15. em Source Control. Nessa aba. 12. 17. clique em Plug-in Selection. no menu Tools. Selecione Environment na caixa de diálogo Options. marcando ou desmarcando as caixas de seleção do controle de origem. Se você desmarcar qualquer uma das opções padrão. selecione a função para a qual você deseja definir as opções de controle de origem. clique em OK para sair da caixa de diálogo Options. 11. Observação Consulte a documentação do plug-in de controle de origem em uso para uma lista completa das opções no nível do banco de dados e das mais avançadas. e clique em OK. além de instruções sobre como configurá-las. a caixa Source Control Environment Settings exibe a Opção Custom para indicar que você personalizou o perfil originalmente selecionado. Essas opções estão disponíveis através da Configuração Options no menu Tools do Visual Studio. 14. 17. 18. 13. em seguida. Se houver suporte para propagação da alteração de namespace. Na caixa Source Control Environment Settings. clique em Options e. Clicando no botão Advanced tem-se acesso às configurações avançadas para a função que você está configurando. Agora clique em Plug-in Settings na caixa de diálogo Options. Visual Studio 246 . Para mudar o plug-in padrão de controle de origem 4. Encaixe a janela conforme desejado. no menu View. Selecione um plug-in e clique OK. 5. Para exibir uma lista de arquivos modificados 4. Lembre-se que projetos controlados por um plug-in de controle de origem não podem ser adicionados a uma solução gerenciada por um plug-in diferente. você pode trocá-los a qualquer momento. O controle de origem do Visual Studio permite que você faça um check-in de arquivos desta janela com um único clique de botão. a menos que você remova. 5. o item do controle de origem. Visual Studio 247 . As caixas de diálogo a seguir são modelos que o desenvolvedor de plug-in pode adaptar conforme necessário. COMO: exibir uma lista de arquivos com check-out Você pode usar a janela Pending Checkins para exibir uma lista dos arquivos com check-out na solução atual. Se você desejar fazer check-in de arquivos desta janela. depois em Plug-in Selection.Como: Trocar plug-ins de controle de origem: Se você tiver instalado mais de um plug-in para controle de origem para o Visual Studio. no menu Tools. 6. selecione-os e clique no botão Check In. No Visual Studio. Uma vez que você acrescenta uma solução ou projeto ao controle de origem que usa um plug-in. primeiro. Na caixa de diálogo Options clique em Source Control. clique em Pending Checkins. 6. Você pode ou não ver essas caixas de diálogo no Visual Studio. Referência a Interface do Usuário do controle de origem Esta seção descreve as caixas de diálogo usadas pelo controle de origem no Visual Studio. clique em Options. No Visual Studio. você não pode acrescentar o mesmo item ao controle de origem que usa outro plug-in. dependendo do plug-in que está sendo usado para controle de origem: • • • • Verifique em Verificar saída para editar Obter Desfazer Checkout Caixa de diálogo Change Source Control Cria e gerencia as conexões e ligações que vinculam uma solução ou projeto localmente salvos a uma pasta no banco de dados. Vincular Associa os itens selecionados a uma localidade do servidor de controle de origem especificado. OK Aceita alterações feitas na caixa de diálogo. Desconectar Desconecta a cópia local de uma solução ou projeto no seu computador da cópia mestre no banco de dados. você pode usar este botão para criar um vinculo à pasta mais recentemente utilizada do servidor de controle de origem e banco de dados. Colunas Identifica colunas para exibição e a ordem na qual elas são exibidas. Acesso à caixa de diálogo No Visual Studio. selecione um item no Solution Explorer.Observação Não é possível usar o Visual Studio para vincular. Observação Esta caixa de diálogo também está disponível clicando com o botão direito do mouse sobre o item no Solution Explorer. clique em Source Control e depois em Change Source Control. ao trabalhar off-line em seu laptop. Conectado Exibe o status da conexão de uma solução ou projeto selecionado. desvincular. Se uma pasta recente do servidor ou do banco de dados não puder ser encontrada. você será solicitado a especificar outra. Utilize esse comando antes de desconectar seu computador do servidor de controle de origem. Procurar Permite que você procure uma nova localidade para o item especificado no servidor de controle de origem. conectar ou desconectar um aplicativo da Web criado utilizando as FrontPage Server Extensions. Provedor Exibe o nome do plug-in de controle de origem. Servidor Binding Visual Studio 248 . Por exemplo. por exemplo. Conectar Cria uma conexão entre itens selecionados e o servidor de controle de origem. Atualizar Atualiza as informações de conexão para todos os projetos listados nesta caixa diálogo. No menu File. Status Identifica o status de vinculação e conexão de um item. Use o comando Add to Source Control ao invés do comando Bind para este item. No menu File. clique em Source Control depois em Check In. Caixa de diálogo Check In (Controle de Código Fonte) Verifica um arquivo. Especifica que o item está incorretamente vinculado ou desconectado da pasta à qual ele pertence. Especifica que o item não se encontra sob controle de origem. Observação Se você desvincular um projeto da Web. Nome do servidor Exibe o nome do servidor de controle de origem ao qual a solução ou projeto correspondente está acoplada. As possíveis opções são: Opção Válido Descrição Especifica que o item está corretamente vinculado e conectado a pasta do servidor ao qual ele pertence. Solution/Project Exibe o nome de cada projeto e solução na seleção atual. será impossível revinculá-lo a seu servidor de controle de origem original até que você altere a localidade de sua cópia de trabalho.Indica a ligação de um item a um servidor de controle de origem. Acesso à caixa de diálogo No Visual Studio. solução ou projeto alterado no banco de dados do controle de código fonte. Visual Studio 249 . Classificação Altera a ordem de classificação de colunas exibidas. Não controlado Desagrupar Exibe a caixa de diálogo Source Control que permite que você remova os itens selecionados do controle de origem e permanentemente disassocie-os das suas pastas. selecione um item na janela Solution Explorer. Inválido Desconhecido Especifica que status do item sob controle de origem ainda não foi determinado. Check-ins também podem ser feitos a partir da janela Pending Checkins. Flat View Exibe os arquivos onde está sendo feito o check-in como listas simples sob sua conexão com controle de código fonte. Fazer check-out de um item pode copiar a cópia mestre atual para o seu computador local e remover o seu atributo de somente leitura. A menos que o pacote de controle de origem esteja configurado para dar suporte a checkouts compartilhados. projetos ou itens individuais do controle de origem. clique em Source Control. Options Exibe opções de check-in específicas de plug-ins de controle de código fonte quando a seta à direita do botão é selecionada. Name Exibe os nomes dos itens onde deve-se fazer o check-in. Columns Identifica as colunas a serem exibidas e a ordem na qual elas são exibidas. Don't show Check in dialog box when checking in items Impede que a caixa de diálogo seja exibidas durante operações de check-in. Caixa de diálogo Access No Visual Studio. selecione um item no Solution Explorer. Visual Studio 250 . Check In Realiza o check-in de todos os itens selecionados. fazer check-out de um item também bloqueia o item de maneira que ele estará em somente leitura para outros usuários. Check-out para a caixa de diálogo Edit (controle de origem) Faz check-out de soluções.Observação Esta caixa de diálogo também é disponibilizada clicando-se com o botão direito no item na janela Solution Explorer. Se você não desejar fazer check-in de um item específico. Sort Altera a ordem de classificação das colunas de exibição. Opcionalmente você pode configurar o comando Check Out For Edit para fazer check-out somente da versão local. desmarque sua caixa de seleção. depois clique em Check Out For Edit. Os itens aparecem com as caixas de seleção ao lado selecionadas. Comments Especifica um comentário a ser associado com a operação de check-in. Tree View Exibe a pasta e a hierarquia dos itens nos quais você estiver realizando o check-in. No menu File. Observação Esta caixa de diálogo também está disponível clicando com o botão direito do mouse no item no Solution Explorer. ou outra pasta que você especificar. Colunas Identifica as colunas para exibição e a ordem na qual elas são exibidas. Opções Exibe opções de check-out específicas do plug-in de controle de origem quando a seta à direita do botão é clicada. Não caixa diálogo Show Check Out quando check-out itens Impede que a caixa de diálogo seja exibida durante operações de check-out. Exibir simples Exibe os itens do check-out em progresso como listas simples sob sua conexão de controle de origem. O botão Edit aparece somente se você tiver o Visual Studio configurado para dar suporte à edição de arquivos com check-in. desmarque sua caixa de seleção. Exibir árvore Exibe a hierarquia de pastas e arquivos para o item do check-out em progresso. Acesso à caixa de diálogo No Visual Studio. Nome Exibe os nomes dos itens disponíveis para check-out. Se você não desejar fazer check-out de um item específico. Os itens que estão selecionados aparecem com caixas de seleção ao seu lado. No menu File. depois em Get. clique em Source Control. Verificar saída Faz check-out de todos os itens selecionados. Comentários Especifica um comentário para associar à operação de check-out. Classificação Altera a ordem de classificação das colunas exibidas. Caixa de diálogo Get (controle de origem) Recupera uma cópia somente para leitura do item selecionado do banco de dados para sua pasta de trabalho. Visual Studio 251 . selecione um item no Solution Explorer. Editar Permite que você modifique um item sem fazer seu check-out. desmarque a caixa de seleção correspondente. Comments Especifica um comentário a ser associado com a operação de check-in. Você pode usar esta janela para fazer check-in de todos os arquivos com um único clique de botão. Os itens aparecem com as caixas de seleção ao lado dos mesmos selecionadas. Opções Exibe opções de recuperação específicas do plug-in do Source Safe quando a seta à direita do botão é clicada. Janela de check-ins pendentes Exibe todos os arquivos com check-out na solução ou projeto atual.Observação Esta caixa de diálogo também está disponível clicando-se com o botão direito do mouse sobre o item no Solution Explorer. Check In Efetua check-in dos itens selecionados. no menu View. Nome Exibe os nomes dos itens a ser recuperados. Caixa de diálogo de acesso No Visual Studio. Columns Identifica as colunas para exibição e a ordem na qual elas serão exibidas. clique em Pending Checkins. Ação Especifica a ação a ser executada nos itens a ser recuperados. Visual Studio 252 . Hora modificado Exibe o momento em que um item foi modificado pela última vez. Colunas Identifica colunas para exibição e a ordem na qual elas são exibidas. Exibir árvore Exibe a hierarquia de pastas e arquivos para os itens sendo recuperados. Exibir simples Exibe os arquivos sendo recuperados como listas simples sob suas conexões ao controle de origem. Se você não desejar recuperar um item específico. Change type Identifica o tipo de alteração que foi feita para o item selecionado. Classificação Altera a ordem de classificação das colunas exibidas. Name Exibe os nomes dos itens com check-in a ser efetuado. Por exemplo. Options Exibe opções de check-in específicas de plug-ins quando a seta à direita do botão é clicada. e Plug-in Settings. se o usuário for um desenvolvedor independente. Se você não desejar fazer o check-in de um item específico. Opções são definidas para Plug-in Selection. Para esta função. O plug-in selecionado é refletido na entrada Source Control no menu File do Visual Studio. Plug-in Settings Especifica opções para identificar o plug-in de controle de origem associado a um projeto ou solução. Observação Visual Studio 253 . Environment Especifica as configurações de ambiente para as funções padrões definidas pelo Visual Studio. Selection Plug-in Altera o plug-in atual de controle de origem associado ao IDE do Visual Studio. Guias de plug-in para controle de origem (caixa de diálogo Options) Permitem a personalização de funções de controle de origem e configurações de plug-in no Visual Studio. o qual perde qualquer alteração feita desde o check out. desmarque sua caixa de seleção. conflitos com outros usuários não são geralmente criados ao manter itens com check-out após um check-in. Lista de elementos de interface do usuário. As guias de plug-in fazem parte da caixa de diálogo Options do Visual Studio.Flat View Exibe os arquivos que você está efetuando check-in na forma de listas simples em sua conexão de controle de origem. e faz dele o plug-in padrão. Os itens aparecem com as caixas de seleção ao seus lados selecionadas. e depois em Source Control. Sort Altera a ordem de classificação das colunas exibidas. • Guia Access No Visual Studio. Environment. localizada sob a entrada Source Control: • • Plug-in Selection Alterna entre os plug-ins de controle de origem. Undo checkout Reverte o check-out de um item selecionado. Tree View Exibe a hierarquia das pasta e arquivos que você estiver efetuando check-in. clique em Options. o Visual Studio seleciona automaticamente a opção Keep items checked out when checking in. Clique em OK para registrar sua alteração e alternar a operação para o plug-in escolhido por você. no menu Tools. Se este item estiver selecionado. Edição Especifica a maneira com que itens devem ser manipulados na edição. Environment Permitir que itens a serem editadas checked-in Especifica que itens com check-in podem ser editados na memória. uma caixa de diálogo de check-in não será exibida. Obter tudo quando uma solução ou projeto for aberto Recupera a versão mais recente de todos os itens quando você abre uma solução ou projeto. Não mostrar esta caixa de diálogo novamente Especifica que o Visual Studio não deve mostrar as configurações de ambiente de controle de origem. Manter itens check-out ao verificar na Especifica que itens em processo de check-in devem permanecer com checkout para você. Especifica que o Visual Studio não deve fazer nada na edição. uma caixa de diálogo de check-out não é exibida. Não Mostrar caixa de diálogo check-in ao verificar em itens Especifica que o Visual Studio deve exibir o comando Check In Now no menu File. Check in tudo ao fechar uma solução ou projeto Especifica que você irá fazer check-in de todos os itens ao fechar uma solução ou projeto. um botão Edit aparecerá na caixa de diálogo Check Out For Edit quando você tentar editar um item com check-in. Itens Checked-in Contém configurações para salvar e editar itens com check-in. Não Mostrar caixa de diálogo check-out quando check-out itens Especifica que o Visual Studio deve exibir o comando Check Out Now no menu File.Você pode usar esta parte da caixa de diálogo Options para desativar o controle de origem clicando em None na lista de plug-ins Lista de elementos de interface do usuário. As opções possíveis são: Opção Prompt for checkout Prompt for exclusive checkouts Check out automatically Do nothing Descrição Especifica que o Visual Studio deve emitir um prompt para um check-out. Se você desejar alterar esta opção para um check-in Visual Studio 254 . Indica que o Visual Studio deve fazer check-out de itens automaticamente. Nesse caso. Especifica que o Visual Studio deve emitir um prompt para check-outs exclusivos. Nesse caso. Salvar Especifica a maneira com que itens devem ser manipulados quando você os salva. esse nome será colocado automaticamente na caixa de diálogo de logon usada pelo plug-in de controle de origem para acessar o servidor.específico. clique na seta de Options na caixa de diálogo Check In. Para ativar essa opção. Redefinir Redefine confirmações. Especifica que o Visual Studio deve fazer check-out automaticamente em uma operação de salvar. Check out automatically Save as Configurações de ambiente controle de origem Especifica o nome do plug-in de controle de origem para o qual você está definindo opções de ambiente. especialmente quando abrir uma Visual Studio 255 . As configurações avançadas são específicas para o plug-in. e desmarque a opção Keep Checked Out. O botão Advanced só está disponível quando um plug-in de controle de origem válido está instalado no computador local. Executar atualizações de status em segundo plano Atualiza automaticamente os ícones de controle de origem no Solution Explorer à medida que o status de item se altera. Observação A identificação de logon somente pode ser editada quando um plug-in válido de controle de origem estiver instalado na máquina local. As opções possíveis são: Opção Prompt for checkout Descrição Especifica que o Visual Studio deve emitir um prompt para check-out em uma operação de salvar. Especifica que o Visual Studio deve apresentar um prompt Save as em uma operação de salvar. Lista de elementos de interface do usuário. Se seu plug-in der suporte. e reinicie o Visual Studio. Plug-in Settings Avançadas Permite que você defina opções adicionais para usar o plug-in de controle de origem . desative logons de usuário automáticos do seu plug-in de controle de origem. Identificação de logon Especifica o nome de usuário para efetuar logon no plug-in de controle de origem. Se você tiver atrasos ao executar operações intensivas no servidor. solução ou projeto do controle de origem. You are about to rename or move the following Lista os itens que você selecionou para serem renomeados ou movidos. desmarcar esta opção pode melhorar o desempenho. Configurações plug-in Especifica o nome do plug-in de controle de origem para o qual você está fazendo configurações. O conteúdo da caixa de diálogo varia dependendo do comando. Os itens renomeados ou movidos não mais estarão sob controle de versão. Caixa de diálogo Source Control Permite que você remova itens do controle de código fonte e desfaça permanentemente a associação entre os itens e suas pastas. Outros membros da equipe não são afetados por essa opção até o próximo check-in. clique em Delete ou Rename. Lista de elementos da interface do usuário para exclusões Delete the item(s) locally and in the source control store Especifica que os itens devem ser excluídos localmente e no banco de dados. A versão mais recente da solução ou projeto não refletirá a renomeação ou a movimentação até o próximo check-in. em seguida. Lista de elementos da interface do usuário para renomeações ou movimentações Make my current choice the default action for all future renames or moves Especifica que sua escolha será a ação padrão das operações posteriores de renomear ou mover. Acesso à caixa de diálogo No Visual Studio. Você pode redefinir o padrão em Only rename or move item(s) locally Especifica que os itens devem ser renomeados localmente. Make my current choice the default action for all future deletes Especifica que a sua escolha será a ação padrão das operações posteriores de exclusão. renomear e mover. clique em um item com o botão direito do mouse. You are about to delete the following Visual Studio 256 . Only delete item(s) locally Especifica que os itens devem ser excluídos localmente. Você precisará excluir manualmente os itens no banco de dados após o check-in. Rename or move the item(s) locally and in the source control store Especifica que os itens devem ser renomeados localmente e no banco de dados. A versão mais recente da solução ou projeto não refletirá a operação de exclusão até o próximo check-in. Esta caixa de diálogo é usada para propagar as operações excluir. Flat View Exibe os itens como listas simples sob a sua conexão com o controle de código fonte. desmarque sua caixa de seleção. selecione um item na janela Solution Explorer.Lista os itens que você selecionou para exclusão. Caixa de diálogo Undo Checkout (Controle de Código Fonte) Reverte a opção de check-out do item selecionado na janela Solution Explorer. Options Exibe opções para desfazer o check-out específicas de plug-ins de controle de código fonte quando a seta à direita do botão é selecionada. Name Exibe os nomes dos itens para os quais será desfeito o check-out. Visual Studio 257 . Undo Checkout Reverte o check-out. Acesso à caixa de diálogo No Visual Studio. Os itens aparecem com as caixas de seleção ao seu lado selecionadas. Você perderá qualquer alteração feita desde o último check-out. Columns Identifica as colunas a serem exibidas e a ordem na qual elas são exibidas. Sort Altera a ordem de classificação das colunas de exibição. Observação Esta caixa de diálogo também é disponibilizada clicando-se com o botão direito no item na janela Solution Explorer. Se você não deseja desfazer o check-out de um item. clique em Source Control e em seguida clique em Undo Checkout. No menu File. Tree View Exibe a pasta e a hierarquia dos itens nos quais você está revertendo o check-out. Visual Studio 258 . Essas personalizações incluir mostrar ou ocultar determinada layouts janela. ou redefinir para facilitar o IDE para usar.vssettings você selecionou na primeira vez você iniciou Visual Studio e qualquer personalização IDE subseqüentes que você fez. predefinidas combinações de teclas de atalho. você não pode substituir a configuração predefinida sem aplicar uma coleção diferente. nomes de menu. sem remover personalizações para outras áreas individuais Quais são configurações? Configurações são personalizações ao IDE. você pode alterar as configurações aplicadas como parte de uma coleção predefinida Por exemplo. Cada vez que fizer uma alteração em uma configuração controlada pelo Visual Studio. Como configurações funcionam? Quando você inicia Visual Studio. ocultando páginas. Visual Studio 259 .vssettings arquivo. selecionando Show all settings. Em alguns casos. importar. consulte Como: Alterar configurações selecionadas. você pode: • • • Criar uma cópia das suas configurações ativa para uso em uma segunda máquina Compartilhar suas configurações Ativa com outros desenvolvedores Permitir todos os membros da equipe para usar as mesmas configurações em Selecione áreas.Configurações do Visual Studio Configurações no Visual Studio consistir de personalizações feitas para o ambiente de desenvolvimento integrado (IDE) com base em diferentes tipos de atividades de desenvolvimento e seus próprios personalizações. padrões editor. Configurações ativa são salvas por padrão no currentsettings. Para obter mais informações sobre as configurações predefinidas disponíveis com Visual Studio. Em outros casos. Para obter informações sobre como aplicar coleções configurações diferentes. consulte os seguintes tópicos. você também terá a opção de aplicar configurações a outros edição na usando a My Previous Settings opção. colocação dos comandos de menu. A coleção configurações é o primeiro elemento de suas configurações ativa. você pode exibir essas páginas manualmente. como layouts janela. modelos disponíveis na caixa de diálogo Novo projetos. janelas de ferramentas. a alteração é automaticamente salvo para currentsettings. e opções caixa diálogo disponíveis que você pode salvar. O Visual Studio aplica suas configurações ativa automaticamente sempre que você iniciar o Visual Studio. Para obter uma lista detalhada das personalizações incluídos no configurações predefinidas.vssettings juntamente com as configurações predefinidas. como alterar a cor do commented código no Editor. As configurações Ativa consistem em duas partes: predefinidas personalizações do arquivo instalado. e ajuda filtros. como o editor. Se você atualizar para outro edição do Visual Studio. e assim por diante. Exportar. consulte Configurações do Visual Studio. Com configurações. se uma coleção configurações simplificada caixa de diálogo Opções. primeiro é necessário para selecionar uma coleção configurações que contém configurações predefinidas projetadas para corresponder seus hábitos de desenvolvimento. Eu selecionado como pendente eu página filtros fazer o conteúdo que aparece no índice analítico e no índice. Essas categorias configurações incluem: • • Favoritos Importar e exportar configurações Como: Alterar configurações selecionadas Você pode aplicar um sub-set das configurações de uma coleção configurações diferentes para as configurações atuais para criar um ambiente de desenvolvimento mais personalizada. No menu Tools. A Reset Complete página lista os erros associados a redefinindo as configurações com Details. 11.. 12. Um ícone aparece ao lado essas categorias com as possíveis questões de segurança. No Which settings do you want to import. consulte Configurações do Visual Studio.vssettings ou aplicar outra coleção configurações dois substituirão as configurações ativa completamente.Configurações podem ser aplicadas de duas maneiras: completamente você pode substituir as configurações Ativa com novas configurações ou você pode substituir uma parte de suas configurações ativa. selecione uma coleção configurações na lista e clique em Next. Importar um arquivo que contém todas as categorias configurações possíveis. Na página Save Current Settings. 8. Visual Studio 260 . Inversamente. 9. Para obter mais informações sobre configurações predefinidas. Você pode alterar o ativo How Do I página na lista drop-down como pendente eu outras páginas. Para alterar configurações selecione 7.vssettings só se aplica essas configurações que estiver selecionadas. No Which collection of settings do you want to import. bem como fornece conteúdo personalizado na caixa como guia. Na Welcome to the Import and Export Settings Wizard Página. escolha Import and Export Settings. e clique em Next 10. deixando as configurações ativos para as categorias restantes intacto. você precisará estar ciente das categorias dentro do arquivo configurações que podem ser uma questão de segurança. Clique em Finish. expanda a lista e selecione apenas a categorias ou itens de categoria que você deseja que se aplicam as configurações atuais. se você pretende importar configurações fornecidas por outras pessoas.vssettings. Importar um arquivo que contém somente um subconjunto das categorias configurações ou unselecting categorias configurações em um arquivo. Ajuda e Configurações Coleções configurações predefinidas também fornecer personalizações à Ajuda. selecionar Yes. clique em Import selected environment settings e clique em Next. Configurações especificam o padrão How Do I Página na Ajuda. save my current settings. Configurações e segurança Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança se você compartilhar suas configurações com outros usuários. e outras áreas IDE a um arquivo que você pode importar e usar em outro computador. clique Browse ou digite um novo caminho para Store my settings file in this directory. você pode usar esse arquivo em outros computadores ao importar esse arquivo para outra instalação do Visual Studio.vssettings Após ter criado um arquivo. importar esse arquivo completamente substitui as configurações existentes. 9. Se você gostaria de salvar o arquivo em um local diferente. 12.Trabalhando com configurações Esta seção contém informações sobre a aplicação. Você também pode importar arquivos de configuração criados por outros usuários e aplicar essas configurações para o Visual Studio. escolha Import and Export Settings. projetos. aprender a especificar um conjunto de configurações de uso da equipe. Na Welcome to the Import and Export Settings Wizard Página. clique em Export selected environment settings e clique em Next. fontes e cores. depuração.vssettings que você pode usar em um computador segundo ou compartilhar com outros desenvolvedores. No menu Tools. digite um nome para o arquivo de configurações. Importar um arquivo. exportar e importar configurações para personalizar o ambiente de desenvolvimento integrado (IDE) para melhor correspondência seu estilo de desenvolvimento. 14. Na página Export Complete. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. como seu computador de desenvolvimento segundo ou computador um colega na. clique em Next Configurações. Clique em Finish. Exportar configurações para um arquivo Você pode optar por exportar todas ou algumas das suas configurações atuais a um arquivo. 13. Observação Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança. Importar o arquivo se um arquivo de configurações Visual Studio 261 . 10. 11. Além disso. No Which settings do you want to export?. em seguida. No What do you want to name your settings file. Para exportar configurações 8. Você também pode encontrar informações gerais sobre como configurações funcionam e os tipos de itens que são personalizadas através das configurações.vssettings. examine os erros associados à exportação as configurações com Details. selecione as categorias você pretende exportar e. Se você está importando o arquivo configurações contém todas as categorias configurações possíveis. COMO: Compartilhar configurações entre computadores Você pode exportar configurações para o editor. decidir se deve ou não para salvar as configurações atuais. 14. não será exibida. 15.contém apenas um subconjunto das categorias configurações. No menu Tools. 12. save my current settings por criar um backup de suas personalizações IDE atuais. Na caixa Save Current Settings de diálogo. você pode compartilhar um arquivo. 10. Na página Import Complete. Logon Save Current Settings. examine os erros associados a importar as configurações em Details. selecione um arquivo na lista ou clique Browse para localizar um arquivo de configurações e clique em Next. somente você pode limpar todos os outras categorias configurações e apenas aplicar as configurações selecionadas sem alterar as configurações atuais para as categorias restantes Para importar configurações 9. são salvas para o arquivo.vssettings único em vários computadores.vssettings. Clique em Finish. Um desenvolvedor na equipe por exemplo. Observação Algumas categorias configurações podem conter informações que podem ser uma questão de segurança. 11. optar Yes. No What collection of settings do you want to import?. Visual Studio 262 . 7.vssettings entre computadores Em vez de criar uma cópia das suas configurações atuais e usando a cópia em outro computador. na próxima vez que você iniciar o Visual Studio em outros computadores. escolha Import and Export Settings. Para compartilhar um arquivo único configurações entre computadores 6. Na Welcome to the Import and Export Settings Wizard Página. optar No. A lista Tarefas por exemplo. se você fechar a lista de tarefas em um computador.vssettings único em um compartilhamento de rede. Essa técnica pode ser útil se você desejar as personalizações mesmas exatas disponíveis em todas as vezes em vários computadores. 13. Compartilhar um arquivo único. tem exportadas todas as sua configurações para um arquivo para que outras pessoas na equipe podem utilizá-lo. No Which settings do you want to import?. independentemente do computador no qual você torná-los na. No menu Tools. Se você desejar se aplicar as configurações de fontes e cores e as configurações teclado desse arquivo. selecione as configurações opções você pretende importar do arquivo. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto.vssettings selecionado. personalizações feitas. escolha Import and Export Settings. 16. just import new settings. apenas aplica essas categorias e não afeta as configurações atuais para categorias não importadas. Quando você compartilhar um arquivo. overwriting my current settings por continuar sem fazer o backup suas personalizações IDE atuais. escolha Options Na pasta Environment. clique em Import selected environment settings e clique em Next. vssettings para um subconjunto de categorias configurações disponíveis que todos os desenvolvedores de seu grupo podem usar. 10. Partir do Tools menu. Insira um UNC ou caminho local. escolha Options. Para especificar um arquivo. como o editor. consulte COMO: Compartilhar configurações entre computadores. ou clique Browse para localizar o arquivo. O Visual Studio verifica que você estiver usando a versão mais recente do arquivo. Quaisquer alterações feitas no arquivo. 10.8. Opção Exportar configurações de ambiente selecionada Importar configurações de ambiente selecionada Redefinir todas as configurações Descrição Salvar um subconjunto ou todas as suas configurações existentes para que você pode usar essas configurações em outro computador. Clique OK para aplicar as configurações. permitindo que desenvolvedores individuais para manter personalizações feitas para outras áreas do IDE. ele pode ser útil para que cada desenvolvedor usar as configurações mesmas exatas em algumas áreas do ambiente de desenvolvimento integrado (IDE). escolhendo Import and Export Settings. essas configurações da equipe não seria substituem qualquer categoria não especificada no arquivo.vssettings são aplicadas automaticamente. 7. escolha Import and Export Settings.vssettings de grupo sempre que você iniciar o Visual Studio.vssettings para uso em um grupo 6. digite uma pasta compartilhada ou clique Browse para localizar um compartilhamento de rede.vssettings de grupo. Quando aplicado. ou substituir as configurações para usar uma coleção configurações predefinidas. Import and Export Settings Wizard Use este assistente para exportar configurações. Selecione Use team settings file. Você pode incentivar Essa consistência criando um arquivo.vssettings. 8.vssettings. Clique em OK. Você pode acessar este assistente a partir do Tools Menu. importar configurações. Aplica as configurações em um arquivo você tiver recebido. 9. 9. repita as etapas 1 a 4. Para obter informações sobre como criar um arquivo. Na pasta Environment. Substitui existentes configurações com os do arquivo importado. Na Automatically save my settings to this file. Como: Especificar configurações para uma equipe Quando estiver trabalhando em um grupo. Permite que você se reverter as configurações de volta para uma das configurações predefinidas disponíveis com o produto. No segundo computador. Visual Studio 263 . ou especificar um sub-set das configurações por categoria ou item de categoria. Mais tarde você pode optar por importar essas configurações para retornar ao estado IDE atual. Visual Studio 264 . mas são automaticamente selecionados se você escolher All Settings. Which settings do you want to export? Nomeie O arquivo de configurações. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. Salvar configurações atuais. Store my settings file in this directory. Observação Configurações que podem conter informações de identificação sobre você ou seu computador são marcadas com um gráfico de aviso. importar e exportar configurações Assistente Use esta página do Assistente para configurações a importação e exportação para especificar o nome e local do arquivo que irá conter as configurações exportadas. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. COMO: Compartilhar configurações entre computadores Yes. importar e Assistente para exportação configurações Use esta página do Assistente para configurações a importação e exportação para salvar as configurações ativos antes de importar novas configurações. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. COMO: Compartilhar configurações entre computadores What do you want to name your settings file? Digite um nome personalizado para as configurações exportadas. importar e exportar configurações Assistente Use esta página do Assistente para configurações a importação e exportação para especificar algumas ou todas as suas configurações atuais ser exportados para um arquivo para uso em outros computadores. • COMO: Compartilhar configurações entre computadores Selecione para exportar todas as configurações.Escolha Configurações para exportar. save my current settings Selecione esta opção para criar um backup das suas configurações atuais. Clique Browse para especificar uma pasta personalizada. Especifica o diretório padrão no qual as configurações exportadas serão salvos. Essas configurações não são selecionados por padrão. Especifica o diretório padrão no qual as configurações atuais serão salvos. Clique Browse para navegar para uma coleção configurações que não aparece na lista. Para obter mais informações sobre coleções configurações predefinidas. • Como: Alterar configurações selecionadas Lista as coleções configurações disponíveis. No. Se você está importando o arquivo configurações contém configurações para itens de categoria você ter personalizado. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. ou clique Browse para localizar uma coleção diferente para importar. consulte Configurações do Visual Studio. as configurações importadas substituirá as alterações. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. Escolha um coleção de configurações para importar.Setting file name Store my settings file in this directory Digite um nome personalizado para as configurações atuais. • COMO: Compartilhar configurações entre computadores Selecione uma coleção na lista. Escolha Configurações para importar. Which settings do you want to import? Description Exibe informações sobre a coleção configurações que são otimizadas para. Which collection of settings do you want to import? Description Exibe informações sobre a coleção configurações que são otimizadas para. Visual Studio 265 . Clique Browse para especificar uma pasta personalizada. just import new settings. Somente disponível para Default Settings. overwriting my current settings Selecione esta opção se você não quiser backup as configurações atuais. importar e Assistente configurações exportação Use esta página do Assistente para configurações a importação e exportação para especificar a coleção Configurações você pretende importar. importar e Assistente configurações exportação Use esta página do assistente Importar e exportar configurações para especificar uma coleção configurações predefinidos ou uma coleção configurações personalizadas você deseja importar para uso no IDE. Details Exibe informações sobre qualquer sucesso ou falhas. Import and Export Settings Wizard Esta página do importação e assistente exportar para configurações exibe informações sobre a tarefa configurações concluída com êxito ou não e todos os erros que foram encontrados.<task> Complete. Visual Studio 266 . Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. Adicionar itens que são úteis para vários projetos na solução ou para a solução sem referênciar o item em cada projeto. conexões de dados. projetos e arquivos Os tópicos a seguir descrevem tarefas comuns que você pode executar ao trabalhar com soluções e projetos. projetos. Soluções multi-projeto Trabalhar em mais de um projeto de cada vez em uma instância do (IDE) o ambiente integrado de desenvolvimento. e itens e as vantagens de usar o Visual Studio para gerenciar seus projetos de desenvolvimento e arquivos. é parte do o ambiente integrado de desenvolvimento (IDE). Uma solução pode conter vários projetos e um projeto normalmente contém vários itens. Solução.Gerenciar soluções. pastas. e itens O Visual Studio fornece dois recipientes para ajudá-lo com eficiência gerenciar os itens que são exigidos por seu esforço de desenvolvimento. e itens Entender os conceitos de soluções. projetos e arquivos. o Visual Studio fornece Solution Folders para organizar projetos relacionados em grupos e executar ações nesses grupos de projetos. Introdução ao soluções. Nesta seção Introdução a soluções. projetos. Usar o Solution Explorer para manipular detalhes de gerenciamento de arquivos enquanto você se concentra nos itens que fazem parte do seu esforço de desenvolvimento. Projeto e elementos de interface do usuário de arquivo Referência para elementos de interface do usuário que permitem que você configure suas soluções. e arquivos que você precisa para criar seu aplicativo. Projetos temporários Entender quais projetos são temporários e quando você pode trabalhar com eles. como referências. Além disso. conexões de dados. O Solution Explorer é uma interface para exibir e gerenciar esses recipientes e seus itens associados. Esses recipientes permitem a você tirar proveito do IDE das seguintes maneiras: • • Gerenciar configurações para a solução como um todo ou para projetos individuais. Projetos autônomos Entender quais projetos são autônomos e quando você pode trabalhar com eles. Soluções e projetos recipientes: Soluções e projetos contém itens que representam as referências. pastas e arquivos. • Visual Studio 267 . Esses recipientes são chamados soluções e projetos. projetos. Propriedades de projeto do Visual Studio Discute o Designer de Projeto e como modificar as configurações do projeto. Como itens de solução para arquivos que são aplicáveis a sua solução como um todo na pasta Solution Items do Solution Explorer. Como arquivos variados para arquivos que não estejam associados a um projeto ou a uma solução e que podem ser exibidos em uma pasta Miscellaneous Files. interface de usuário elementos Projetos e soluções criados externamente Desenvolvendo e gerenciando scripts Windows Scripting Arquivos variados Windows Script Host Visual Studio 268 . A organização e exibição depende do modelo de projeto que você selecionar bem como das modificações que voce efetuou. e classes dentro de um projeto no Solution Explorer.• Trabalhar em diversos arquivos que são independentes de soluções ou projetos. ou pastas. como formulários. itens podem ser organizados das maneiras a seguir: • Como itens de projetos. arquivos fonte. conexões de dados. itens: Itens podem ser arquivos e outras partes do seu projeto tais como referências. referências. projetos. consulte os tópicos a seguir: Para obter mais informações Soluções e projetos Consulte Soluções como Containers Projetos como Containers Executar tarefas comuns de gerenciamento de arquivos Gerenciar soluções. e Arquivos HOW TO: criar pastas para soluções Explorer solução Soluções multi-Project Itens solução Soluções e estruturas de diretório Solution Explorer no ambiente de desenvolvimento integrados (IDE) Gerenciando múltiplos projetos em uma solução Itens que são referenciadas por vários projetos e incluídos em compilações da solução Elementos da interface de usuário relacionados a uma solução no IDE Soluções. No Solution Explorer. Conexões de dados arquivos. que são itens que compõem seu projeto. • • Para informações mais detalhadas ou para aprender a usar o Solution Explorer. no menu Project . 2. e informações de assembly. As seguintes tarefas podem ser realizadas no painel Application. Clique na guia Application. Por exemplo. são definidas no painel Application do Project Designer. Selecione um projeto no Solution Explorer. em seguida. nome do produto e mais. Os tópicos nesta seção descrevem as diversas tarefas envolvidas na criação e no gerenciamento de projetos Visual Basic. 3. COMO: especificar informações de assembly Propriedades ou atributos de informações de assembly são usadas para fornecer informações sobre um assembly ou aplicativo. Para obter mais informações sobre atributos assembly. objeto de inicialização. componentes e serviços em Visual Studio 2005. Você especifica informações assembly na Caixa de diálogo Assembly Information. Gerenciando propriedades de projeto com o designer de projeto O Project Designer é uma interface de usuário conveniente no Visual Studio que permite a você definir propriedades de projeto. Para inserir ou editar informações Assembly 1.Propriedades de Projeto (Visual Studio) O projeto é o ponto de partida para a criação de aplicativos. Como alterar um nome de conjunto: A Assembly Name propriedade de um aplicativo determina o nome que será usado para o aplicativo compilado. ele pode ser alterado na página Application da a Project Designer. algumas das quais você também pode definir através da Janela Properties. incluindo uma descrição. Clique no botão Assembly Information para abrir a caixa de diálogo Assembly Information.exe Os Assembly Name padrões para o projeto nome. Essas informações correspondem aos valores dos atributos assembly globais. Visual C# e Visual J#. definir a Assembly Name. Ele atua como um recipiente que gerencia o seu código fonte. informações de versão. Observação Visual Studio 269 . acessível a partir da página Application do Project Designer. nome da empresa. tais como tipo de aplicativo. clique em Properties. Um projeto é organizado como parte de uma solução que pode conter vários projetos que sejam interdependentes entre si. Gerenciando propriedades de aplicativo As propriedades de aplicativo gerais descrevendo o aplicativo e seu comportamento. as conexões de dados e as referências. Para " MyApplication " para um Windows aplicativo resultaria em um arquivo executável chamado MyApplication. consulte Atributos globais no Visual Basic. COMO: alterar o namespace para um aplicativo A propriedade Root Namespace define o namespace raiz para todos os arquivos no projeto. Escolha o tipo desejado na lista suspensa Application Type. 2. 3. Com um projeto selecionado no Solution Explorer. Por exemplo. No campo Root namespace. é o mesmo a Assembly Name e alterando o Assembly Name faz não alterar o nome do projeto como o nome do projeto. Com um projeto selecionado no Solution Explorer.Classe2. Com um projeto selecionado no Solution Explorer. e você tiver uma classe Classe1 fora de qualquer namespace em seu código. Command Line Application ou Server Class Library. Windows Class Library.Classe1. Clique na guia Application.Order. digite o nome para o seu aplicativo. Clique na guia Application. Clique na Application Guia. Windows Service. se você definir o namespace raiz para Projeto1. consulte Declaração de namespace. no menu Project . o seu namespace seria Projeto1. A propriedade Application Type pode ser definida na página Application do Project Designer. Para alterar o tipo de aplicativo 1. Diferentes propriedades e opções de projetos estão disponíveis dependendo do tipo de aplicativo. 3. clique em Properties. no menu Project . alterar o nome do projeto não altera Para alterar a propriedade Assembly Name 1. COMO: alterar o tipo de aplicativo A propriedade Application Type para um projeto determina o tipo de aplicativo a ser criado: Windows Application. Também é possível limpar a propriedade Root Namespace. a qual permite que você especifique manualmente a estrutura do namespace do seu projeto. Se você tiver uma Classe2 em um namespace Order no código. os dois são não relacionados. 2. 2.Embora o padrão Valor de a Assembly Name. 3. clique em Properties no menu Project . Para alterar o namespace de um projeto 1. O padrão Application Type é o mesmo que o Project Type escolhido na caixa de diálogo Add Project. Visual Studio 270 . clique em Properties. No campo Assembly Name. Para mais informações. insira o nome. seu namespace seria Projeto1. Como bibliotecas de classes não têm um ponto de entrada. o seu aplicativo utiliza o Sub Main personalizado (e você deve adicionar código no procedimento Sub Main para o formulário). Visual Studio 271 . Para alterar o formulário ou objeto de inicialização 1. 2. seu aplicativo usa o Sub Main padrão. Observação Ao usar um procedimento Sub Main personalizado como o objeto Startup (Inicialização). que só pode ser Form1. Selecione um objeto de Startup da lista suspensa Startup object ou Startup form. Clique na guia Application. sua única opção para essa propriedade é (Vazio). Um aplicativo do Windows tem uma opção Startup Form. Se você desativar a estrutura de aplicativos. Esta opção pode ser Startup object ou Startup form dependendo do tipo de projeto. Por exemplo. Com um projeto selecionado no Solution Explorer (Explorer de Solução). Você pode definir a propriedade Startup object ou Startup form na página Application (Aplicativo) do Project Designer (Designer de Projeto). clique em Properties. Se você ativar a estrutura de aplicativos. 4. no menu Project. Para definir o objeto de inicialização para um aplicativo do Windows como Sub Main 1. clique em Properties (Propriedades). no menu Project (Projeto). A opção Enable application framework (Habilitar framework de aplicativo) especifica se um projeto de aplicativo do Windows será iniciado com um procedimento personalizado Sub Main (que você tenha criado).COMO: Alterar o objeto de inicialização para um aplicativo A propriedade Startup object (Objeto de inicialização) ou Startup form (Formulário de inicialização) de um projeto define o ponto de entrada a ser chamado quando o aplicativo é carregado. 3. o código nos eventos do aplicativo (Startup. 3. um aplicativo de console tem uma opção Startup Object que pode ser Sub Main ou Module1. Selecione Sub Main na lista suspensa Startup object. Shutdown. Clique na guia Application. geralmente você define-o para o formulário principal em seu aplicativo ou para o procedimento Sub Main que deve executado quando o aplicativo é iniciado. 2. Com um projeto selecionado no Solution Explorer. StartupNextInstance e UnhandledException) não é executado. Desmarque a caixa de seleção Enable application framework. Selecione o Application painel. também conhecidos como Temas do Windows XP. O Windows XP introduziu um novo aspecto de aparência (look em feel) para a interface de usuário do Windows. 3. 2. com controles que têm cantos arredondados e que alteraram a cor quando você para o mouse sobre eles.. clique em Properties. 3. Observação Suporte a estilos visuais do XP pode também ser ativado ou desativado através de programação através do método EnableVisualStyles da classe Application. Selecione o Application painel. A Icon propriedade pode ser acessado no painel Application da o Project Designer.ico) para o aplicativo compilado que será exibido no Windows Explorer e na barra de tarefas do Windows. Visual Studio 272 . COMO: Ativar estilos visuais Observação Este tópico se aplica somente para os projetos do Visual Basic. Para mais informações. o aplicativo volta para o aspecto de aparência (look and feel) tradicional do Windows. no menu o Project clique Properties.> na lista Icon suspensa e navegar para a localidade do arquivo de ícones que você deseja.COMO: especifica um ícone de aplicativo A Icon propriedade para um projeto Especifica o arquivo ícone (. Para especificar um ícone do aplicativo e adicioná-la ao seu projeto 1..ico) na lista suspensa o Icon. Com um projeto selecionado no Solution Explorer. consulte o tópico COMO: Ativar estilos visuais do Windows XP. você pode alterar a propriedade na página Application do Project Designer. Com um projeto selecionado no Solution Explorer. O arquivo ícone é adicionado ao seu projeto como um arquivo de conteúdo. no menu Project . 2. Selecione <Browse.. Por padrão. Se você não deseja que o aplicativo ofereça suporte a estilos visuais. Ela contém uma lista dos ícones que foram adicionados a um projeto como recursos ou como arquivos de conteúdo Para especificar um ícone do aplicativo 1. aplicativos baseados no Windows criados com Visual Basic automaticamente suportam estilos visuais. Selecione um arquivo de ícone (. Quando executado em uma plataforma que não dá suporte para Temas do Windows XP. Desmarque a caixa de seleção Make single instance application. COMO: Especificar comportamento de instâncias para um aplicativo Observação Este tópico se aplica somente aos projetos do Visual Basic. acessível da página Application do Project Designer. Com um projeto selecionado no Solution Explorer. Os aplicativos criados com Visual Basic são. Clique na guia Application. clique em Properties. aplicativos de múltiplas instâncias. Para ativar os estilos visuais do Windows XP 1. 2. 2. no menu Project . Clique na guia Application. somente uma única instância do aplicativo compilado é permitida. no menu Project. Quando a caixa de seleção Make Single Instance Application está marcada. Com um projeto selecionado no Solution Explorer. Marque a caixa de seleção Make single instance application. por padrão. Visual Studio 273 . Clique na guia Application. 3. Se um usuário tentar iniciar uma segunda instância. Marque a caixa de seleção Enable XP visual styles. Com um projeto selecionado no Solution Explorer. 3. Observação Estilos visuais são ativados por padrão. no menu Project. Clique na guia Application. clique em Properties. 3.Para desativar os estilos visuais do Windows XP 1. você pode impedir os usuários de iniciar várias instâncias do seu aplicativo. 2. Desmarque a caixa de seleção Enable XP visual styles. Isso pode ser feito marcando a propriedade Make Single Instance Application para o seu projeto. Com um projeto selecionado no Solution Explorer. Para criar um aplicativo de múltiplas instâncias 1. Em alguns casos. Para criar um aplicativo de instância única 1. os usuários podem iniciar várias instâncias do aplicativo compilado. clique em Properties. clique em Properties. no menu Project . o foco é deslocado para a instância que já está sendo executada e o evento StartupNextInstance é destacado. 2. 3. no menu Project .Observação Por padrão. defina a Authentication mode. A propriedade Shutdown mode (modo de desligamento) para um projeto de Windows Application (aplicativo do Windows) determina o comportamento de Visual Studio 274 . Em tais casos. no menu Project . selecione a autenticação Application-defined. Para usar autenticação do Windows 1. Em algumas situações. ao invés de usar os métodos de autenticação padrão do Windows. Aplicativos baseados no Visual Basic usam autenticação do Windows para identificar o usuário conectado no momento. Essas informações podem ser recuperadas em tempo de execução usando o objeto My. Com um projeto selecionado no Solution Explorer. convém escrever seu próprio código para autenticar usuários. COMO: ativar autenticação de usuário personalizada Observação Este tópico se aplica somente para os projetos do Visual Basic. Para ativar a autenticação personalizada (Application-DEFINED) 1. 3. Em tais casos. os aplicativos são de múltiplas instâncias. clique em Properties. para autenticação Windows. consulte Acessando dados do usuário. clique em Properties. Na lista suspensa Authentication mode. Isso é a configuração padrão. 2. Com um projeto selecionado no Solution Explorer. 2. selecione autenticação Windows. Você precisará fornecer seu próprio código de autenticação. Clique na guia Application.User. Na lista suspensa Authentication mode.User. COMO: Especificar o comportamento de desligamento para um aplicativo Observação Este tópico se aplica somente para os projetos do Visual Basic. defina a Authentication mode para autenticação Application-defined. 3. Clique na guia Application. Para informações sobre programação com o objeto My. A propriedade Shutdown mode pode ser definida na página Application (Aplicativo) do Project Designer (Designer de projeto).0.Exit ou End for chamada explicitamente. Visual Studio 275 . o padrão). Observação do Visual Basic Referências de projeto são gerenciadas de modo diferente no Visual Studio do que como eram no Visual Basic 6. mesmo que outros formulários estejam abertos. remover e gerenciar as referências existentes.0. consulte Gerenciamento de projeto para usuários do Visual Basic 6. Clique na guia Application. clique em Properties (Propriedades). Com um projeto selecionado no Solution Explorer (Explorer de Solução). Uma referência pode ser feita aos seguintes tipos de componentes: • • • • Bibliotecas de classes do . Referenciando Namespaces e Componentes Referências de projeto são usadas para acessar as propriedades. As seguintes tarefas podem ser realizadas na página References. consulte Referências da Web. Referências de projeto Para escrever código contra um componente externo.NET Framework ou assemblies Componentes COM Outras bibliotecas de classes de projetos na mesma solução XML Web Services Para obter mais informações sobre referências de XML Web Services.Application. Os tópicos a seguir contêm uma visão geral das referências no Visual Basic e Visual C# e fornecem instruções sobre como adicionar.desligamento para o aplicativo. o aplicativo termina quando o formulário definido como o Startup object (objeto de inicialização) fechar. Quando definida como When last form closes (Quando o último formulário fechar). Para mais informações. 2. Na lista suspensa Shutdown mode. Para alterar o comportamento de desligamento 1. no menu Project (Projeto). seu projeto deve primeiramente conter uma referência a ele. escolha When startup form closes ou When last form closes. Quando definida como When startup form closes (Quando o formulário de inicialização fechar. 3. o aplicativo termina quando o último formulário for fechado ou quando a declaração My. adicionar e remover referências e namespaces importados para seu projeto. os métodos e os eventos de um objeto definido e aplicá-los em seu programa. Gerenciando referências A página References do Project Designer é usada para exibir. Solucionando problemas de referências quebradas Se seu aplicativo tentar usar uma referência quebrada.Referências a componentes compartilhados Em tempo de execução. consulte Como: preparar e gerenciar Builds. A conexão de rede ou a autenticação falhou. Essas instâncias são mostradas na lista a seguir: • • • • • O caminho de referência do projeto está incorreto ou incompleto. a referência não é copiada. Se você implantar um aplicativo que contém uma referência a um componente personalizado que está registrado no GAC. O arquivo sendo referenciado foi excluído. o valor é definido como true. O arquivo sendo referenciado foi renomeado. Agora. consulte Como: adicionar ou remover referências no Visual Studio e Programando com assemblies. reduzindo o risco de publicar código personalizado com o qual você não está familiarizado. Por padrão. um erro de exceção é gerado. a propriedade CopyLocal está definida como false se o assembly ou componente está no cache global de assemblies ou é um componente de estrutura. A incapacidade de localizar o componente referenciado é o disparador primário do erro. Referências de projeto-a-projeto Em uma solução com vários projetos. Se o valor for true. independentemente da configuração CopyLocal. componentes devem estar em um dos dois locais: no caminho de saída do projeto ou no cache global de assemblies (GAC). Referências de projeto-a-projeto são sempre definidas como true. você poderia definir a propriedade CopyLocal em uma referência para garantir que o assembly fosse implantado. A referência é a um componente COM que não está instalado no computador. A propriedade CopyLocal indica se esta cópia precisa ser feita. a referência deve ser copiada para o caminho de saída do projeto quando o projeto é criado. você pode criar referências a objetos criados em outro projeto que reside na mesma solução. você deve adicionar manualmente o assembly à pasta \Bin. mas existem várias situações em que uma referência pode ser considerada quebrada. Para evitar esses erros. A seguir estão soluções para esses problemas. Em versões anteriores do Visual Studio. Se false. Caminho de referência está incorreto Visual Studio 276 . Para obter mais informações. Se o projeto contiver uma referência a um objeto que não esteja em um desses locais. Isso cria uma interdependência que requer uma consideração especial ao criar e executar o aplicativo. é possível que usuários trabalhando em um ambiente com vários desenvolvedores sintam a falta de um assembly referenciado no seu ambiente local. é melhor nesses casos adicionar referências de projeto-a-projeto. Caso contrário. Observação Arquivos em assemblies são referenciados com caminhos absolutos no arquivo de projeto. o componente não será implantado com o aplicativo. a referência é copiada. Isso coloca todo código personalizado sob exame detalhado. Para mais informações. Devido a isso. como D:\MeusComponentes\. depois clique no botão Add Folder. Arquivo referenciado foi renomeado É possível que o arquivo referenciado tenha sido renomeado. No Solution Explorer. consulte Como: adicionar ou remover referências no Visual Studio. A propriedade ReferencePath é mantida para cada usuário em cada computador. Para consertar uma referência de projeto quebrada corrigindo o caminho de referência 1. selecione a página References e clique no botão Reference Paths. Para mais informações. assim modificar o seu caminho de referência não afeta outros usuários do projeto. você pode excluir a referência quebrada e substituí-la usando a caixa de diálogo Add Reference. leia-a deste local. selecione a página Reference Paths. Uma outra solução é usar o item Reference Path em páginas de propriedades do projeto e modificar as pastas na lista para apontar para os locais correto. No campo Folder. Referências são armazenadas sob o nome do arquivo de componente (por exemplo. Dica Referências de projeto-a-projeto não têm esses problemas. algumas referências podem não ser encontradas quando um componente está localizado em um diretório diferente em cada computador. o local da pasta do arquivo de componente (por exemplo. Se você estiver usando o Visual C#.Se projetos são compartilhados em computadores diferentes. 2. Quando o projeto é aberto. digite o caminho da pasta que contém o item que você deseja referênciar. Para corrigir uma referência de projeto quebrada a um arquivo que não existe mais no seu disco • • • Excluir a referência. Na caixa de diálogo Reference Paths. clique com o botão direito do mouse no nó do seu projeto e clique em Properties. Por esse motivo. digite o caminho da pasta que contém o item que você deseja referenciar no campo Folder. Se você estiver usando o Visual Basic. Arquivo referenciado foi excluído É possível que o arquivo sendo referenciado tenha sido excluído e não exista mais na unidade. Se o projeto for aberto em um computador que armazena o componente em um diretório diferente. Visual Studio 277 . use-as em vez de referências de arquivo. O Project Designer aparecerá. e depois clique no botão Add Folder. MeuComponente). a referência não poderá ser encontrada e um erro aparecerá na Lista de Tarefas. ele tenta localizar esses arquivos de componentes referenciados procurando nos diretórios no caminho de referência. se possível. Para corrigir este problema. C:\MeusComponentes\) será acrescentado à propriedade de projeto ReferencePath. Quando uma referência é adicionada a um projeto. 3. Se a referência existir em outro local no seu computador. adicionando um caminho de referência. Para mais informações. Browse — Permite que você procure por um componente no sistema de arquivos. você precisa adicionar uma referência a ele. Recent — Contém uma lista de componentes recentemente adicionados a projetos em seu computador. Você também pode adicionar referências da Web na caixa de diálogo Add Web Reference.NET\Common7\IDE\Public Assemblies) ou na Global Assembly Cache (GAC). Para mais informações. Projects — Lista todos os componentes reutilizáveis criados em projetos locais.NET — Lista todos os componentes do . Para obter mais informações sobre como usar referências a componentes COM em seus projetos. você precisa lê-lo daquele local. por exemplo. O Visual Studio provê cinco opções na Caixa de diálogo Add Reference: • • • • • . Componente COM não está instalado no computador Se um usuário tiver adicionado uma referência a um componente COM e um segundo usuário tentar executar o código em um computador que não tenha este componente instalado. Conexão de rede ou autenticação falhou Pode haver várias causas possíveis para arquivos inacessíveis: uma conexão de rede ou uma autenticação que falhou. Para adicionar seus próprios assemblies à lista. você pode precisar entrar em contato com o seu administrador local para obter acesso aos recursos necessários. Observação Você deve evitar adicionar referências de arquivo a saídas de outro projeto na mesma solução. a caixa de diálogo Add References somente lista módulos (assemblies) que estão na pasta Public Assemblies (Program Files\Microsoft Visual Studio .Para corrigir uma referência quebrada a um arquivo que foi renomeado • • Exclua a referência. excluir a referência e corrigir o código que a usa é sempre uma opção. o segundo usuário receberá um erro de que a referência está quebrada. Por padrão. Cada causa pode ter meios exclusivos de recuperação. por exemplo.NET Framework. porque Visual Studio 278 . consulte Como: adicionar ou remover referências no Visual Studio. Para mais informações. consulte Como: adicionar ou remover referências no Visual Studio. e depois adicione uma referência ao arquivo renomeado. Instalar o componente no segundo computador irá corrigir o erro. COMO: Adicionar ou remover referências no Visual Studio Para usar um componente em seu aplicativo. consulte COMO: adicionar e remover referências da Web. consulte Interoperabilidade COM em aplicativos . COM — Lista todos os componentes COM disponíveis para referência. Se a referência existir em outra local no seu computador. No entanto.NET Framework disponíveis para referência. Observação O procedimento para definir o caminho de referência para projetos do Visual C# e do Visual J# é ligeiramente diferente. Isso torna desenvolvimento em equipe mais fácil. Para mais informações. 2. Para definir um caminho de referência 1. Para mais informações. Observação Se você implantar/copiar um aplicativo que contém uma referência a um componente personalizado que é registrado no GAC. Para remover uma referência 1. 4. Dica Você pode selecionar vários componentes mantendo pressionada a tecla CTRL. No Solution Explorer. clique na guia References. permitindo melhor gerenciamento das bibliotecas de classes criadas em seus projetos. clique na guia References. No Solution Explorer. o componente não será implantado/copiado com o aplicativo. Clique no botão Remove. 3. consulte COMO: Remover referências não usadas. Na lista References. No Project Designer. Para mais informações. selecione o(s) componente(s) que você deseja referenciar. clique duas vezes no nó My Project do projeto. No painel superior. 3. consulte Solucionando problemas de referências quebradas. No Project Designer. use a guia Projects da caixa de diálogo Add References para criar referências project-to-project. independentemente da configuração Copy Local. 4. clique duas vezes no nó My Project do projeto. Dica Você também pode verificar seu projeto procurando referências não utilizadas e remover todas elas de uma vez. 2. clique na guia References. No Solution Explorer. J#).isso pode causar erros de compilação. consulte COMO: definir o caminho de referência (C#. Na caixa de diálogo Add Reference. Visual Studio 279 . desde que os componentes estejam todos na mesma guia. 5. consulte Referências do projeto. selecione a guia indicando o tipo de componente que você deseja referenciar. 2. Para adicionar uma referência 1. selecione a referência que deseja remover. Para mais informações. Em vez disso. No Project Designer. e clique OK. Clique no botão Add reference para abrir a caixa de diálogo Add References. clique duas vezes no nó My Project do projeto. Messaging e apenas referenciar o elemento que você precisa no código como MessageQueue. mas a única classe no Visual Studio 280 . consulte COMO: Adicionar ou remover referências no Visual Studio. clique na guia References. Importações do usuário Importações do usuário permitem que você importe uma classe específica de um namespace em vez do namespace inteiro. clique duas vezes no nó My Project para o projeto. No Solution Explorer. Observação Para ser importado. clique na guia References. No Solution Explorer. 2. No Project Designer. Clique no botão Reference Paths. 5. você precisará adicionar uma referência para o componente que o contém. 3. COMO: Adicionar ou remover namespaces importados Importar um namespace permite que você use elementos deste namespace sem qualificar totalmente o elemento. No Project Designer.MessageQueue. Clique no botão Add Folder e em seguida. clique em OK Observação Somente a pasta especificada será pesquisada toda vez que a caixa de diálogo Add References for aberta. As importações que você especificar na esta caixa de diálogo são passadas diretamente para o compilador (/imports) e aplicadas a todos os arquivos no seu projeto. seu aplicativo pode ter uma importação do namespace Systems. clique duas vezes no nó My Project para o projeto. Na lista Imported Namespaces. Você deve adicionar um caminho separado para cada subpasta a ser pesquisada. Na lista Imported Namespaces. No campo Folder:. Se o namespace não aparecer na lista. o namespace deve estar em um componente referenciado. 2. desmarque a caixa de seleção para o namespace que você deseja remover. você pode importar o namespace System. selecione a caixa de seleção para o namespace que você deseja adicionar. Por exemplo. se você desejar acessar o método Create na classe System. 3. Para remover um namespace importado 1. Usar a declaração Imports para utilizar um namespace em apenas um arquivo de código fonte.Messaging.3. 4. Para mais informações. subpastas não serão pesquisadas. insira o caminho completo para a pasta que contém os componentes.Create Namespaces importados são gerenciados na página References do Project Designer. Para adicionar um namespace importado 1.Diagnostics. Por exemplo. Você pode definir System. 3.namespace em que você está interessado é a classe Debug. acessível a partir da página References do Project Designer Para remover referências não utilizados 1. Clique no botão Update user import para atualizar o namespace na lista Imported Namespaces.EventLog como uma importação de usuário e substituir System. Se você posteriormente mudar de idéia e decidir que foi realmente a classe EventLog que você necessitava. 3. No Solution Explorer. COMO: Remover Referências Não Usadas Para reduzir o tamanho do seu aplicativo. 2. Clique no botão Unused references para abrir a caixa de diálogo Unused References O projeto é varrido. 5. clique duas vezes no nó My Project para o projeto. digite o nome completo do namespace que deseja importar. e a caixa de diálogo é preenchida com uma lista de referências que não estão sendo referenciadas no seu código. você pode inserir System. digite o nome para o novo namespace.Diagnostics. Clique no botão Add user import para adicionar um namespace à lista Imported Namespaces Observação O botão Add user import será desativado se o namespace corresponde a um já na lista.Diagnostics. 2. Visual Studio 281 . No Project Designer. 4. Para atualizar uma importação de usuário 1. No Solution Explorer. clique duas vezes com o nó My Project do projeto. clique na quia References . selecione o namespace que você deseja alterar. Na caixa de texto abaixo da lista Imported Namespaces. clique na guia References. e remover a importação para System. No Solution Explorer. clique duas vezes no nó My Project para o projeto.Diagnostics. incluindo o espaço para o namespace raiz.Diagnostics. No Project Designer. Na lista Imported Namespaces.Debug como uma importação de usuário. Isso pode ser feito usando a caixa de diálogo Unused References. 4. você não pode adicionar uma importação duas vezes. Na caixa de texto abaixo da lista Imported Namespaces. clique na guia References. Para adicionar uma importação de usuário 1. você pode desejar remover referências a componentes que são na verdade não são chamados pelo seu código.Debug usando a funcionalidade de atualização. 2. No Project Designer. Para mais informações. o componente não será implantado/copiado com o aplicativo. 4. 3. COMO: Definir a propriedade Copy Local (Copiar Localmente) de uma referência A Propriedade Copy Local (correspondente a CopyLocal) determina se uma referência é copiada para o caminho de bin local. selecione a guia References. 3. Em tempo de execução. No Project Designer. As propriedades associadas a essa referência aparecem numa lista na janela Properties. Se essa propriedade é definida como True. Na caixa de diálogo Unused References .3. 4. a referência é copiada para o caminho de saída do projeto em tempo de execução. clique na seta na coluna direita para alterar o valor para False. No Solution Explorer. e em seguida. 2. e seguida. clique duas vezes no nó My Project para o projeto. opções de início. No Project Designer. Para definir a propriedade Copy Local como True 1. 2. As referências selecionadas serão removidas do projeto. Para definir a propriedade Copy Local como False 1. acessível no painel References do Project Designer. selecione a guia References. Selecione Copy Local da coluna esquerda. Selecione um componente referenciado na lista References As propriedades associadas a essa referência aparecem numa lista na janela Properties. uma referência deve existir tanto no Cache Global de Assemblies (GAC) quanto no caminho de saída do projeto. clique duas vezes no nó My Project para o projeto. como ação de inicício. marque as referências que deseja remover. clique na seta da coluna direita para alterar o valor para True. e seguida. e depuração remota são definidas no painel Visual Studio 282 . Selecione um componente referenciado na lista References. A propriedade Copy Local está definida na caixa de diálogo Reference Properties. consulte Referências de projeto. Selecione Copy Local da coluna esquerda. Observação Se você implantar/copiar um aplicativo que contém uma referência a um componente personalizado que está registrado no GAC. Gerenciando propriedades de depuração As propriedades de depuração que definem o comportamento da depuração. clique em Remove. independentemente da configuração Copy Local. No Solution Explorer. Nesta seção COMO: Alterar a ação de início para depuração de aplicativo COMO: Definir opções de início para depuração de aplicativo COMO: Ativar depuração remota COMO: Ativar depuração de código não gerenciado COMO: Ativar depuração de SQL Server Gerenciando propriedades de compilação As propriedades de compilação definindo o comportamento do compilador. Os tipos de recurso suportados pelo Resource Designer incluem seqüências de caracteres. ícones. Os tipos de recurso que têm suporte para o Resource Designer incluem strings. Para obter informações sobre Visual Studio 283 . são definidas no painel Compile do Project Designer. e constantes de compilação. As seguintes tarefas podem ser realizadas no painel Debug. imagens.Debug do designer de projeto. imagens. Nesta seção COMO: Ativar ou desativar avisos do compilador COMO: Definir otimizações do compilador COMO: Definir opções do compilador COMO: Alterar o local de compilação de um aplicativo COMO: Gerar documentação XML para um projeto COMO: Especificar eventos de construção COMO: Registrar um componente para interoperabilidade COM COMO: Definir constantes de compilação COMO: Otimizar um aplicativo para um tipo de CPU específica COMO: Especificar um endereço base para uma DLL COMO: Especificar eventos de construção Gerenciando Recursos de Aplicativo Você pode criar e gerenciar os recursos para o seu projeto usando o Resource Designer ou a página Resources do Project Designer. áudio. otimizações. como avisos do compilador. áudio e arquivos. COMO: Adicionar ou remover recursos Você pode usar o Designer Resource para adicionar ou editar recursos para o seu projeto. As seguintes tarefas podem ser realizadas no painel Compile. ícones. e arquivos. Clicando Yes fornecerá o novo suporte de recurso fortemente tipado. Para Visual C# e Visual J#. Para mais informações. Isso fornece uma maneira alternativa para consumir recursos.Resources. o Resource Designer Para o Visual Basic. no menu Project . exibindo conteúdo do arquivo em uma grade de configurações.bmp.resx. Visual Studio 284 . 4. no menu Project .. Ao soltar. Na barra de ferramentas Resource Designer. clique em Properties. o Resource Designer gera recursos fortemente tipados no namespace padrão da pasta de projeto My. clique em Properties. O Resource Designer é uma linguagem neutra e oferece suporte para projetos em todos as linguagens do Visual Studio. o recurso é adicionado à categoria recurso apropriada com base na sua extensão de arquivo. O arquivo será adicionado ao diretório de recursos e o Resource Designer abrirá o painel Category para o tipo de recurso que você adicionou.resx usando o Solution Explorer). Designer de projeto.como Resource Designer mantém recursos e informações de Designer.ico. gera recursos fortemente tipados no namespace padrão da pasta de projeto. Adicionar um novo recurso 1. Para informações sobre como acessar recursos através do objeto My. você pode definir opcionalmente as propriedades Encoding e FileType para o arquivo na janela de propriedades. clique na seta. Para mais informações. 5..WAV. Para adicionar um recurso existente 1. consulte Acessando recursos de aplicação Observação Os procedimentos para adicionar e remover recursos de seqüência de caracteres diferem dos outros tipos de recurso. Com um projeto selecionado na Solution Explorer. consulte Página de recursos. Na caixa de diálogo Add existing file to resources. uma janela separada do Resource Designer será aberta.Resources. Com um projeto selecionado no Solution Explorer. aponte para Add Resource. Se você clicar duas vezes no novo arquivo . Para recursos de arquivo. lhe será apresentada uma mensagem perguntando.. você pode adicionar recursos usando arrastar-esoltar para o Resource Designer. consulte StronglyTypedResourceBuilder. em vez de usar os métodos GetString e GetObject da classe ResourceManager. etc.). em tempo de compilação que encapsula o acesso aos recursos criando classes que contêm um conjunto de propriedades estática e somente leitura (GET). clique em Open. "Você deseja ativar a geração de recurso fortemente tipado para este arquivo?". 3. consulte COMO adicionar ou remover recursos de seqüência de caracteres:.resx. e em seguida. Se você adicionar um recurso manualmente para o projeto (por exemplo. navegue até o arquivo que contém o recurso que você deseja adicionar (. 2. os recursos no novo arquivo serão separados dos recursos que você criou usando a página Resource do Project Designer. Observe que quando você adicionar o novo arquivo . adicionando um arquivo . Além das tarefas listadas abaixo. Selecione a guia Resources. em seguida clique em Add Existing File. 4. mas ele não será removido da pasta Recursos. exibindo os conteúdos do arquivo em uma grade configurações. consulte acessando recursos de aplicação Se você adicionar um recurso manualmente para o projeto (por exemplo. Para Visual C# e Visual J#. e um editor de recurso será aberto para o tipo de recurso que você adicionou. Para mais informações. clique em Add O arquivo será adicionado ao diretório de recursos. 3. Para remover um recurso 1. 3. em vez de usar os métodos GetString e GetObject da classe ResourceManager. clique na seta.resx. Na barra de ferramentas Resource Designer. " Você deseja ativar a geração do recurso fortemente tipado para este arquivo? "Clicar Yes fornecerá suporte para o novo recurso fortemente tipado. O Resource Designer é uma linguagem neutra e oferece suporte para projetos em todos os idiomas do Visual Studio. e em seguida. Para recursos de arquivo. no menu Project . consulte StronglyTypedResourceBuilder. Selecione a guia Resources. 5. Selecione o recurso que você deseja remover. clique em Remove Resource. Para o Visual Basic. Para informações sobre como acessar recursos através do objeto My. Observe que quando você adicionar o novo arquivo . Selecione um tipo de recurso a partir da lista suspensa Categories. você pode definir opcionalmente as propriedades Encoding e FileType para o arquivo na janela de propriedades.2. Se você clicar duas vezes no novo arquivo .Resources para a pasta de projetos. Isto fornece uma maneira alternativa para consumir recursos. Com um projeto selecionado na Solution Explorer. Visual Studio 285 . aponte para Add Resource. 5. Na caixa de diálogo Add new resource.Resources. os recursos no novo arquivo serão separados dos recursos que você cria usando a página Resource do Project Designer. adicionando arquivo . digite um nome para o novo recurso. Na barra de ferramentas Resource Designer.resx usando Solution Explorer). 2. clique emProperties. o Resource Designer gera recursos fortemente tipado no espaço para nome padrão da pasta de projeto. o Resource Designer gera recursos fortemente tipados no espaço de nome padrão My. Designer de projeto. 4. Selecione a guia Resources. lhe será apresentada uma mensagem perguntando.resx. COMO: adicionar ou remover recursos de seqüência de caracteres Você pode usar o Resource Designer para adicionar ou editar recursos de seqüência de caracteres para o seu projeto Para obter informações sobre como o Resource Designer mantém recursos e informações de Designer. e clique no tipo de recurso que deseja criar. um recurso em tempo de compilação que encapsula o acesso aos recursos criando classes que contêm um conjunto de propriedades estática e somente leitura (get). O recurso será removido do Resource Designer. consulte Página de recursos. será aberta uma janela Resource Designer separada. exibindo as seqüências de caracteres mantidas por essa instância do Resource Designer. 5. 4. Selecione a linha que contém a seqüência de caracteres que você deseja remover clicando no cabeçalho da linha cinza. Value e Comment devem ser separados por tabulações ou a seqüência inteira será adicionada à coluna Name Para adicionar um recurso de seqüência de caracteres 1. 3. os campos Name. insira a seqüência de caracteres a ser usada como um recurso. aponte para a lista suspensa. no menu Project . Para o Visual Basic. Na barra de ferramentas Resource Designer. 3. clique na seta. Os tipos de recursos suportados pelo Resource Designer incluem seqüências de caracteres.Você também pode adicionar recursos de seqüência de caracteres usando a edição arrastar-e-soltar com o Resource Designer. áudio. Na coluna Value. 2. Opcionalmente. Na coluna Name. o Resource Designer gera recursos fortemente tipados no namespace padrão da pasta do projeto. Com um projeto selecionado no Solution Explorer. 2. COMO: Editar Recursos Você pode usar o Resource Designer para adicionar ou editar recursos para o seu projeto. Clique na guiaResources. Designer de projeto. consulte Página de recursos. insira um nome para a seqüência de caracteres. Uma grade de configurações aparecerá. Com um projeto selecionado no Solution Explorer. e arquivos. que está marcada com um asterisco (*). aponte para a lista suspensa. clique na seta. imagens. 6. O Resource Designer é neutro com relação a linguagem e oferece suporte a projetos para todas as linguagens do Visual Studio. digite um comentário na coluna Comment. Na barra de ferramentas Resource Designer. Para obter informações sobre como o Resource Designer mantém os recursos e as informações de designer. Clique na guia Resources. Na barra de ferramentas Resource Designer. Observação Comentários não são compilados no aplicativo. clique em Properties. 4. Para Visual C# e Visual J#. e certifique-se de que ele esteja definido como Strings (que é o padrão). 5. clique em Remove Resource. no menu Project . e certifique-se de que ele esteja definido como Strings (que é o padrão). Clique na coluna Name da última linha da grade. ícones. Ao arrastar e soltar seqüências de caracteres. eles estão disponíveis somente em tempo de projeto. o Resource Designer gera recursos Visual Studio 286 . Para remover um recurso de seqüência de caracteres 1. clique em Properties. fortemente tipados no namespace My. clique na seta e selecione o tipo de recurso que você deseja para editar Selecione o recurso que deseja editar. Observação O editor deve ser capaz de editar o tipo de recurso selecionado.Resources.Resources. no menu Project clique em Properties. clique na seta e selecione o tipo de recurso que você deseja para editar Clique duas vezes no recurso para abrir o editor padrão para aquele tipo de recurso. 5. Para editar um recurso usando o editor padrão 1. Na barra de ferramentas Resource Designer. no menu Project clique em Properties.bmp) pode ser o Visual Studio Bitmap Editor. Você pode abrir qualquer arquivo de recursos em um editor diferente usando o comando Open With. 4. Na caixa de diálogo Open With. Para informações sobre como acessar recursos através do objeto My. aponte na lista suspensa de exibição de recursos. Para mais informações. 3.jpg) pode ser o Windows Paint. Por exemplo. Para mais informações. você não pode editar um arquivo de bitmap em um editor de texto. consulte Acessando Recursos da Aplicação Observação Os procedimentos para recursos de edição de seqüências de caracteres diferem dos outros tipos de recursos. consulte COMO: Associar um editor com um tipo de recurso. O arquivo de recurso é aberto no editor selecionado. Visual Studio 287 . 2. escolha um editor a partir da lista Choose the program you want to use to open this file:. Clique na guia Resources . Cada tipo de recurso é editado usando um editor associado com a extensão de seu arquivo. clique nele com o botão direito do mouse e escolha Open With a partir do menu de contexto. mas o editor padrão para imagens JPEG (. 2. Na barra de ferramentas Resource Designer. Com um projeto selecionado no Solution Explorer. Com um projeto selecionado no Solution Explorer. e você pode alterar o editor padrão de qualquer tipo de recurso. o editor padrão para imagens bitmap (. Para editar um recurso usando um editor diferente 1. 4. 3. aponte para a lista suspensa de exibição de recursos. Clique na guia Resources. consulte COMO: Recursos de Edição de Seqüências de caracteres. por exemplo. clique em Copy (Copiar). Selecione a célula na tabela de seqüências de caracteres que você deseja editar e comece a digitar. Para o Visual Basic. 2. aponte para o modo recurso suspenso. Para o Visual C# e Visual J#. Para informações sobre como acessar recursos através do objeto My. 5. clique na seta. os campos Name (Nome). 3. consulte Página de recursos. Para editar um recurso que é uma seqüência de caracteres 1. Value (Valor) e Comment (Comentário) devem ser separados por tabulações ou a seqüência de caracteres inteira será adicionadas à coluna Name. no menu Project. 3. No menu Edit (Editar). Uma grade de configurações aparecerá. Selecione a linha que contém o recurso que é uma seqüência de caracteres a ser copiado clicando no cabeçalho da linha cinza. que é o padrão). 4. ícones. No menu Edit. copiar. você não pode colar valores individuais ou comentários. imagens. Para obter informações sobre como o Resource Designer mantém recursos e informações do designer. exibindo as seqüências de caracteres mantidas no Resources. 4. consulte Acessando recursos de aplicativos Você pode recortar. clique na seta e certifique-se de que ele esteja definido como Strings (seqüências de caracteres.COMO: Editar recursos que são seqüências de caracteres Você pode usar o Resource Designer (Designer de recurso) para adicionar ou editar recursos para o seu projeto. Visual Studio 288 . e colar recursos que são seqüências de caracteres entre as linhas no editor de seqüências de caracteres. Selecione a guia Resources. 6. no menu Project (Projeto). Os tipos de recursos suportados pelo Resource Designer incluem seqüências de caracteres. e certifique-se de que ele esteja definido como Strings (seqüências de caracteres. clique em Paste (Colar). o Resource Designer gera recursos fortemente tipados no namespace padrão da pasta de projeto. Uma grade de configurações aparecerá. Selecione a guia Resources (Recursos). O Resource Designer é neutro com relação à linguagem e oferece suporte a projetos em todas as linguagens do Visual Studio. Na barra de ferramentas Resource Designer.Resources. Project Designer. aponte para o modo recurso suspenso. clique em Properties (Propriedades). Na barra de ferramentas Resource Designer. entretanto.resx. o Resource Designer gera recursos fortemente tipados no namespace My. que é o padrão).Resources. exibindo as seqüências de caracteres mantidas por essa instância do Resource Designer. Com um projeto selecionado no Solution Explorer (Explorer de Solução). Com um projeto selecionado no Solution Explorer. 2. Ao copiar e colar seqüências de caracteres de uma origem externa. clique em Properties. Para copiar recursos que são seqüências de caracteres 1. áudio e arquivos. no menu Project clique em Properties. o Resource Designer gera recursos fortemente tipados no namespace padrão da pasta do projeto. clique na seta e selecione o tipo de recurso que você deseja editar. Tipos de recurso suportados pelo Resource Designer incluem seqüências de caracteres. Visual Studio 289 . escolha um editor a partir da lista Choose the program you want to use to open this file:.txt no Solution Explorer esse arquivo será aberto no Bloco de notas. 6. Na caixa de diálogo Open With. 4. Para alterar o editor padrão de um tipo de recurso 1. se você definir o Bloco de Notas como o editor padrão para arquivos. áudio. aponte para a lista suspensa de exibição de recurso. o Resource Designer gera recursos fortemente tipados no namespace My. Para o Visual Basic. Com um projeto selecionado no Solution Explorer. e arquivos. COMO: Associar um editor com um tipo de recurso Você pode usar o Resource Designer para adicionar ou editar recursos para o seu projeto. consulte Acessando Recursos da Aplicação Você pode editar cada tipo de recurso usando um editor padrão associado a extensão de seu arquivo. consulte Página de recursos.txt. 2. ícones. 3. e você pode alterar o editor padrão para qualquer tipo de recurso. imagens.bmp) pode ser o Visual Studio Resource Editor. mas o editor padrão para imagens JPEG (. Para obter informações sobre como o Resource Designer mantém os recursos e informações de designer.Resources. ao clicar duas vezes em um arquivo . Observação A configuração de um editor padrão para um tipo de arquivo no Resource Designer também o define como padrão para o Visual Studio.Uma cópia do recurso que é uma seqüência de caracteres será adicionado como uma nova linha na tabela de seqüências de caracteres. clique com o botão direito do mouse e escolha Open With a partir do menu de contexto. Designer de projeto. o editor padrão para imagens bitmap (. Por exemplo. Para Visual C# e Visual J#.jpg) pode ser do Windows Paint. O Resource Designer é neutro à linguagem e oferece suporte a projetos para todas as linguagens do Visual Studio. Na barra de ferramentas Resource Designer. Para informações sobre como acessar recursos através do objeto My. Clique no botão Set as Default. Por exemplo. Você pode abrir qualquer arquivo de recurso em um editor diferente usando o comando Open With.Resources. 5. Clique na guia Resources. Selecione o recurso que deseja editar. Entretanto. os recursos de arquivo são sempre vinculados e não podem ser alterados.resx) entre vários projetos.. você receberá uma mensagem solicitando que você converta o item para um recurso vinculado na ordem para editá-lo. Por exemplo. Mesmo sendo possível ter ambos os recursos. fazer suas modificações em um programa externo.resx. Você não pode editar os recursos incorporados diretamente. a conversão é recomendada mas opcional. Se você tentar editar um recurso incorporado. alterando a propriedade Persistence para o arquivo de recurso. informação de marca. Visual Studio 290 . na maioria dos casos você irá querer escolher uma opção para todos os recursos do seu projeto. Para mais informações. há casos em que os recursos incorporados podem ser uma escolha melhor. consulte HOW TO: Importar ou Exportar Recursos. os dados dos recursos são compilados no arquivo executável. eles podem ser vinculados (o padrão) ou incorporados. e você pode facilmente adicionar ou remover recursos conforme o necessário. os dado dos recursos são armazenados diretamente no arquivo . Recursos Incorporados Os recursos incorporados são a melhor opção se você precisa compartilhar arquivos de recurso do aplicativo (. consulte HOW TO: Criar Recursos Incorporados. em uma representação textual dos dados binários. se você tiver um arquivo de recurso comum que contém os logotipos de sua empresa. vinculados e incorporados. Recursos Vinculados Os recursos vinculados (o padrão) são a melhor opção pela facilidade de uso. usar recursos incorporados significa que você tem apenas que copiar o arquivo . Os recursos vinculados são armazenados como arquivos dentro do projeto. Você deve exportá-los. Escolhendo entre Recursos Incorporados e Recursos Vinculados Na maioria dos casos. Observação Os recursos string são sempre incorporados e não podem ser alterados. Em ambos os casos. etc. Os recursos podem ser editados diretamente dentro do projeto. O arquivo de recursos do aplicativo (.Recursos Vinculados versus Recursos Incorporados Os projetos Visual Studio fornecem duas opções diferentes para manipular recursos. durante a compilação os dados dos recursos são obtidos dos arquivos e colocado no manifesto do aplicativo.resx e não os arquivos de dados de recursos associados. Você pode alterar os recursos de vinculados para incorporados. em um único projeto.resx) armazena somente um caminho relativo ou um link para o arquivo em disco. Com os recursos incorporados. Para mais informações. você deve preferir os recursos vinculados padrão. e depois importá-los de volta para seu projeto. Selecione o recurso que você deseja alterar. no menu Project. clique na seta e selecione o tipo de recurso que você deseja editar. no menu Project (Projeto). 4. 3. convém incorporar os recursos no arquivo de recurso do aplicativo (. aponte para o modo de exibição de recurso suspenso. Clique na guia Resources. Com um projeto selecionado no Solution Explorer (Explorer de Solução). eles são criados como recursos vinculados. recursos que são arquivos são sempre vinculados. você deve exportá-los e editá-los em um programa externo. consulte Recursos vinculados vs.COMO: Criar recursos incorporados Quando você adiciona recursos a um projeto do Visual Studio. aponte para o modo de exibição de recurso suspenso. selecione a propriedade Persistence (Persistência) e altere-a para Embedded in . Clique na guia Resources. 3. Para mais informações. Na barra de ferramentas Resource Designer (Designer de Recurso). Observação Visual Studio 291 .resx e não podem ser alterados para recursos vinculados.resx). incorporados. Em alguns casos. Na janela Properties. Observação Recursos que são seqüências de caracteres são sempre incorporados ao arquivo . Com um projeto selecionado no Solution Explorer. Os recursos podem ser alterados de vinculados a recursos incorporados na página Resources (Recursos) do Project Designer (Designer de Projeto). 2.resx). 4. e em seguida importá-los de volta para o projeto. COMO: Importar ou exportar recursos Você não pode editar recursos incorporados em um projeto do Visual Studio diretamente no IDE do Visual Studio. clique em Properties (Propriedades). 2. Selecione o recurso que você deseja alterar. clique em Properties. selecione a propriedade Persistence e altere-a para Linked at compile time (Vinculado em tempo de compilação). Para alterar um recurso de vinculado para incorporado 1. Na barra de ferramentas Resource Designer. clique na seta e selecione o tipo de recurso que você deseja editar.resx (Incorporado no . Na janela Properties. Para alterar um recurso de incorporado para vinculado 1. 5. 5. aponte para a lista suspensa de exibição de recurso. Selecione a guia Resources. Na barra de ferramentas do Resource Designer. Com um projeto selecionado no Solution Explorer. Observação Este comando só estará disponível para recursos incorporados. As tarefas a seguir podem ser realizadas na página Settings: Visual Studio 292 . 4. navegue até o arquivo que deseja importar. 3. Na caixa de diálogo Import file into resource. clique em Open Gerenciando definições do aplicativo A página Settings do Project Designer é usada para especificar configurações de aplicativo para o seu projeto.Por padrão. Selecione a guia Resources. Na barra de ferramentas do Resource Designer. 5. Observação Este comando só estará disponível para recursos incorporados. você precisa convertê-los explicitamente para recursos incorporados. procure a localidade para onde você deseja exportar o arquivo. Com um projeto selecionado na Solution Explorer. consulte Recursos vinculados versus incorporados. clique na seta e selecione o tipo de recurso que você deseja editar Selecione o recurso que você deseja exportar. Para mais informações. 5. 4. Clique com o botão direito do mouse e escolha Import From File no menu de contexto. 6. no menu Project clique em Properties. no menu Project clique em Properties. 2. e em seguida. Clique com o botão direito do mouse e escolha Export To File no menu de contexto. 2. Para importar um recurso 1. e clique em Save. 6. todos os recursos em um projeto do Visual Studio são criados como recursos vinculados. Na caixa de diálogo Export resource to file. clique na seta e selecione o tipo de recurso que você deseja editar Selecione o recurso que você deseja importar. Para exportar um recurso 1. aponte para a lista suspensa de exibição de recurso. 3. config. Object ou como uma seqüência de conexão. Freqüentemente são dados (como uma seqüência de endereço de conexão) críticos para executar o aplicativo que você não deseja incluir diretamente no código do aplicativo. • Você pode alterar o tipo de uma configuração usando a propriedade Scope. que é criado em tempo de projeto quando você cria a primeira configuração de aplicativo. com base no escopo: • Configurações Application-Scoped podem ser usadas para informações como uma URL para um serviço da Web ou uma seqüência de conexão de banco de dados. O nome pode ser alterado através da propriedade Name. Ou. você pode criar configurações do aplicativo de duas maneiras: com a página Settings do Project Designer ou com a janela Visual Studio 293 . Observe que alterações nas configurações de usuário não são gravadas em disco a menos que o aplicativo especificamente chame um método para fazer isso. o nome pode ser qualquer combinação de letras. para que os usuários não possam alterá-los em tempo de execução. consulte Configurando aplicativos usando propriedades dinâmicas). Cada configuração de aplicativo deve ter um nome exclusivo. Os tipos mais comuns são String. As configurações do aplicativo podem ser armazenadas como qualquer tipo de dados que seja serializável em XML ou que tenha um TypeConverter que implementa ToString / FromString. Esses valores estão associados com o aplicativo. configurações do aplicativo podem ser vinculadas diretamente a uma propriedade de um formulário ou controle em tempo de projeto. e um arquivo user. Para mais informações. Atente ao fato de que configurações do aplicativo são um recurso do Microsoft Visual Studio 2005 que substitui o recurso de propriedades dinâmicas da versão anterior (para informações sobre propriedades dinâmicas. mas você também pode armazenar valores como Color. desde que não seja iniciada com um número e não contenha espaços. Configurações do aplicativo também contém um valor.Configurações de aplicativo Configurações de aplicativos permitem a você guardar e recuperar configurações de propriedades e outras informações da sua aplicação dinamicamente. números ou um sublinhado. Usuários pode alterar esses valores em tempo de execução. e elas permitem manter configuração de aplicativos e usuários personalizadas no computador local. O sistema de projeto armazena as configurações do aplicativo em dois arquivos XML: um arquivo app. Configurações User-Scoped podem ser usadas para informações como lembrar a última posição de um formulário ou uma preferência de fonte. O valor é definido com a propriedade Value e deve corresponder ao tipo de dados da configuração. Integer e Boolean. que é criado em tempo de execução quando o usuário executando o aplicativo altera o valor de qualquer configuração de usuário. Você pode querer armazenar duas seqüências de conexão de banco de dados diferentes e recuperar uma deles em tempo de execução com base na localidade do computador. consulte COMO: Adicionar ou remover configurações de aplicativo. Criar configurações de aplicativo em tempo de projeto Em tempo de projeto. pode preferir armazenar as preferências de cor do usuário para recuperá-las na próxima vez que o aplicativo é executado. Há dois tipos de configurações de aplicativo.config. Além disso. consulte COMO: Adicionar ou remover configurações de aplicativo. Observação de segurança Quando você armazenar seqüências de conexão em app. Na página Settings. Considere usar o recurso Protected Configuration para criptografar informações sigilosas no arquivo de configuração. A exceção é um projeto Visual Studio Tools for Office DLL.Properties para um formulário ou controle.config. Observe que os valores padrão ainda são salvos no app. como um usuário fornecendo uma identificação de usuário e senha.. você pode acessar configurações de aplicativo usando o objeto My. Consulte Protegendo seqüências de conexão para obter mais informações.vb é uma classe parcial. Settings. Acessar ou alterar configurações de aplicativo em tempo de execução no Visual Basic Observação Esta seção se aplica somente a projetos do Visual Basic. Quando você cria uma configuração User-Scoped (por exemplo.vb define a classe Settings. configurações do aplicativo não se aplicam a projetos Class Library. Para obter mais informações sobre como acessar configurações de aplicativo usando o objeto My. Visual Studio 294 . Os valores de quaisquer configurações User-Scoped que o usuário altere em tempo de execução (por exemplo. SettingsLoaded e SettingsSaving Observe que a classe Settings no Settings. Observação Devido ao fato de não haver nenhum modelo de arquivo de configuração para bibliotecas de classe. mostrando apenas o código user-owned (cujo usuário é o proprietário). home page ou tamanho da janela). na seqüência de conexão. Para mais informações. não a classe toda gerada. PropertyChanged. você deve tomar cuidado para garantir que os valores usados para construir a seqüência de conexão não contêm parâmetros adicionais que alterem o comportamento da conexão. consulte Acessando configrações de aplicativo. clique no botão View code para exibir o arquivo Settings. como senhas ou caminhos do servidor.config. a posição do um formulário) são armazenados em um arquivo user. fonte padrão. o Visual Studio a salvará em app. consulte COMO: acessar Settings Events).config com a marca <applicationSettings> (seqüências de conexão são salvas sob a marca <connectionStrings>). uma seqüência de conexão de banco de dados.vb (para obter mais informações. que pode ter um arquivo de configuração. ou uma referência a recursos do servidor). Quando você cria uma configuração Application-Scoped (por exemplo. Em tempo de execução. que permite a você manipular esses eventos na classe de configurações: SettingChanging.config com a marca <userSettings>. você deve tomar precauções para evitar revelar informações sigilosas. permitindo que você possa vincular uma configuração diretamente a uma propriedade.config. o Visual Studio a salvará em app. Se você recebe informações da seqüência de conexão de uma origem externa.Settings.Settings. e deseja redefinir essas configurações para seus valores padrão. Para adicionar configurações de aplicativo na janela Properties 1. que permite a você vincular uma configuração diretamente a uma propriedade.) para abrir a caixa de diálogo New Application Setting. A configuração do escopo pode ser Application ou User. 7. Em tempo de design. Na caixa de diálogo New Application Setting. 6. Clique em uma linha em branco na grade Settings Digite um nome para a configuração na coluna Name.. Para informações sobre este controle. Para adicionar configurações de aplicativo no Project Designer 1. Selecione um formulário ou controle no Form Designer. O nome não pode conter espaços. consulte Página Settings. 7. COMO: Adicionar ou remover configurações de aplicativo As configurações de aplicativo permitem a você armazenar e recuperar configurações de propriedade e outras informações para seu aplicativo dinamicamente. clique no botão Synchronize. no menu Project . clique em Properties. 6. 2. Selecione um projeto no Solution Explorer. com base no escopo: configurações do escopo do usuário e do escopo do aplicativo. clique em Properties Window. O nome não pode conter espaços. selecione a propriedade a qual você deseja adicionar uma configuração de aplicativo..Se você tiver alterado quaisquer configurações User-Scoped em tempo de execução durante testes do aplicativo.. 3. 3. Na lista suspensa para a propriedade. 2. ou utilizando a janela Properties para um formulário ou controle. 5. Selecione um tipo de dados para a configuração na lista suspensa Type. Selecione o escopo da configuração na lista suspensa Scope. expanda a propriedade (Application Settings) (localizada sob o nó Data). clique em (New. por exemplo.. selecione a propriedade Name e digite um nome para a configuração. 4. Project Designer. Selecione o painel Settings. Na caixa de diálogo Application Settings. 5. Insira um valor padrão para a configuração na coluna Value. Há dois tipos de configurações de aplicativo. no menu View. O valor deve ser apropriado para o tipo de dado selecionado. Visual Studio 295 . 4.) para abrir a caixa de diálogo Application Settings. você pode adicionar configurações de aplicativo usando o painel Settings do Project Designer. Selecione a propriedade (Property Binding) e clique no botão de reticências (. Selecione a propriedade DefaultValue e digite um valor padrão para a configuração. Na janela Properties. A configuração do escopo pode ser Application ou User. Os eventos de configuração incluem: • • • • O evento SettingChanging é disparado antes que o valor de uma configuração seja alterado. consulte Acessando configurações de aplicativo Os eventos de configuração podem ser acessados a partir do painel Settings do Project Designer. Pressione a tecla Delete ou clique com o botão direito do mouse e selecione Remove Setting. Observe que depois de ter criado a configuração. A configuração será removida do Project Designer. Na grade Settings. e em seguida clique em OK. COMO: Acessar eventos de configuração Os eventos de configuração permitem que você escreva o código em resposta às alterações de escopo do aplicativo ou do usuário.8. 9. e em seguida. O evento SettingsSaving é disparado antes dos valores de configuração serem salvos. clique em Properties Selecione o painel Settings. clique em Properties. Para acessar eventos de configuração 1. e a nova configuração será adicionada ao Project Designer. O evento PropertyChanged é disparado após o valor de uma configuração ter sido alterado. Selecione o escopo da configuração na lista suspensa Scope. Selecione um projeto no Solution Explorer. A ligação da propriedade será adicionada à janela Properties. 4. no menu Project . Selecione o painel Settings. Selecione um projeto no Solution Explorer. você deve usar o Project Designer para alterá-la. 2. Para vincular a nova configuração à propriedade.config porque o Project Designer não remove quaisquer referências para configurações de aplicativo no código ou em seu próprio código. 3. 2. Observação Será necessário remover configurações manualmente do App. no menu Project . Para informações sobre como programar usando esses eventos. O evento SettingsLoaded é disparado após os valores de configuração serem carregados. clique na linha da configuração que você deseja remover. Visual Studio 296 . Para remover configurações de aplicativo 1. selecione-a na lista suspensa. No menu Project. Clique no botão View code para abrir o arquivo Settings.3. Os tópicos de seções relacionadas se aplicam a propriedades de projeto Visual C# e Visual J#. Observação Acesse as propriedades de um arquivo individual na janela Properties. Os tópicos nesta seção se aplicam especificamente a projetos Visual C# e Visual J# . Para mais informações. selecione o projeto. consulte Introdução ao Project Designer. como e onde ele é publicado. Gerenciando propriedades de projeto C# e J# Você pode usar o Project Designer para definir propriedades em projetos Visual C# e Visual J# . 4. Como definir propriedades do projeto (C#. Para definir as propriedades do projeto no Project Designer 1. as configurações são confirmadas para o arquivo do projeto somente quando você seleciona uma das opções de salvamento ou quando você fecha o designer. escolha Import and Export Settings no menu Tools. e quaisquer configurações de segurança a serem usadas.cs no editor de códigos. Defina as propriedades. clique em <Project Name> Properties. Todas as alterações de propriedade terão efeito imediato no projeto ativo. bem como propriedades de projeto Visual Basic. entretanto. Para mais informações. Observação O Project Designer não possui botões OK ou Cancel. Para exibir ou alterar suas configurações. consulte Configurações do Visual Studio. ou salvas. Visual Studio 297 . Esta página de Ajuda foi escrita baseada na idéia de General Development settings. J#): Propriedades de um projeto especificam como um projeto é criado e depurado. Use o Project Designer para definir as propriedades do projeto. 2. Esse arquivo define métodos que manipulam os eventos disparados quando as configurações de usuário são alteradas. 3.vb ou Settings. Observação As opções disponíveis na caixas de diálogo e os nomes e locais de comandos de menu que você vê podem ser diferentes das que são descritas na Ajuda dependendo das suas configurações ativas ou edição. No Solution Explorer. Definindo propriedades usando o Project Designer Você pode exibir as configurações de propriedades no Project Designer quando você seleciona o projeto no Solution Explorer. carregadas. Selecione o nome da página de propriedades a ser alterada ou visualizada. bem como que bibliotecas ele referencia. No Solution Explorer. Reference Path (C#. COMO: Definir o Caminho de Referência (C#. selecione o projeto. 3. Visual Studio 298 . No menu Project. Observação Se a referência para a assembly não estiver no projeto ou listada no painel Reference Paths do Project Designer. consulte Configurações Visual Studio. Você pode adicionar quantos caminhos de referência forem necessários. Para mais informações. dependendo da sua edição ou configuração ativa. selecione o projeto. Para exibir ou alterar as configurações. Para mais informações. você pode usar mais de uma instância do Project Designer ao mesmo tempo. Se você tiver uma solução de multiprojeto. Clique em Add Folder. Se você usar uma assembly não localizada no diretório do projeto. Elas são exibidas somente para fins informativos. Visual Studio primeiramente procurará a assembly no diretório do projeto. clique em <Nome do Projeto> Properties. Para procurar a pasta. especifique o caminho para a pasta contendo módulos (assemblies). Observação O procedimento para definir o caminho de referência para projetos Visual Basic é ligeiramente diferente. Na caixa de texto Folder. J#) Quando você faz referência a uma assembly em seu projeto. Clique em Reference Paths. consulte COMO: Adicionar ou Remover Referências no Visual Studio.Observação Propriedades que estão cinza são definidas em outros painéis de propriedades. Para definir um caminho de referência 1. Esta página Ajuda foi escrito com as General Development settings em mente. você pode especificar sua localidade na Página Project Designer. 4. 2. No Solution Explorer. o Visual Studio verifica as pastas exibindo os arquivos na Caixa de Diálogo Add Reference. J#) do Project Designer. escolha Import and Export Settings no menu Tools. clique nas reticências (…). 5. Para substituir um caminho de referência 1. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais de comandos de menu você vê podem ser diferentes dos que são descritos na Ajuda. 5. 3. J#) Usando o Build Pane e o Build Events Pane do Visual Studio Project Designer. Você pode definir as opções do compilador. 3. 4. 3. Clique em Reference Paths. selecione o projeto. Veja Página de Compilação.2. Para mais informações. 5. J#) para obter mais informações sobre como usar o Project Designer para selecionar os eventos de pré e pós-compilação. Depuração ou compilação de Versão Final. Na caixa de texto Folder. Para acessar e modificar as propriedades de compilação 1. No menu Project. consulte Configurações do Visual Studio. 6. 4. No menu Project. Para remover um caminho de referência 1. 2. No Solution Explorer. Na caixa Reference Path. No menu Project. Para exibir ou alterar as configurações. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. Selecione a guia Build. O caminho selecionado na caixa Reference Path é sobrescrito pelo caminho especificado na caixa de texto Folder. Na caixa Reference Path. clique em <Nome do Projeto> Properties. Visual Studio 299 . No Solution Explorer. especifique a sua configuração: Ativa (Depuração). os eventos de pré-compilação e os eventos de pós-compilação a partir do Project Designer. 2. Consulte COMO: Especificar Eventos de Compilação (C#. clique nas reticências (…). Clique em Remove. selecione o projeto para o qual você deseja especificar o evento de compilação. Página de Compilação. Project Designer (J#) e Eventos da Página de Compilação. dependendo de suas configurações ativas ou da edição. Project Designer (C#. escolha Import and Export Settings no menu Tools. COMO: Definir as Propriedades de Compilação (C#. J#) para obter mais informações. selecione o caminho para sobrescrever. Clique em Update. 4. Por padrão. Esta página de Ajuda foi escrita com o General Development settings como base. você pode especificar as configurações e os eventos de compilação para controlar a configuração de compilação e a compilação do seu projeto. especifique o caminho para a pasta contendo módulos (assemblies). A partir da lista Configuration. selecione o caminho para remover. Project Designer (C#). Para procurar o caminho. esta opção é definida como Ativa (Depuração). Clique em Reference Paths. clique em <Project Name> Properties. clique em <Nome do Projeto> Properties. Para adicionar uma referência de projeto 1. Selecione a guia indicando o tipo de componente que você deseja referenciar. 4. clique em Properties no menu Project. Visual Studio 300 . Clique em OK depois que você tiver selecionado todos os componentes necessários. Consulte Caixa de Diálogo Advanced Build Settings (C#) ou Caixa de Diálogo Advanced Build Settings (J#) para obter mais informações. Esta caixa de diálogo pode ser acessada a partir do menu Project. 2. consulte Caixa de diálogo Add Reference. Com um projeto selecionado no Solution Explorer. acessível da página Compile do Project Designer. Pressione e segure a tecla CTRL enquanto clica para selecionar vários componentes. No Solution Explorer. você pode localizá-lo usando o botão Browse. Clique na guia Compile. Dica Se o componente que você estiver procurando não estiver na lista. eventos post-build ocorrem após a compilação. COMO: Adicionar e remover referências no Visual Studio (C#. No menu Project.5. Eventos de compilação são especificado na caixa de diálogo Build Events. escolha Add Reference. Para especificar eventos de compilação 1. 3. As referências selecionadas serão exibidas sob o nó References do projeto. A caixa de diálogo Add Reference é aberta. Clique no botão Build Events para abrir a caixa de diálogo Build Events Insira os argumentos de linha de comando para a ação pre-build ou postbuild. J#) A caixa de diálogo Add Reference pode ser usada para adicionar ou excluir referências de projeto. Para mais informações. 4. macros ou outras ações como parte do processo de compilação. selecione o componente que você deseja referenciar. 5. 3. No painel superior. e depois clique no botão Select. COMO: Especificar eventos de compilação Eventos de compilação no Visual Basic podem ser usados para executar scripts. incluindo quaisquer configurações avançadas. 2. e clique OK. Eventos pre-build ocorrerão antes da compilação. selecione o projeto. Defina as propriedades de compilação restantes. Arquivos de projeto são instalados no computador cliente com arquivos de suporte necessários. Outro fator é a divisão de carga. Processamento é feito principalmente no servidor. um modelo de projeto local é a melhor opção. Você pode instalar e executar este projeto no servidor sem instalar arquivos de suporte em cada cliente. O aplicativo é executado localmente em o computador cliente. atualizações pode ser concluída em cada computador cliente individual. O computador cliente utiliza um navegador da Web para enviar informações para e exibir informações do aplicativo do servidor. Projeto local Arquivos projeto são armazenados no computador local. Criar modelo ao desenvolver Código de aplicativo é compilado como uma DLL e Código é compilado e executar no servidor. e fazer atualizações somente em servidor. Entretanto. No nesse cenário. cliente. O trabalho pode ser feito no computador cliente sem consumindo hora servidor precious. Resultados são visto no executado no computador computador cliente. e selecione Remove no menu de atalho. Quando Analisando estrutura do seu aplicativo. considere usando um modelo de projeto local para seu aplicativo. Se você precisar um aplicativo Quick-deploying em um servidor com a configuração do cliente mínima. Se os recursos do servidor estão limitados. Primeiro. Método de implantação Carga de trabalho Computadores cliente executar o aplicativo remotamente com um navegador da Web. para projetos que têm pouca envolvimento servidor ou para aplicativos autônomos. Visual Studio 301 . estratégia instalação devem desempenhar um papel no sua decisão geral. o modelo de projeto da Web é melhor. você precisa considerar a maior do trabalho para onde está indo a ser feito. clique com o botão direito do mouse na referência sob o nó References.Para remover uma referência de projeto • No Solution Explorer. O projeto também mantém um cache temporário de arquivos em computadores cliente para trabalhar off-line. Projetos da Web oferecem uma estratégia servidor onde a maioria das operações são conduzidas no servidor. A tabela a seguir fornece uma comparação lado a lado de projetos da Web e projetos no design e ambientes de trabalho local: Consideração Armazenamento de arquivos durante o desenvolvimento Projeto da Web Os arquivos são armazenados em um URL especificado em um computador com Serviços de Informações da Internet (IIS) instalado. Local e projetos da Web Não há vários fatores a considerar quando você decide se usar um local ou modelo do projeto da Web para seu aplicativo. O projeto é implantado em um servidor Web. Um exemplo é um arquivo texto que contém documentação. O arquivo é compilado para a saída de compilação. • • • O valor padrão para BuildAction depende da extensão do arquivo que você adicionar à solução.vb ou . e CustomToolNamespace são fornecidas para cenários avançados. Este arquivo é incorporado à saída de compilação do projeto principal como uma DLL ou executável.htm ou outro tipo de arquivo da Web. BuildAction. você pode definir propriedades de arquivo para indicar se um arquivo deve ser compilado ou incorporado à saída da compilação como um recurso Você pode selecionar qualquer arquivo no Solution Explorer e depois examinar suas propriedades na janela Properties. e CustomToolNamespace.resx associados a ele. em computadores cliente. como por exemplo um arquivo leiame. CustomTool. Os valores padrão são normalmente suficientes e não precisam ser alterados. O arquivo não é incluído no grupo de saída do projeto e não é compilado no processo de compilação. O comando Copy Project é usado para mover arquivos para o URL especificado. Ele é normalmente usado para arquivos de recurso. BuildAction pode ter um dos vários valores: • None. Arquivos do Visual Basic e Visual C# têm quatro propriedades: FileName. Observe que se você alterar o nome do arquivo. clicando na propriedade Propriedade FileName (Extensões para VB e CSharp) na janela Properties e digitando o novo nome. Observação As propriedades BuildAction. se você adicionar um projeto do Visual Basic ao Visual Studio 302 . Embedded Resource. Propriedade FileName Você pode renomear um arquivo. Movendo arquivos projeto Propriedades de arquivo Você pode usar propriedades de arquivo para indicar quais ações o sistema do projeto deve executar nos arquivos. CustomTool. O arquivo não é compilado. o Visual Studio automaticamente renomeará qualquer arquivo . essa configuração é o valor padrão para um arquivo . mas é incluído no grupo de saída de conteúdo. Por exemplo. Compile. Por exemplo. Content. Essa configuração é utilizada para arquivos de código. Propriedade BuildAction A Propriedade BuildAction (Visual Basic e C# ProjectItem Object) indica o que o Visual Studio faz com um arquivo quando uma compilação é executada. Por exemplo.Atualizar Alterações de aplicativo são feitas no nível do As atualizações de servidor sem instalação dos arquivos de suporte em aplicativos são instalados computadores clientes. Fisicamente arquivos projeto são copiados de uma localidade para outro. MeuArquivo. Se o arquivo for um arquivo . onde namespace é o valor da propriedade DefaultNamespace em um projeto do Visual C# ou da propriedade RootNamespace em um projeto do Visual Basic. se você adicionar o arquivo MeuArquivo.resx. Observe que.exe é baseada somente em soma de verificação. Visual Studio 303 .exe no arquivo. Nomearquivo e extensão permanecem os mesmos que suas designações originais. você não deve alterar esta configuração para Embedded Resource. ou Copy if newer se o arquivo deve ser copiado somente quando ele for mais recente que um arquivo existente com o mesmo nome no diretório de saída.resources criado a partir do arquivo . O arquivo .resource será incorporado ao assembly.dll e . Selecione Do not copy se o arquivo não deve ser nunca copiado para o diretório de saída. quando o editor de recursos adiciona uma imagem. portanto o manifesto do assembly fará referência ao arquivo . o sistema do projeto executará resgen. porque o arquivo .extensão. uma comparação de soma de verificação é feita. e MeuProjeto. porque fazer isso deverá incluir a imagem duas vezes no assembly. Para obter mais informações sobre como acessar arquivos de recurso (compilados a partir de arquivos .nomearquivo. Se as somas de verificação forem diferentes. MeuProjeto. o valor padrão para BuildAction é Compile. consulte Método Assembly.resx.dll ou . a imagem é colocada no arquivo . Se você depois adicionar o arquivo MeuArquivo. o arquivo é copiado. A imagem pode depois ser facilmente acessada através da classe fortemente tipada auto-gerada para o arquivo . o arquivo é copiado. criando um arquivo .bmp será o identificador no manifesto do assembly. consulte Classe ResourceManager.GetManifestResourceStream. Nomes e extensões de arquivos aparecem no Solution Explorer. ele configura Build Action como None. Propriedade CopyToOutputDirectory Esta propriedade especifica as condições sob as quais o arquivo de origem selecionado será copiado para a pasta de saída.exe é determinada comparando as versões Win32 da seguinte maneira: Se a versão do lado do dispositivo for menor do que a da área de trabalho.vb indica um arquivo de código que pode ser compilado. Se as versões forem iguais. e definir a ação de compilação como Embedded Resource. A renovação dos arquivos diferentes de .resx referencia o arquivo de imagem. o arquivo não é copiado. porque a extensão .Solution Explorer.resx.resource. Para obter mais informações sobre como acessar todos os outros arquivos incorporados e recursos em tempo de execução.resources será o identificador no manifesto do assembly.resx. Se a versão do lado do dispositivo for maior do que a da área de trabalho. Se as somas de verificação forem iguais. a renovação de um arquivo .MeuArquivo. Por exemplo.resx) em tempo de execução. a ação de compilação padrão será Embedded Resource.resources e não ao arquivo . Copy always se o arquivo deve ser sempre copiado para o diretótio de saída.resx ao projeto. Observação Em projetos de dispositivo inteligente. O identificador será namespace. o arquivo não é copiado. Portanto. Em tempo de compilação. Observe que o nome do arquivo no seu projeto não será o identificador para o recurso gerenciado no manifesto do assembly (consulte Manifesto do assembly para obter mais informações).bmp a um projeto cujo namespace padrão é MeuProjeto. Existe uma lista pré-definida de ferramentas personalizadas disponíveis no produto. uma ferramenta personalizada pode ser um gerador de código de DataSet que lê um arquivo de esquema XML (. Os itens de projeto.xsd) como entrada. Para obter mais informações. Visual C#. pode ser necessário que você altere o valor dessa propriedade. em um projeto Visual C# (indicado por . O valor desta propriedade deve estar em branco ou ser uma das ferramentas personalizadas internas. isto é. consulte COMO: Adicionar novos itens de projeto. Por exemplo. ou em um projeto Visual J# (indicado por . e gera classes em um arquivo de código que programaticamente expõem suas tabelas e colunas. e para o Visual C# isso corresponde à configuração da propriedade Propriedade DefaultNamespace (Visual Basic e C# Project Object) para a pasta.jsl). As seguintes tabelas listam os itens de projeto disponíveis para projetos locais e projetos da Web. diferenciam-se dependendo se você estiver trabalhando em um projeto local ou em um projeto da Web. código gerado será colocado no namespace padrão para a pasta na qual o arquivo convertido reside. Se a propriedade estiver vazia. este é o namespace raiz do projeto. o código gerado pela ferramenta será colocado no namespace especificado.vb). clique na propriedade Propriedade CustomTool (Visual Basic e C# ProjectItem Object) na janela de propriedades e digite o nome de uma ferramenta personalizada. Para outros itens de projeto. e Visual J# Itens de projeto referem-se aos tipos de arquivos que você adiciona a um projeto. Observe que para alguns itens de projeto. Tipos de arquivos e extensões de arquivos no Visual Basic. Adicionando itens de projeto A caixa diálogo Add New Item é acessada através do menu Project. a extensão de arquivo não faz distinção entre um projeto Visual Basic. há apenas uma extensão possível para o item de projeto. a extensão de arquivo é diferente. Em raras circunstâncias. Visual Studio 304 .cs). consulte Projetos locais e da Web e Tour guiado de como se criar sites da Web no Visual Studio. a propriedade Propriedade CustomToolNamespace (Visual Basic e C# ProjectItem Object) permite que você especifique o namespace que você deseja atribuir ao código gerado pela ferramenta personalizada. Quando você especificar um valor para a propriedade CustomToolNamespace. Para obter mais informações sobre como adicionar itens ao seu projeto. para o Visual Basic. disponíveis para você. dependendo se o item aparece em um projeto Visual Basic (indicado por . um projeto Visual C#.Propriedade CustomTool Ferramentas personalizadas são componentes que podem ser usados para transformar arquivos de um tipo em outro em tempo de design. Propriedade CustomToolNamespace Se você tiver uma ferramenta personalizada atribuída ao seu projeto. esta propriedade permite que você veja qual ferramenta personalizada é aplicada a um arquivo. e um projeto Visual J#. Para definir ou alterar a ferramenta personalizada. jsl ou .vb ou .xsd Uma classe para criar componentes usando o visual designer.vb ou .cs ou .jsl ou . consulte Classes no Common Type System.cs ou . Dialog Um diálogo para aplicativos baseados no Windows.java .vb ou .vb ou .cs ou .java .cs ou .java . Uma classe para criar um controle de Windows Form usando o visual designer.cs ou .java .vb ou .java .java . Interface Module (Visual Basic somente) Component Class Um arquivo para armazenar grupos de funções.jsl ou .cs ou . User Control Windows Service DataSet Visual Studio 305 .java . consulte COMO: Criar serviços do Windows. Para mais informações. consulte Gravando informações de esquema de DataSet como esquema XML (XSD).Itens de projeto locais Extensão de arquivo . Uma classe para criar serviços do Windows.jsl ou .cs ou .jsl ou .jsl ou .vb ou .java .jsl ou .jsl ou .cs ou . Class Um arquivo de código que contém uma declaração de classe.vb ou . Um formulário de caixa de diálogo About para aplicativos baseados no Windows Um formulário de logon para coletar um nome de usuário e senha. .vb ou . Um arquivo para criar um esquema XML com classes DataSet. Para mais informações.vb ou .vb ou . Um formulário para um aplicativo de interface de documentos múltiplos.vb ou . Uma nova interface.jsl ou .cs ou .jsl ou . Para mais informações.cs ou .java .java .jsl ou . MDI Parent Form About Box Login Form Splash Screen Um formulário pré-configurado para ser usado como tela inicial. Para mais informações.vb Item de projeto Windows Form Finalidade do item de projeto Um formulário para criar aplicativos baseados no Windows.java .jsl ou .cs ou . Explorer Form Um formulário do Explorer com modo de exibição de árvore e controles de navegação.vb ou .java .cs ou . consulte Classes de componente. consulte COMO: Autorar controles para Windows Forms.cs Transactional Component Arquivo de texto XSLT File Installer Class .java COM Class .cs .jsl ou . Para mais informações.SQL Database XML File .vb ou . Para mais informações.vb ou .txt . Para mais informações. Visual Studio 306 . Uma classe para ser chamada no momento da instalação.settings . consulte Herança visual do Windows Forms. consulte Interoperabilidade COM em aplicativos do . Um arquivo para criar um esquema de documentos XML.vb ou . Para mais informações.cs ou . Para mais informações. XML Schema .java Inherited User Control Web Custom Control . consulte Controles de servidor da Web do ASP.cs ou .xml Um banco de dados SQL vazio para dados locais. consulte Introdução a esquemas XML (XML Designer).cs ou .NET (Visual Studio). Um arquivo XML em branco. Uma página HTML que pode incluir código do lado do cliente. Uma classe que pode ser exposta ao COM. Um arquivo de código em branco.cs ou . Um arquivo usado para transformar documentos XML.vb ou . HTML Page .vb ou . Para mais informações.java . consulte COMO: Herdar de controles Windows Forms existentes.vb ou .jsl ou .NET.jsl ou . Uma classe para uso com componentes transacionais. Um novo formulário baseado em um formulário existente.jsl ou .xslt .cs ou . Uma classe para criar um controle de servidor ASP.vb ou .java Um arquivo de texto vazio.mdf . Um arquivo de configurações do usuário em branco. consulte Modo de exibição Design.xsd Settings File Code File .NET Framework.jsl ou .cs ou .htm Inherited Form . consulte Usando componentes de instalação.jsl ou .java Custom Control Uma classe para criar um controle de Windows Forms de usuário. Para mais informações.java . consulte Designer de esquema XML (XML Designer). Um novo controle baseado em um controle Windows Forms existente. Para mais informações.vb ou . Para mais informações. Para mais informações.cs para Visual C# ou . Um arquivo usado para definir configurações de aplicativo. Um arquivo contendo script que é executado como um programa do Windows.ico Resources File .cs ou .bmp Cursor File . consulte Assemblies na Common Language Runtime.resx Assembly Information File Application Configuration File Debugger Visualizer Class Diagram Report JScript File . Para mais informações. consulte Recursos em aplicativos.cur Icon File .rdlc . consulte Arquivos de configuração.vbs Windows Script Host . e . Para mais informações. Para mais informações. consulte Ícones.jsl ou . Para mais informações.rpt Um arquivo Crystal Report que publica dados para um Windows form. consulte Criação de cursores.jsl Visual Studio 307 .jsl . Para mais informações.js Um diagrama de classe. Um arquivo de script que contém código JScript. Um arquivo de imagem de bitmap em branco que pode ser usado para criar imagens simples.java .wsf Itens de projeto da Web Extensão de Item de projeto arquivo Web Form Finalidade do item de projeto Dois arquivos: . Para mais informações. consulte Guia de Introdução do JScript.vb ou . Para mais informações. Um arquivo para criar cursores personalizados. Um arquivo de script que contém código VBScript. consulte Usando arquivos de script do Windows (.cs ou .config .wsf). Um novo relatório vazio. Um formulário para criar aplicativos da Web. Um arquivo contendo informações de assembly gerais. Um arquivo usado para editar e definir recursos de aplicativo. Um arquivo de imagem para criar um ícone personalizado.vb ou . VBScript File . Um simples visualizador depurador Bitmap File .cd .Crystal Report .vb para Visual Basic ou .aspx. consulte Guia do Usuário do VBScript. XML. consulte COMO: Criar folhas de estilo em cascata externas (Visual Studio). Um arquivo usado para editar e definir recursos de aplicativo. O nome do arquivo é global. e . consulte Designer de esquema XML (XML Designer). consulte Assemblies na Common Language Global Application Class .para Visual J# Master Page Web User Control HTML Page .NET usa este arquivo para definir as configurações da Web para um projeto da Web. Para mais informações.master .jsl .xsd XSLT File Text File Assembly Resource File Assembly .xml XML Schema .cs ou .css Class Style Sheet Um arquivo de código que contém uma declaração de classe. Às vezes chamado de arquivo asax. Um componente que fornece a capacidade de trocar mensagens interoperáveis usando protocolos padrões. Um arquivo usado para transformar documentos XML. O ASP. Para mais informações. o qual você não pode alterar. Para mais informações. .cs ou .asmx.cs para Visual C# ou . Para mais informações. o qual você não pode alterar.jsl Visual Studio 308 .htm Web Service Dois arquivos: .jsl para Visual J# .asax.NET. Para mais informações. Para mais informações. Para mais informações.ascx Uma página mestre para aplicativos da Web. Um arquivo para criar um esquema de documentos XML.vb para Visual Basic ou . Um arquivo XML em branco. Uma folha de estilo em cascata usada para definições de estilo HTML. Um arquivo de texto vazio.config . tais como HTTP. esse arquivo permite que você escreva código para manipular eventos globais a nível de aplicativo do ASP. tais como Session_OnStart e Application_OnStart.vb ou . consulte Recursos em aplicativos.config.NET criado usando o visual designer. Um arquivo contendo informações de assembly gerais.asax Web Configuration File XML File .xslt .resx . O nome do arquivo é Web. Uma página HTML que pode incluir código do lado do cliente.vb ou . Um controle de servidor do ASP.txt . consulte Modo de exibição Design. XSD. SOAP e WSDL. consulte Criando XML Web services em código gerenciado. consulte Introdução a esquemas XML (XML Designer). ashx . Um arquivo de script que contém código VBScript. Um arquivo de script que contém código JScript.ascx Mobile Web Configuration File . Para mais informações. Para mais informações. consulte Guia de Introdução do JScript.skin .NET criado usando o visual designer e usado em um aplicativo da Web para dispositivos móveis.xsd Runtime. Um arquivo de código vazio usado para scripts do Windows.sitemap . O ASP.wsf Host Skin File Browser File Report . Para mais informações. Uma página para implementar um manipulador genérico Generic Handler Site Map Mobile Web Form .NET para dispositivos móveis. Mobile Web User Control .js Windows Script . Para mais informações. O nome do arquivo é Web.browser . Um banco de dados SQL vazio para dados locais.mdf . consulte Introdução a aplicativos de serviço do Windows.NET usa este arquivo para definir as configurações de um projeto da Web para dispositivos móveis. Um formulário para criar aplicativos da Web móveis. Para mais informações.rdlc Visual Studio 309 . Um controle de servidor ASP. o qual você não pode alterar. Um arquivo usado para definir um tema do ASP.NET para dispositivos móveis. Um arquivo para criar um esquema XML com classes DataSet.aspx Um arquivo usado para criar um mapa do site. Um arquivo Crystal Report que publica dados para um Web Form.NET para dispositivos móveis. consulte Gravando informações de esquema de DataSet como esquema XML (XSD).config Crystal Report .config. Para mais informações.rpt VBScript File .vbs JScript File . consulte Criando aplicativos da Web do ASP.NET.Information File SQL Database DataSet . consulte Criando aplicativos da Web do ASP. Para mais informações. Um arquivo para configurar definições de navegador Um novo relatório vazio. consulte Guia do usuário do VBScript. consulte Criando aplicativos da Web do ASP. Uma classe para ser chamada no momento da instalação. Para mais informações.jsl Code File Static Discovery File . Para mais informações. ícones nas caixas de diálogo New Project e Add Project representam os tipos de projeto disponíveis e seus modelos. . Para informações como criar um arquivo de descoberta para seu XML Web service.Module (Visual Basic somente) Component Class Data Form Wizard Frameset .vb ou . Um arquivo opcional que atua como um mecanismo de descoberta para o XML Web service.cur Icon File .cs Uma classe para criar componentes usando o visual designer. Para mais informações. Um arquivo para criar cursores personalizados. Um arquivo de código em branco. Um arquivo de imagem de bitmap em branco que pode ser usado para criar imagens simples.bmp Cursor File .vb Um arquivo para armazenar grupos de funções.jsl Bitmap File .disco Installer Class .vb ou . Um arquivo de imagem para criar um ícone personalizado.disco não é criado automaticamente para um XML Web service. .vb ou . consulte Controles de servidor da Web do ASP. Para mais informações. Modelo de Usado para criar Visual Studio 310 . consulte Criação de cursores. Web Custom Control . consulte Introdução a conjuntos de quadros. A tabela a seguir lista os tipos padrão de projetos disponíveis no Visual Studio.NET (Visual Studio). consulte Ícones.cs ou .cs ou .vb ou .cs para projetos locais) .NET. Para mais informações.aspx (.jsl . O modelo de projeto que está associado ao ícone de projeto de sua escolha determina o tipo de saída e outras opções disponíveis para o projeto. O arquivo . Um arquivo HTML que hospeda múltiplas páginas HTML. Uma classe para criar um controle de servidor do ASP. consulte Usando componentes de instalação.htm Um formulário de dados para aplicativos da Web.cs ou .ico Modelos de projeto padrão no Visual Studio Quando você criar um novo projeto.vb ou . consulte COMO: Ativar descoberta para XML Web services. Para mais informações.0. Observação Visual Basic Esse tipo de projeto é parecido com o projeto ActiveX Control no Visual Basic 6. arquivos. Observação Visual Basic Isso substitui o modelo de projeto Standard EXE no Visual Basic 6. Visual Studio 311 . consulte Controle de criação de formulários do Windows. Para mais informações. Modelo de Biblioteca de controle do Windows Modelo de serviço do Windows Controle personalizado para usar em formulários Windows. Para mais informações. Windows Service Applications (anteriormente chamadas " NT services") podem monitorar itens como o desempenho do sistema. consulte Criando aplicativos Windows. consulte Introdução aos aplicativos de serviço do Windows. você pode usar este procedimento para restaurá-los sem reinstalar o Visual Studio. Esse tipo de projeto é considerado sem janelas e não conterá uma classe de formulários Windows. O modelo cria a estrutura de arquivo necessário para armazenar vazio informações de aplicativo. quaisquer referências. Interface de aplicativos que executam por muito tempo e não têm uma interface de usuário. COMO: Restauração de modelos de projeto padrão Se você acidentalmente excluir os modelos de projeto padrão que são incluídos com o Visual Studio. Modelo de Biblioteca de controle da Web Controle personalizado que pode ser usado em páginas de formuláiros Web. ou componentes devem ser adicionados manualmente. consulte Classes de componentes. Modelo de Aplicação de console Modelo do Projeto Um projeto vazio. Modelo de aplicativos do Windows Aplicativo Windows autônomos tradicional ou um rico front-end para aplicativo Web distribuído. Aplicativo de linha de comando. Para mais informações.0.projeto Modelo Biblioteca de classe Classes reutilizáveis ou componentes que podem ser compartilhados com outros projetos. Modelo Empty Project O modelo Empty Project pode ser usado quando você desejar criar seu próprio tipo de projeto. Modelo de aplicativo de console O modelo de projeto Console Application adiciona os itens necessários para criar um aplicativo de console. consulte Component Classes. Digite "devenv /installvstemplates" e pressione ENTER. As informações podem ser escritas e lidas da janela do console. 2. Observação Se você estiver usando um Visual Studio Express Edition. Aplicativos de console são normalmente criados sem uma interface gráfica do usuário e são compilados em um arquivo executável autônomo. respectivamente. Na linha de comando. VB ou VCS para Visual J#. As referências. consulte Adicionando e removendo referências. reinstale o Visual Studio. arquivos ou componentes devem ser adicionados manualmente. 3. digite "<ExpressName>Express /installvstemplates". Um aplicativo de console é executado a partir da linha de comando com informações de entrada e saída sendo trocadas entre o prompt de comando e o aplicativo em execução. Para obter mais informações sobre como adicionar referências. O modelo adiciona automaticamente as referências de projeto essenciais e arquivos para serem usados como um ponto de partida para o seu aplicativo. O modelo adiciona automaticamente arquivos e referências ao projeto essencial. Visual Basic e Visual C#. Se esse procedimento não restaurar os modelos padrão. onde <ExpressName> é VJS. Modelo Class Library Você pode usar o modelo Class Library para criar rapidamente. Para obter mais informações sobre como criar classes de componentes. tornando o aplicativo de console uma excelente maneira para se aprender novas técnicas de programação sem precisar se preocupar com a interface do usuário.exe. O modelo cria a estrutura de arquivos necessária para armazenar as informações do aplicativo. Visual Studio 312 .Para restaurar os modelos de projeto padrão 1. classes e componentes reutilizáveis que podem ser compartilhados com outros projetos. navegue para a localidade onde está o devenv. Este arquivo está localizado em <Visual Studio Installation Path>\Common7\IDE. NET. Modelo de Serviço do Windows O modelo de serviço do Windows adiciona os itens necessários para criar um aplicativo de serviço do Windows. consulte Criando um Projeto de Aplicativo Windows. consulte Controles de formulários do Windows. Visual C# e Visual J# representa a base para um aplicativo Windows padrão. O modelo adiciona automaticamente as referências e arquivos essenciais para o projeto usar como um ponto de partida para seu aplicativo. consulte Introdução aos aplicativos de serviço do Windows. O modelo automaticamente adiciona as referências essenciais e arquivos do projeto para usar como um ponto de partida para seu aplicativo. Para mais informações. O modelo adiciona automaticamente as referências de projeto essenciais e arquivos para serem usados como um ponto de partida para seu aplicativo. os métodos e os eventos de um objeto definido e aplicá-los em seu programa. Modelo de Aplicativo Windows O modelo de projeto do Aplicativo Windows em Visual Basic. Para mais informações. remover e gerenciar as referências existentes. Os tópicos a seguir contêm uma visão geral das referências no Visual Basic e Visual C# e fornecem instruções sobre como adicionar. Para obter mais informações sobre como criar um aplicativo Windows. um aplicativo executável demorado que é executa em sua própria sessão do Windows. consulte Visão geral de controles de servidor Web do ASP.Modelo de biblioteca de controles da Web Você pode usar o modelo de projeto Web Control Library para criar controles de servidor Web personalizados. Modelo de Controle de Biblioteca do Windows O modelo do projeto de controle de Biblioteca do Windows é usado para criar controles personalizados para usar em formulários Windows. O modelo adiciona automaticamente as referências e arquivos essenciais do projeto para usar como ponto de partida para o seu aplicativo. Referenciando Namespaces e Componentes Referências de projeto são usadas para acessar as propriedades. O modelo adiciona os itens de projeto necessários para começar a criar um controle que pode ser adicionado a qualquer projeto da Web. Para mais informações. Visual Studio 313 . Para mais informações.0. Por padrão. o componente não será implantado com o aplicativo. você pode criar referências a objetos criados em outro projeto que reside na mesma solução. Para mais informações.Referências de projeto Para escrever código contra um componente externo. o valor é definido como true. A propriedade CopyLocal indica se esta cópia precisa ser feita. um erro de exceção é gerado. independentemente da configuração CopyLocal. Referências de projeto-a-projeto são sempre definidas como true. componentes devem estar em um dos dois locais: no caminho de saída do projeto ou no cache global de assemblies (GAC). A incapacidade de localizar o componente referenciado é o disparador Visual Studio 314 .0. a referência é copiada. Referências de projeto-a-projeto Em uma solução com vários projetos. Referências a componentes compartilhados Em tempo de execução. Observação do Visual Basic Referências de projeto são gerenciadas de modo diferente no Visual Studio do que como eram no Visual Basic 6. Uma referência pode ser feita aos seguintes tipos de componentes: • • • • Bibliotecas de classes do . Isso coloca todo código personalizado sob exame detalhado. consulte Referências da Web. você poderia definir a propriedade CopyLocal em uma referência para garantir que o assembly fosse implantado.NET Framework ou assemblies Componentes COM Outras bibliotecas de classes de projetos na mesma solução XML Web Services Para obter mais informações sobre referências de XML Web Services. Caso contrário. você deve adicionar manualmente o assembly à pasta \Bin. Solucionando problemas de referências quebradas Se seu aplicativo tentar usar uma referência quebrada. Se o valor for true. Em versões anteriores do Visual Studio. Isso cria uma interdependência que requer uma consideração especial ao criar e executar o aplicativo. Agora. Se false. consulte Como: preparar e gerenciar Builds. a referência não é copiada. seu projeto deve primeiramente conter uma referência a ele. Se você implantar um aplicativo que contém uma referência a um componente personalizado que está registrado no GAC. a referência deve ser copiada para o caminho de saída do projeto quando o projeto é criado. consulte Gerenciamento de projeto para usuários do Visual Basic 6. reduzindo o risco de publicar código personalizado com o qual você não está familiarizado. Se o projeto contiver uma referência a um objeto que não esteja em um desses locais. a propriedade CopyLocal está definida como false se o assembly ou componente está no cache global de assemblies ou é um componente de estrutura. A conexão de rede ou a autenticação falhou. mas existem várias situações em que uma referência pode ser considerada quebrada. Dica Referências de projeto-a-projeto não têm esses problemas. o local da pasta do arquivo de componente (por exemplo. Uma outra solução é usar o item Reference Path em páginas de propriedades do projeto e modificar as pastas na lista para apontar para os locais correto. A propriedade ReferencePath é mantida para cada usuário em cada computador. MeuComponente). Caminho de referência está incorreto Se projetos são compartilhados em computadores diferentes. Observação Arquivos em assemblies são referenciados com caminhos absolutos no arquivo de projeto. C:\MeusComponentes\) será acrescentado à propriedade de projeto ReferencePath. O arquivo sendo referenciado foi renomeado. Essas instâncias são mostradas na lista a seguir: • • • • • O caminho de referência do projeto está incorreto ou incompleto. No Solution Explorer. Devido a isso. O arquivo sendo referenciado foi excluído. Para obter mais informações. é possível que usuários trabalhando em um ambiente com vários desenvolvedores sintam a falta de um assembly referenciado no seu ambiente local. A referência é a um componente COM que não está instalado no computador. clique com o botão direito do mouse no nó do seu projeto e clique em Properties. se possível. você pode excluir a referência quebrada e substituí-la usando a caixa de diálogo Add Reference. Se o projeto for aberto em um computador que armazena o componente em um diretório diferente. assim modificar o seu caminho de referência não afeta outros usuários do projeto. Quando o projeto é aberto. Por esse motivo.primário do erro. Visual Studio 315 . algumas referências podem não ser encontradas quando um componente está localizado em um diretório diferente em cada computador. como D:\MeusComponentes\. ele tenta localizar esses arquivos de componentes referenciados procurando nos diretórios no caminho de referência. use-as em vez de referências de arquivo. consulte Como: adicionar ou remover referências no Visual Studio e Programando com assemblies. O Project Designer aparecerá. Referências são armazenadas sob o nome do arquivo de componente (por exemplo. Para evitar esses erros. é melhor nesses casos adicionar referências de projeto-a-projeto. A seguir estão soluções para esses problemas. Para corrigir este problema. Para consertar uma referência de projeto quebrada corrigindo o caminho de referência 1. 2. a referência não poderá ser encontrada e um erro aparecerá na Lista de Tarefas. Quando uma referência é adicionada a um projeto. Se a referência existir em outro local no seu computador. Se você estiver usando o Visual Basic. consulte Interoperabilidade COM em aplicativos . Conexão de rede ou autenticação falhou Pode haver várias causas possíveis para arquivos inacessíveis: uma conexão de rede ou uma autenticação que falhou. e depois clique no botão Add Folder. Cada causa pode ter meios exclusivos de recuperação. consulte Como: adicionar ou remover referências no Visual Studio. excluir a referência e corrigir o código que a usa é sempre uma opção. Se você estiver usando o Visual C#. Para mais informações. depois clique no botão Add Folder. Na caixa de diálogo Reference Paths. Para corrigir uma referência de projeto quebrada a um arquivo que não existe mais no seu disco • • • Excluir a referência. Instalar o componente no segundo computador irá corrigir o erro. No entanto.NET Framework. digite o caminho da pasta que contém o item que você deseja referênciar. leia-a deste local. Para obter mais informações sobre como usar referências a componentes COM em seus projetos. e depois adicione uma referência ao arquivo renomeado. digite o caminho da pasta que contém o item que você deseja referenciar no campo Folder. o segundo usuário receberá um erro de que a referência está quebrada. Para corrigir uma referência quebrada a um arquivo que foi renomeado • • Exclua a referência. Visual Studio 316 . Convenções de nomenclatura para arquivo de recurso Esta seção descreve as convenções de nomeação para recursos manifesto de assembly em projetos do Visual Basic e Visual C#. selecione a página References e clique no botão Reference Paths. consulte Como: adicionar ou remover referências no Visual Studio. Para mais informações. Arquivo referenciado foi renomeado É possível que o arquivo referenciado tenha sido renomeado. por exemplo. consulte Como: adicionar ou remover referências no Visual Studio. você precisa lê-lo daquele local. Arquivo referenciado foi excluído É possível que o arquivo sendo referenciado tenha sido excluído e não exista mais na unidade. por exemplo. selecione a página Reference Paths. No campo Folder. você pode precisar entrar em contato com o seu administrador local para obter acesso aos recursos necessários.3. Para mais informações. Se a referência existir em outra local no seu computador. Componente COM não está instalado no computador Se um usuário tiver adicionado uma referência a um componente COM e um segundo usuário tentar executar o código em um computador que não tenha este componente instalado. independentemente se eles são arquivos dependentes. ou extension.string info cultura opcional RFC 1766]. arquivos de recursos XML são transformados em BLOBs antes da inclusão no manifesto do assembly.optional RFC 1766 culture info string].extension Além das limitações do sistema de arquivos.resx.resx Além das limitações do sistema de arquivos. Com esta ferramenta. ainda são suportadas. Isso permite a você fazer alterações nos valores de propriedade sem recompilar o aplicativo. optional RFC 1766 culture info string. as configurações de propriedades dinâmicas serão preservadas no código e funcionarão em tempo de execução.resx e cuja propriedade BuildAction está definida como Embedded Resource.de-de. É recomendável que você em vez disso use o Project Designer para especificar configurações de aplicativo. Para obter mais informações. Todos esses arquivos de recursos seguem a mesma convenção de nome.resx MyResource. não há restrições sobre base_filename ou a string info cultura opcional RFC 1766.Recursos XML Um arquivo de recursos XML é um arquivo cuja extensão é . Com propriedades dinâmicas você pode armazenar alguns dos valores de propriedade do aplicativo em um arquivo externo e carregá-los quando o aplicativo é executado. designer de projeto e Gerenciando definições de aplicativo. Introdução a propriedades dinâmicas (Visual Studio) Observação Visual Studio 317 .File. As propriedades dinâmicas no entanto. A seguir.resx Recursos não-XML Um arquivo de recursos não-XML é qualquer arquivo cuja propriedade BuildAction é EmbeddedResource e cuja extensão é algo diferente de . Configurando aplicativos usando propriedades dinâmicas Observação A interface de usuário para propriedades dinâmicas foi removida do Visual Studio 2005. após o projeto ter sido implantado. não existem restrições em base_filename. Exemplos de nomes de arquivo de recursos XML válidos incluem: • • • MyResource. a convenção de nomeação de arquivo para esses recursos: nomearquivo_base[.Resource. A nomeação para esses arquivos é a seguinte: base_filename+[. consulte Página de configurações. Se você importar um projeto de uma versão anterior do Visual Studio. Esses arquivos XML devem seguir um esquema específico compreendido pela ferramenta de conversão ResXToResources.resx My. você pode fazer uma única alteração no arquivo externo e o aplicativo irá pegar os novos valores na próxima vez em que ele for executado. Embora as propriedades de qualquer componente. Você pode usar propriedades dinâmicas em qualquer aplicativo que seja compilado em um arquivo . você tem que alterar todas as configurações de banco de dados manualmente antes de implantar. algumas propriedades são melhores candidatas a propriedade dinâmica que outras. ou contadores de desempenho. incluindo bancos de dados. Propriedades dinâmicas permitem que você configure seu aplicativo de maneira que alguns ou todos os seus valores de propriedades sejam armazenados em um arquivo de configuração externo em vez de ser armazenados no código compilado do aplicativo. Para obter mais informações como criar um arquivo de configuração. suponha que você esteja criando um aplicativo que usa um banco de dados de teste durante o processo de desenvolvimento. Propriedades dinâmicas e arquivos de configuração Ao definir uma propriedade como configurável. Se você armazenar esses valores externamente. você irá armazenar e recuperar propriedades que se conectam a recursos externos que podem se alterar.dll. Se você importar um projeto de uma versão anterior do Visual Studio. Project Designer e Gerenciando configurações de aplicativo. entretanto propriedades de DLL podem ser definidas dinamicamente pelo . o seu valor é gravado em um arquivo de configuração e código é inserido na classe para indicar que o valor da propriedade deve ser recuperado a partir deste recurso externo. Ao fornecer aos administradores os meios para atualizar valores de propriedades que podem precisar ser alterados ao longo do tempo. isto pode reduzir o custo total de se manter um aplicativo após ele ter sido implantado. ele causará erros de compilação sem eles. O arquivo de Visual Studio 318 .exe. Projetos que compilam uma DLL não podem usar propriedades dinâmicas diretamente. Se você armazenar os valores de propriedades dentro do aplicativo. Por exemplo. Porém propriedades dinâmicas ainda recebem suporte. consulte Explicação passo a passo: armazenando e recuperando propriedades dinâmicas. Observação O código de exemplo neste tópico depende da existência de um objeto SqlConnection e um arquivo de configuração. consulte Página de configurações. Muitas dessas propriedades são identificadas como candidatas padrão a propriedade dinâmica. as configurações de propriedades dinâmicas serão preservadas no código e irão funcionar em tempo de execução. formulário ou controle nestes aplicativos possam ser tratadas dinamicamente. Observação de segurança Valores de propriedades armazenados em um arquivo de configuração não são seguros. e depois recompilar o código fonte. É recomendável que você em vez disso use o Project Designer para especificar configurações de aplicativo. e você precise alterná-lo para um banco de dados de produção ao implantá-lo. Para obter mais informações.A interface do usuário para propriedades dinâmicas foi removida do Visual Studio 2005. logs de eventos. Dados confidenciais como senhas e informações de cartão de crédito não devem ser armazenados como propriedades dinâmicas. Freqüêntemente.exe que está referenciando o arquivo . AppSettings.ConnectionString" value="data source=myserver.Configuration.ConnectionString = System.packet size=4096" /> </appSettings> </configuration> Você pode modificar o arquivo de configuração diretamente de maneira a atualizar dinamicamente os valores de propriedades em seu aplicativo. Por exemplo.ConnectionString" value="data source=myserver. Você não pode alternar para um arquivo de configuração diferente ou usar vários arquivos dentro de um único aplicativo. Dentro do arquivo de configuração. o valor dessa propriedade seria armazenado via XML. De uma certa maneira. ele irá atualizar os valores. Observação de segurança Para obter mais informações sobre como criar conexões de dados seguras. arquivos de Visual Studio 319 . A parte inicial da chave indica o componente do qual originou-se o valor. suponha que você indicou que a propriedade ConnectionString para uma conexão de dados deve ser armazenada no arquivo de configuração. arquivos de configuração são semelhantes a arquivos de recurso. Você poderá ver este código no editor de código.configuração varia de acordo com o tipo de aplicativo. Por exemplo.initial catalog=Apps.packet size=4096" /> <add key="sqlConnection2.config. as propriedades são mantidas usando XML.initial catalog=Apps. usando a chave indicada no código do formulário: <configuration> <appSettings> <add key="sqlConnection1. No entanto.packet size=4096" /> </appSettings> </configuration> Para cada valor no arquivo de configuração é atribuída uma chave que é usada para armazenar e recuperar o valor.sqlConnection1.ConfigurationManager. essas duas chaves indicam uma propriedade ConnectionString de duas conexões de dados dentro de um único aplicativo: <configuration> <appSettings> <add key="sqlConnection1. No arquivo de configuração. Na próxima vez em que o aplicativo for iniciado. e aplicativos baseados no Windows usam um arquivo semelhante com extensão .config.Get("SqlConnection1.Integrated Security=SSPI.ConnectionString").ConnectionString" value="data source=myserver.initial catalog=Apps. indicando que o valor é armazenado externamente: C# this.Integrated Security=SSPI. consulte Tornando seguras seqüências de conexão.Integrated Security=SSPI. aplicativos baseados na Web usam o arquivo Web. Todos os formulários e componentes em um aplicativo usam um único arquivo de configuração. ambos são usados para armazenar valores fora do aplicativo compilado e ambos usam XML para armazenar suas informações. se você tiver três componentes em sua classe que acessem o mesmo banco de dados.ConnectionString = System. você pode associar vários arquivos de recurso a um projeto. essa propriedade seria armazenada assim: <appSettings> <add key=timer1. Tipos de dados e propriedades dinâmicas XML armazena tudo como uma seqüência de caracteres.Configuration. você irá ver informações adicionais no editor de código para indicar o tipo de dado para o valor da propriedade.Enabled" value="True" /> </appSettings> No editor de código. somente uma entrada é feita no arquivo de configuração. AppSettings. consulte Organização hierárquica de recursos para localização. enquanto os componentes em uso diferem. enquanto arquivos de configuração (no caso de propriedades dinâmicas) são usados para atualizar valores de propriedades. Os valores em um arquivo de recurso são destinados a serem traduzidos. this. Definindo propriedades múltiplas para a mesma chave Propriedades múltiplas podem referenciar o mesmo par chave-valor em um arquivo de configuração. O valor inicial armazenado é o mesmo da primeira propriedade para a qual foi fornecida essa chave. this.ConnectionString"). Além disso.Get("SqlConnection1.ConnectionString.ConnectionString = System. Por exemplo.ConnectionString"). enquanto valores de propriedades dinâmicas em um arquivo de configuração podem ser alterados conforme necessário.ConnectionString").Configuration. No arquivo de configuração.ConfigurationManager.sqlConnection3. mas você só pode ter um único arquivo de configuração para o aplicativo. você deverá ver este código para indicar que o valor recuperado precisa ser alterado para um Tipo de dados Double (Visual Basic): C# Visual Studio 320 .Configuration. você pode armazenar a propriedade ConnectionString para cada um no mesmo par chave-valor. AppSettings. Se o valor da propriedade que você está armazenando não é uma seqüência de caracteres.Get("SqlConnection1. Arquivos de recurso são usados para armazenar seqüências e outros recursos localizáveis para fins de tradução. mas tipicamente não são alterados. Para obter mais informações sobre arquivos de recurso. Por exemplo. Observe que. Quando você escolhe a mesma chave para propriedades múltiplas. Isso significa que se o banco de dados for alterado. todos eles referem-se à chave para sqlConnection1. AppSettings. Você faria isso definindo cada uma das propriedades como a mesma chave. você pode atualizar um único valor no arquivo de configuração para aplicar a alteração a todos os três componentes. assim: C# this.ConnectionString = System.sqlConnection1. suponha que você esteja armazenando dinamicamente o valor das propriedades Interval e Enabled de um componente Timer.Interval" value="100" /> <add key=timer1.Get("SqlConnection1.recurso servem para uma finalidade totalmente diferente do que arquivos de configuração.ConfigurationManager.sqlConnection2.ConfigurationManager. Para obter mais informações sobre segurança. e nenhum nome de usuário ou senha explícitos são usados na seqüência de conexão.Interval". Segundo. AppSettingsReader().timer1. haverá um leve impacto no desempenho quando o aplicativo ler o arquivo. você pode tirar proveito da opção de segurança integrada fornecida pelo Windows.Double))). e SQL Server. typeof(bool))).this. Serviços de Informações da Internet (IIS).Enabled". Na primeira vez em que um valor de arquivo de configuração é acessado pelo aplicativo. Preocupações de desempenho e segurança com propriedades dinâmicas Há dois itens que podem ser preocupantes quando você usa propriedades dinâmicas. Porém este impacto é muito pequeno e não deve ser notado.timer1. Uma maneira de se fazer isso é proteger o arquivo com uma lista de controle de acesso (ACL) do Windows. Recuperar valores de propriedades de dentro do aplicativo compilado é ligeiramente mais rápido do que recuperar valores de propriedades do arquivo de configuração. consulte a documentação do Windows ou as seguintes páginas: • • Segurança de aplicativos da Web do ASP. você desejará controlar quem tem acesso ao arquivo e aos valores que ele contém.GetValue("timer1.Configuration. Observação Existem dois timers.Enabled = (bool)(new System. Para obter mais informações sobre os dois timers disponíveis. armazenamento e recuperação de propriedades dinâmicas podem afetar um pouco o desempenho do aplicativo. Primeiro. AppSettingsReader(). se você estiver trabalhando com um aplicativo baseado na Web.Double)(new System.NET Visão geral sobre como conectar-se a dados no Visual Studio Visual Studio 321 . Uma lista de controle de acesso especifica que operações diferentes usuários podem executar em arquivos e diretórios específicos. this. com pequenas diferenças nos modelos de programação. consulte Introdução a timers baseados em servidor. Qualquer recuperação subseqüente desta ou outra propriedade tem um impacto no desempenho muito menor — semelhante a ler um valor de uma tabela de hash. Além disso. credenciais de autenticação de um usuário para a rede local também são usadas para acessar recursos de banco de dados. se você estiver armazenando valores de propriedades tais como identificações dos usuários e senhas em um arquivo externo.Configuration. Neste modelo.Interval = (System.GetValue("timer1. um para Windows Forms e outro para aplicativos baseados em servidor. Este exemplo usa o timer baseado em servidor. typeof(System. Visual Studio 322 . exportar e importar configurações. teclas de atalho. e fazer outras personalizações em IDE para conveniência e produtividade. Além disso. Como personalizar a seção de notícias da página Iniciar: Instruções para especificar um RSS personalizado alimentação para a página inicial. Seções relacionadas Recursos de acessibilidade do Visual Studio Informações sobre como otimizar layouts janela. O Visual Studio inclui várias combinações configurações predefinidas que você pode usar para aplicar um grupo de personalizações a IDE. Personalizar o ambiente de desenvolvimento Você pode alterar a aparência e comportamento do ambiente de desenvolvimento integrado do Visual Studio (IDE) de várias maneiras. e várias opções exibe. personalizar a aparência e comportamento do (IDE). Gerenciamento de janela Informações sobre como entrar reorganizar janelas ferramenta e documentos no IDE. Nesta seção Personalizar o ambiente de desenvolvimento Informações sobre como personalizar a janela da Ajuda dinâmica e barras de ferramentas. alterar a fonte e cor do texto. Visual Studio 323 . e outras formas para personalizar o IDE. ambiente de desenvolvimento integrado e tópicos de referência. você pode Certifique individuais personalização a itens como janelas.Personalizar e automatizar o ambiente de desenvolvimento O local para aspecto para obter informações sobre como criar Add-ins. Nesta seção Como: Personalizar Ajuda dinâmica Instruções para reduzir o tipo de tópicos e categorias que aparecem na janela da Ajuda dinâmica. Como iniciar ferramentas no Visual Studio: Instruções para adicionar um comando no menu Ferramentas para iniciar aplicativos externos para o Visual Studio de no Visual Studio. iniciar outros aplicativos de dentro do IDE. barras de ferramentas. Personalizar barras de ferramentas Instruções para adicionar e personalizar a aparência de barras de ferramentas. Automação e extensibilidade para Visual Studio Informações sobre como criar macros e suplementos. Observação Ajuda filtros não afetam a janela da Ajuda dinâmica. a janela da Ajuda dinâmica não exibe links para informações encontradas em MSDN Online ou em sites da Web comunidade Codezone. e alterar basear configurações. Personalizar recursos e opções do Editor Detalhes para alterar a aparência do Editor. Trabalhando com configurações Informações sobre como configurações funcionam no IDE. página. Consulte também Outros recursos Personalizar e automatizar o ambiente de desenvolvimento Visual Studio Como: Personalizar Ajuda dinâmica Você pode alterar o número e tipo de links que aparecem na janela da Ajuda dinâmica para tornar mais fácil para localizar informações A janela da Ajuda dinâmica fornece links para informações encontradas na Ajuda local com base em parte da (IDE) o ambiente de desenvolvimento integrado que atualmente tem foco. A janela da Ajuda dinâmica filtros automaticamente tópicos com base em suas ações no IDE.Como alterar o item exibido em Iniciar Backup do ambiente de desenvolvimento do: Instruções para especificar que uma caixa de diálogo específico. Seções relacionadas Recursos de acessibilidade do Visual Studio Informações sobre como criar atalho combinações de teclas. altere a fonte e cor do texto. ou vincular grupos. e outras formas para personalizar o IDE. Por exemplo. Os tópicos mais provável para ser útil para você estão listados primeiro. importar e exportar configurações. o texto. você pode: • Adicionar ou remover categorias tópico. e Project Settings caixas de diálogo para alterar várias configurações para o depurador a Options Criando e editando configurações Procedimentos para especificar uma variedade de criar configurações para seu esforço de desenvolvimento. otimizar layouts janela. os links que aparecem estão relacionados às você está tentando se realizar a tarefa atual ou a parte atual de IDE que você está usando. Especificando configurações do depurador Como usar e depuração. ele só exibe links para tópicos encontrados na Ajuda local. Visual Studio 324 . ou ambiente vazia é exibida quando você inicia o IDE. Além disso. Normalmente. ele exibe e informações sobre como criar atalhos Editor. • • • • Classificar categorias tópico. Exibir a janela da Ajuda dinâmico Para exibir a janela da Ajuda dinâmico 1. Na caixa Options de diálogo. No menu View. 2. 4. escolha Options. 4. Adicionar ou remover tipos tópico. Escolha OK. Para obter mais informações. exemplos. selecione a categoria você pretende mover e escolha Move Up ou Move Down. escolha Other Windows e escolha Command Window. Alterar o número de links exibidos para cada categoria tópico. e outras ferramentas para serem iniciados quando você seleciona o link. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. Para adicionar ou remover categorias tópico 1. Em Environment. dependendo de suas configurações ativas ou da edição. Na lista Categories. No menu Tools. Você pode alterar a ordem na qual as categorias aparecem na janela da Ajuda dinâmico Para classificar categorias tópico 1. escolha Environment. escolha Options. Na caixa Options de diálogo.DynamicHelp e pressione ENTER. Descrições da categoria: Actions Lista Links para assistentes. 2. treinamento e da janela da Ajuda dinâmico Categorias serão exibidas somente se não há tópicos que correspondem à categoria e o contexto IDE atual. 2. 3. escolha Environment. como Miscelânea. marque ou desmarque as categorias que estão listadas para adicionar ou removê-los da janela da Ajuda dinâmica. No menu Tools. Personalizar categorias tópico Você pode adicionar ou remover categorias tópico. Na lista Categories. escolha Help e escolha Dynamic Help. macros. 5. As categorias incluídas no conjunto documentação padrão são ajuda. 3. Em Environment. Digite Help. ou —— No menu Help. escolha Import and Export Settings No menu Tools. consulte Configurações do Visual Studio. escolha Dynamic Help. comandos. Visual Studio 325 . escolha Help e escolha Dynamic Help. Para alterar as configurações. e Guia de Introdução. Esta página Ajuda foi gravada com General Development Settings em mente. Especificar o contexto que a janela da Ajuda dinâmica usa para exibir links. Descrições tipo tópico: Article Fornece informações detalhadas sobre conceituais entidades incluindo: visões gerais conceito. 2. 3. Você pode exibir mais links se você quiser ser capaz de examine rapidamente um número maior de tópicos relacionados ao seu trabalho ou se seu posicionamento resolução e janela da tela permite que você se Consulte mais links ao mesmo tempo. 4.. escolha Options. informes oficiais. Para alterar o número de links exibidos para cada categoria tópico 1. Em Environment. para se você limitar o número de links exibida. e as práticas recomendadas. Em Environment. Os links são exibidos de acordo com relevância ponderada Os tópicos mais provável para ser útil para você são listados primeiro. No menu Tools. você pode incluir ou excluir vários tipos diferentes tópico. Procedure Visual Studio 326 . você ainda deve obter os tópicos mais relevantes. Por exemplo. Instruções passo a orientação para realizar tarefas específicas.Training Lista links para tópicos do Microsoft (MSDN) treinamento conjunto documentação Developer Network. Personalizar tipos tópico exibidos Em Categorias. tais como artigo e orientação. excluir todos os tipos exceto sintaxe. Na caixa Options de diálogo. Na caixa de diálogo Opções. selecione ou Topic types desmarque os tipos listados para incluir ou exclui-los dos vínculos exibidos na janela da Ajuda dinâmica. escolha Options.NET. 3. Marque a Limit number of links per category caixa de seleção e insira um número na caixa de texto adjacentes. Lista links para tópicos que foram projetados para ajudá-lo rapidamente tornar produtivos usando o Visual Studio. Help Samples Getting Started Miscellaneous Além disso. Links para tópicos que demonstram o uso de tecnologias . escolha Help e escolha Dynamic Help. No menu Tools. Para incluir ou excluir tipos tópico 1. Lista links para tópicos que não cabem em uma das categorias acima. 2. Na lista. escolha Help e escolha Dynamic Help. se você deseja ver apenas links para tópicos de referência de idioma no janela da Ajuda dinâmico. escolha Environment. escolha Environment. 4. você pode especificar o número total de links que são exibidos em cada categoria. backgrounders técnicos. Lista links para tópicos de conjuntos documentação dos msdn. Ajuda sobre mensagens de erro. muitos dos que contêm arquivos de código de fonte completa. Para especificar o tipo de contexto IDE para usar 1. 4. 3. Limita a lista para tópicos associados com qualquer elemento de interface do usuário que está aberto. Em Environment. escolha Customize. funções. Sample Syntax Especificar o contexto usado para determinar os tópicos para incluir Você também pode especificar o contexto de IDE que a janela da Ajuda dinâmica usa para determinar o escopo dos tópicos para exibir Esta opção pode limitar o número de tópicos exibidos. escolha Help e escolha Dynamic Help.Orientation Resumos que ajudam a localizar a ajuda necessária na documentação Visual Studio. você pode compilar criar. 2. E / descrições de exemplos. eventos. escolha Environment. inclusive guias para elementos da interface do usuário. Descrições contexto: Selection only Limita a lista para tópicos associados com o elemento de interface do usuário que está selecionado no momento. Na Show links for. selecione o contexto você deseja a janela da Ajuda dinâmica exibir tópicos para. No menu Tools. 4. Descrições dos elementos sintáticos incluindo objetos. escolha Options. Exibe os tópicos que podem ser associados com o estado atual de IDE. Active UI elements Show all links Consulte também Visual Studio Como personalizar barras de ferramentas Visual Studio (): Você pode alterar o layout. instruções. 2. Criar novas barras de ferramentas Para criar uma nova barra de ferramentas 1. Na caixa Options de diálogo. No menu Tools. 3. Na caixa New Toolbar de diálogo. selecione a Toolbars guia. Reference Informações sobre elementos syntactical não-. métodos. e tópicos do glossário. Na caixa Customize de diálogo. e expressões. digite um nome para a barra de ferramentas Visual Studio 327 . Escolha New. e conteúdo de barras de ferramentas no ambiente de desenvolvimento integrado (IDE) Você também pode adicionar botões a barras de ferramentas e alterar o ícone atribuído de qualquer botão. propriedades. ou executar. Posição. selecione a Commands guia. Escolha OK. selecione Toolbar e escolha Barra de Ferramentas correta na lista drop-down. Em Choose a menu or toolbar to rearrange. Clique em Rearrange Commands. 5. Clique em OK. Escolha Modify Selection. 1. Clique em Add. selecione Toolbar e escolha Barra de Ferramentas correta na lista drop-down.5. 5. Selecione o comando de ferramentas do qual você pretende alterar a imagem. Na caixa Customize de diálogo. Em Choose a menu or toolbar to rearrange. 7. 3. selecione a Commands guia. Escolha Modify Selection. Visual Studio 328 . Clique em Rearrange Commands. 4. 6. escolha Customize. Para alterar imagens de botão de ferramentas 1. 6. No menu Tools . 2. Na caixa Add Command de diálogo. Escolha Edit Button Image. 7. selecione Nome de Categoria da lista Categories e depois escolha um comando apropriado na lista Commands. Selecione o comando de ferramentas do qual você pretende alterar a imagem. Para adicionar um botão de comando a uma barra de ferramentas Personalizar imagens de botão de ferramentas O IDE fornece forty-duas imagens de botão que podem ser trocadas com os ícones da barra de ferramentas Padrão. No menu Tools. escolha Customize. Dica Se você estiver unsatisfied com as imagens alternativas fornecidas. 7. Clique em Rearrange Commands. Clique Close em Close novamente. 2. 2. 8. escolha Customize. selecione Toolbar e escolha Barra de Ferramentas correta na lista drop-down. 6. Escolha Change Button Image e selecione uma alternativa no menu em cascata. 4. você pode personalizar uma imagem de sistema selecionada Para editar imagens de botão 1. Na caixa Customize de diálogo. 3. selecione a Commands guia. No menu Tools. 5. Em Choose a menu or toolbar to rearrange. Na caixa Customize de diálogo. 4. 3. No menu Tools. Consulte Adicionando chaves Accelerator e vinculação de chaves Argumentos para ferramentas externos Visual Studio 329 . Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. Para adicionar uma ferramenta externa a esse menu 1. como o Bloco de notas. Por exemplo. if you use M&y External Tool. escolher Add. escolha External Tools. assim. escolha Import and Export Settings No menu Tools. você pode adicionar um item para o menu Ferramentas para iniciar utilitários. Esta página Ajuda foi gravada com General Development Settings em mente. de dentro do ambiente de desenvolvimento integrado (IDE). consulte Configurações do Visual Studio. Como definir opções de acessibilidade: consulte. Para obter mais informações sobre como aprimorar a usabilidade e acessibilidade de barras de ferramentas. the letter 'y' will be the accelerator key. For example.8. 2. Consulte também Visual Studio Como iniciar ferramentas no Visual Studio: Você pode adicionar itens para o menu Ferramentas que permitem a você para iniciar ferramentas externas a partir do Visual Studio. Para alterar as configurações. como exibir OLE ou WinDiff. Para obter mais informações. dependendo de suas configurações ativas ou da edição. Observação A Customize caixa diálogo pode ser usada para personalizar menus. Para saber mais sobre Fornecendo acoplamentos de teclas e teclas de aceleração para ferramentas externas Argumentos predefinidos para ferramentas externas Adicionar uma ferramenta externa ao menu Ferramentas Você pode adicionar um comando para o menu Ferramentas para iniciar outro aplicativo. e digite um nome para a opção de menu na caixa Title. Na caixa de diálogo da External Tools. Dica Digite um E comercial antes uma das letras no nome ferramenta para criar uma tecla aceleradora para o comando quando ela aparecer no menu Tools. Use a Button Editor caixa de diálogo para personalizar imagem do botão selecionado. Web Também facilmente você pode criar um projeto add-in Visual Studio para informar o IDE na inicialização um utilitário externo que manipulará tarefas. Para passar variáveis para a ferramenta 1. Observação Para obter mais informações sobre sintaxe argumento. em seguida os argumentos que você selecionou será automaticamente passados para a ferramenta. Para iniciar a ferramenta.bat. Observação Adicionando uma ferramenta externa a esse menu não não registrar um aplicativo como a ferramenta padrão do seu tipo. Caso contrário. e. consulte Argumentos para ferramentas externos.. usando o texto inserido como o título... Observação Se o arquivo reside no caminho do sistema. Tipos de arquivos que você pode iniciar incluem. insira o caminho completo para o arquivo.com somente. Selecione Prompt for arguments Se você desejar a opção de edição os argumentos no momento o comando é iniciado. Web. agora aparece no menu Tools.3. Passar variáveis para ferramentas externas Você pode especificar que determinadas informações ser passadas para um comando quando ele for iniciado. Quando você iniciar a ferramenta externa partir menu Ferramentas. Observação A Use output window opção está disponível para arquivos. você pode definir essa preferência do Caixa de diálogo Opções browser.cmd. Na caixa Command. como apropriado. digite os argumentos que deseja passar para a ferramenta.pif. Um comando para a ferramenta. ou optar Browse por navegue até o arquivo.exe. como marcação validação ou fonte integração de controle de código. Especificar uma pasta de trabalho Visual Studio 330 . poderá inserir apenas o nome de arquivo. se você desejar usar seu editor externo favorito para modificar marcações HTML. escolhendo o novo comando de menu. ou escolha o botão de direção para selecionar um argumento predefinido. 4. Ambiente. Selecione Use output window e Close on exit. digite o caminho para o arquivo você pretenda iniciar. Se você selecionou Prompt for Arguments. 2. o Caixa de diálogo Opções browser. e escolha OK. Ambiente. Por exemplo. como opções de linha de comando para aplicativos de console. caixa Arguments de diálogo aparecerá. Na caixa Arguments..bat e.com. Para obter mais informações. você pode optar por exibir o Unicode na janela de saída. 3. consulte Configurações do Visual Studio. Consulte também Visual Studio Como alterar o item exibido em Iniciar Backup do ambiente de desenvolvimento do: Você pode alterar a interface de usuário que aparece por padrão quando você inicia Visual Studio.Você também pode especificar a pasta de trabalho para a ferramenta ou comando Por exemplo. a ferramenta requer se certos componentes de programa estão presentes na pasta atual na inicialização. clique em Import and Export Settings. Para personalizar a seção de notícias da página inicial 1. clique em Options. Exibir saída Unicode na janela de saída Se você usar uma ferramenta que fornece a saída de unicode em vez de ASCII. Em Start Page news channel. ou escolha o botão de direção para selecionar um local de diretório predefinidos. Para especificar uma pasta de trabalho para a ferramenta • Na caixa Initial directory. Selecione Prompt for arguments se você gostaria que tem a opção de especificar argumentos adicionais no momento o comando é iniciado. Observação Não selecionar esta opção para ferramentas que fornecem saída em ASCII. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. Expanda Environment e clique em Startup. dependendo de suas configurações ativas ou da edição. 4. Visual Studio 331 . No menu Tools. digite um novo RSS alimentação URL. digite a pasta de trabalho para a ferramenta. Consulte também Visual Studio Como personalizar a seção de notícias da página Iniciar: Você pode especificar qualquer RSS válido alimentação para a seção de notícias do Start Page. Para exibir saída Unicode na janela de saída • Selecione Treat output as Unicode. Para alterar as configurações. se a ferramenta lê dados do sistema de arquivos da pasta atual. 2. Clique em OK. no menu Tools. Esta página Ajuda foi gravada com General Environment Settings em mente. No menu Tools. Consulte também Visual Studio Trabalhando com configurações Esta seção contém informações sobre a aplicação. modelos disponíveis na caixa de diálogo Novo projetos. e assim por diante. consulte Configurações do Visual Studio. 3. Para obter mais informações. e ajuda filtros. Para alterar as configurações. dependendo de suas configurações ativas ou da edição. caixa de diálogo Opções Configurações do Visual Studio Configurações no Visual Studio consistir de personalizações feitas para o ambiente de desenvolvimento integrado (IDE) com base em diferentes tipos de atividades de desenvolvimento e seus próprios personalizações. Para obter mais informações. 2. você pode: Visual Studio 332 . predefinidas combinações de teclas de atalho. Ambiente. Clique em OK. As alterações tenham efeito você iniciar Visual Studio na próxima vez. aprender a especificar um conjunto de configurações de uso da equipe. escolha Import and Export Settings No menu Tools. Ambiente. Você também pode encontrar informações gerais sobre como configurações funcionam e os tipos de itens que são personalizadas através das configurações. consulte Caixa de diálogo Opções inicialização.Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. nomes de menu. Expandir Environment e escolha Startup. Além disso. Com configurações. Na lista At startup drop-down.. colocação dos comandos de menu. Esta página Ajuda foi gravada com General Development Settings em mente. escolha Options. Nesta seção Configurações do Visual Studio COMO: Compartilhar configurações entre computadores Como: Alterar configurações selecionadas Como: Especificar configurações para uma equipe Import and Export Settings Wizard Referência Importar e exportar configurações. escolha uma das opções. Essas personalizações incluir mostrar ou ocultar determinada layouts janela. exportar e importar configurações para personalizar o ambiente de desenvolvimento integrado (IDE) para melhor correspondência seu estilo de desenvolvimento. janelas de ferramentas. 4. Para alterar o padrão UI exibida quando você inicia o Visual Studio 1. Importar um arquivo que contém somente um subconjunto das categorias configurações ou unselecting categorias configurações em um arquivo. As configurações Ativa consistem em duas partes: predefinidas personalizações do arquivo instalado. você pode alterar as configurações aplicadas como parte de uma coleção predefinida Por exemplo. Como configurações funcionam? Quando você inicia Visual Studio. Configurações podem ser aplicadas de duas maneiras: completamente você pode substituir as configurações Ativa com novas configurações ou você pode substituir uma parte de suas configurações ativa. você não pode substituir a configuração predefinida sem aplicar uma coleção diferente.• • • Criar uma cópia das suas configurações ativa para uso em uma segunda máquina Compartilhar suas configurações Ativa com outros desenvolvedores Permitir todos os membros da equipe para usar as mesmas configurações em Selecione áreas. consulte Configurações do Visual Studio. importar. sem remover personalizações para outras áreas individuais Quais são configurações? Configurações são personalizações ao IDE.vssettings. e opções caixa diálogo disponíveis que você pode salvar.vssettings arquivo. padrões editor. Cada vez que fizer uma alteração em uma configuração controlada pelo Visual Studio. Configurações ativa são salvas por padrão no currentsettings. como alterar a cor do commented código no Editor. ocultando páginas. você também terá a opção de aplicar configurações a outros edição na usando a My Previous Settings opção.vssettings ou aplicar outra coleção configurações dois substituirão as configurações ativa completamente. O Visual Studio aplica suas configurações ativa automaticamente sempre que você iniciar o Visual Studio. Ajuda e Configurações Coleções configurações predefinidas também fornecer personalizações à Ajuda. ou redefinir para facilitar o IDE para usar. a alteração é automaticamente salvo para currentsettings. se uma coleção configurações simplificada caixa de diálogo Opções. consulte Como: Alterar configurações selecionadas. Configurações especificam o padrão How Do I Página na Ajuda. Para obter mais informações sobre as configurações predefinidas disponíveis com Visual Studio. deixando as configurações ativos para as categorias restantes intacto. como o editor. Se você atualizar para outro edição do Visual Studio. você pode exibir essas páginas manualmente. Para obter uma lista detalhada das personalizações incluídos no configurações predefinidas. consulte os seguintes tópicos. A coleção configurações é o primeiro elemento de suas configurações ativa.vssettings você selecionou na primeira vez você iniciou Visual Studio e qualquer personalização IDE subseqüentes que você fez. Eu selecionado Visual Studio 333 .vssettings só se aplica essas configurações que estiver selecionadas. Para obter informações sobre como aplicar coleções configurações diferentes. Em alguns casos.vssettings juntamente com as configurações predefinidas. selecionando Show all settings. Importar um arquivo que contém todas as categorias configurações possíveis. como layouts janela. Em outros casos. Exportar. primeiro é necessário para selecionar uma coleção configurações que contém configurações predefinidas projetadas para corresponder seus hábitos de desenvolvimento. aprender a especificar um conjunto de configurações de uso da equipe. 14. No Which settings do you want to import. A Reset Complete página lista os erros associados a redefinindo as configurações com Details. Na página Save Current Settings. No menu Tools. Consulte também Trabalhando com configurações Esta seção contém informações sobre a aplicação. Para alterar configurações selecione 13. expanda a lista e selecione apenas a categorias ou itens de categoria que você deseja que se aplicam as configurações atuais. você precisará estar ciente das categorias dentro do arquivo configurações que podem ser uma questão de segurança. No Which collection of settings do you want to import. e clique em Next 16. clique em Import selected environment settings e clique em Next.. Você também pode encontrar informações gerais sobre como configurações funcionam e os tipos de itens que são personalizadas através das configurações. Na Welcome to the Import and Export Settings Wizard Página. consulte Configurações do Visual Studio. 18. 15. Configurações e segurança Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança se você compartilhar suas configurações com outros usuários. bem como fornece conteúdo personalizado na caixa como guia. Para obter mais informações sobre configurações predefinidas. Essas categorias configurações incluem: • • Favoritos Importar e exportar configurações Consulte também Outros recursos Como: Alterar configurações selecionadas Você pode aplicar um sub-set das configurações de uma coleção configurações diferentes para as configurações atuais para criar um ambiente de desenvolvimento mais personalizada. Um ícone aparece ao lado essas categorias com as possíveis questões de segurança. selecione uma coleção configurações na lista e clique em Next. se você pretende importar configurações fornecidas por outras pessoas. Você pode alterar o ativo How Do I página na lista drop-down como pendente eu outras páginas.como pendente eu página filtros fazer o conteúdo que aparece no índice analítico e no índice. Além disso. selecionar Yes. Clique em Finish. Nesta seção Visual Studio 334 . escolha Import and Export Settings. 17. Inversamente. exportar e importar configurações para personalizar o ambiente de desenvolvimento integrado (IDE) para melhor correspondência seu estilo de desenvolvimento. save my current settings. escolha Import and Export Settings. Importar um arquivo.vssettings. Para exportar configurações 15. você pode usar esse arquivo em outros computadores ao importar esse arquivo para outra instalação do Visual Studio. selecione as categorias você pretende exportar e. em seguida.vssettings que você pode usar em um computador segundo ou compartilhar com outros desenvolvedores. projetos. examine os erros associados à exportação as configurações com Details. No What do you want to name your settings file. caixa de diálogo Opções COMO: Compartilhar configurações entre computadores Você pode exportar configurações para o editor. 18. como seu computador de desenvolvimento segundo ou computador um colega na. e outras áreas IDE a um arquivo que você pode importar e usar em outro computador. clique em Export selected environment settings e clique em Next. clique Browse ou digite um novo caminho para Store my settings file in this directory. Exportar configurações para um arquivo Você pode optar por exportar todas ou algumas das suas configurações atuais a um arquivo. 19. No Which settings do you want to export?. 17. 21. Ambiente. Na Welcome to the Import and Export Settings Wizard Página. depuração. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. Se você está importando o arquivo configurações contém todas as categorias configurações possíveis. Na página Export Complete. Você também pode importar arquivos de configuração criados por outros usuários e aplicar essas configurações para o Visual Studio. Observação Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança.Configurações do Visual Studio COMO: Compartilhar configurações entre computadores Como: Alterar configurações selecionadas Como: Especificar configurações para uma equipe Import and Export Settings Wizard Referência Importar e exportar configurações. fontes e cores. No menu Tools. Clique em Finish. digite um nome para o arquivo de configurações. importar esse arquivo completamente substitui as Visual Studio 335 . Se você gostaria de salvar o arquivo em um local diferente. clique em Next Configurações.vssettings Após ter criado um arquivo. 16. 20. A lista Tarefas por exemplo. tem exportadas todas as sua configurações para um arquivo para que outras pessoas na equipe podem utilizá-lo. just import new settings. Se você desejar se aplicar as configurações de fontes e cores e as configurações teclado desse arquivo. Um desenvolvedor na equipe por exemplo. save my current settings por criar um backup de suas personalizações IDE atuais. examine os erros associados a importar as configurações em Details.vssettings entre computadores Em vez de criar uma cópia das suas configurações atuais e usando a cópia em outro computador. apenas aplica essas categorias e não afeta as configurações atuais para categorias não importadas.vssettings único em vários computadores. 23. No menu Tools.vssettings selecionado. overwriting my current settings por continuar sem fazer o backup suas personalizações IDE atuais. selecione um arquivo na lista ou clique Browse para localizar um arquivo de configurações e clique em Next. personalizações feitas. você pode compartilhar um arquivo. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. Essa técnica pode ser útil se você desejar as personalizações mesmas exatas disponíveis em todas as vezes em vários computadores. Na Welcome to the Import and Export Settings Wizard Página. No menu Tools. escolha Import and Export Settings. 24. optar Yes. Clique em Finish. são salvas para o arquivo.vssettings único em um compartilhamento de rede. na próxima vez que você iniciar o Visual Studio em outros computadores. Logon Save Current Settings. optar No. Na pasta Environment. 22. 21. No What collection of settings do you want to import?. se você fechar a lista de tarefas em um computador. Importar o arquivo se um arquivo de configurações contém apenas um subconjunto das categorias configurações. selecione as configurações opções você pretende importar do arquivo. decidir se deve ou não para salvar as configurações atuais. independentemente do computador no qual você torná-los na. Na página Import Complete. escolha Options 12. Visual Studio 336 . Para compartilhar um arquivo único configurações entre computadores 11. Compartilhar um arquivo único. somente você pode limpar todos os outras categorias configurações e apenas aplicar as configurações selecionadas sem alterar as configurações atuais para as categorias restantes Para importar configurações 17. 20.configurações existentes. Quando você compartilhar um arquivo. clique em Import selected environment settings e clique em Next.vssettings. Na caixa Save Current Settings de diálogo. Observação Algumas categorias configurações podem conter informações que podem ser uma questão de segurança. No Which settings do you want to import?. não será exibida. escolha Import and Export Settings. 18. 19. vssettings de grupo sempre que você iniciar o Visual Studio. Na Automatically save my settings to this file. escolha Options. Selecione Use team settings file. 15.vssettings para um subconjunto de categorias configurações disponíveis que todos os desenvolvedores de seu grupo podem usar. O Visual Studio verifica que você estiver usando a versão mais recente do arquivo. 14. escolhendo Import and Export Settings. ele pode ser útil para que cada desenvolvedor usar as configurações mesmas exatas em algumas áreas do ambiente de desenvolvimento integrado (IDE). Visual Studio 337 .vssettings para uso em um grupo 11. Clique OK para aplicar as configurações. 14. Permite que você se reverter as configurações de volta para uma das configurações predefinidas disponíveis com o produto. importar configurações. digite uma pasta compartilhada ou clique Browse para localizar um compartilhamento de rede. 15. escolha Import and Export Settings. Aplica as configurações em um arquivo você tiver recebido. Na pasta Environment.13. permitindo que desenvolvedores individuais para manter personalizações feitas para outras áreas do IDE. No segundo computador. consulte COMO: Compartilhar configurações entre computadores. Opção Exportar configurações de ambiente selecionada Importar configurações de ambiente selecionada Redefinir todas as configurações Descrição Salvar um subconjunto ou todas as suas configurações existentes para que você pode usar essas configurações em outro computador. Insira um UNC ou caminho local. como o editor. Partir do Tools menu. Clique em OK. Você pode incentivar Essa consistência criando um arquivo.vssettings de grupo. Quaisquer alterações feitas no arquivo. Quando aplicado. 13. essas configurações da equipe não seria substituem qualquer categoria não especificada no arquivo. Substitui existentes configurações com os do arquivo importado. Para obter informações sobre como criar um arquivo.vssettings são aplicadas automaticamente. Consulte também Como: Especificar configurações para uma equipe Quando estiver trabalhando em um grupo. Consulte também Import and Export Settings Wizard Use este assistente para exportar configurações. Para especificar um arquivo. ou substituir as configurações para usar uma coleção configurações predefinidas.vssettings. ou clique Browse para localizar o arquivo. 12.vssettings. Você pode acessar este assistente a partir do Tools Menu. repita as etapas 1 a 4. Escolha Configurações para exportar. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. Essas configurações não são selecionados por padrão. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. • COMO: Compartilhar configurações entre computadores Selecione para exportar todas as configurações. COMO: Compartilhar configurações entre computadores Yes. Store my settings file in this directory. Especifica o diretório padrão no qual as configurações exportadas serão salvos. mas são automaticamente selecionados se você escolher All Settings. ou especificar um sub-set das configurações por categoria ou item de categoria. importar e Assistente para exportação configurações Use esta página do Assistente para configurações a importação e exportação para salvar as configurações ativos antes de importar novas configurações. Which settings do you want to export? Consulte também Conceitos Nomeie O arquivo de configurações. importar e exportar configurações Assistente Use esta página do Assistente para configurações a importação e exportação para especificar algumas ou todas as suas configurações atuais ser exportados para um arquivo para uso em outros computadores. importar e exportar configurações Assistente Use esta página do Assistente para configurações a importação e exportação para especificar o nome e local do arquivo que irá conter as configurações exportadas. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. Consulte também Conceitos Salvar configurações atuais. Clique Browse para especificar uma pasta personalizada. save my current settings Visual Studio 338 . COMO: Compartilhar configurações entre computadores What do you want to name your settings file? Digite um nome personalizado para as configurações exportadas. Observação Configurações que podem conter informações de identificação sobre você ou seu computador são marcadas com um gráfico de aviso. • Como: Alterar configurações selecionadas Lista as coleções configurações disponíveis. Which collection of settings do you want to import? Description Exibe informações sobre a coleção configurações que são otimizadas para. Which settings do you want to import? Description Exibe informações sobre a coleção configurações que são otimizadas para. importar e Assistente configurações exportação Use esta página do Assistente para configurações a importação e exportação para especificar a coleção Configurações você pretende importar. as configurações importadas substituirá as alterações. Para obter mais informações sobre coleções configurações predefinidas. No. consulte Configurações do Visual Studio. overwriting my current settings Selecione esta opção se você não quiser backup as configurações atuais. Setting file name Store my settings file in this directory Digite um nome personalizado para as configurações atuais. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. Somente disponível para Default Settings. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. importar e Assistente configurações exportação Use esta página do assistente Importar e exportar configurações para especificar uma coleção configurações predefinidos ou uma coleção configurações personalizadas você deseja importar para uso no IDE. Clique Browse para especificar uma pasta personalizada. Mais tarde você pode optar por importar essas configurações para retornar ao estado IDE atual. Visual Studio 339 . ou clique Browse para localizar uma coleção diferente para importar. Consulte também Escolha Configurações para importar. just import new settings. • COMO: Compartilhar configurações entre computadores Selecione uma coleção na lista.Selecione esta opção para criar um backup das suas configurações atuais. Se você está importando o arquivo configurações contém configurações para itens de categoria você ter personalizado. Clique Browse para navegar para uma coleção configurações que não aparece na lista. Consulte também Escolha um coleção de configurações para importar. Especifica o diretório padrão no qual as configurações atuais serão salvos. Details Exibe informações sobre qualquer sucesso ou falhas. clique Browse ou digite um novo caminho para Store my settings file in this directory. projetos. No What do you want to name your settings file. depuração. fontes e cores. selecione as categorias você pretende exportar e. 3. 4. Na Welcome to the Import and Export Settings Wizard Página. 5.vssettings Após ter criado um arquivo.vssettings que você pode usar em um computador segundo ou compartilhar com outros desenvolvedores. Na página Export Complete. 6. 2. clique em Export selected environment settings e clique em Next. e outras áreas IDE a um arquivo que você pode importar e usar em outro computador. examine os erros associados à exportação as configurações com Details. No Which settings do you want to export?. Para exportar configurações 1. como seu computador de desenvolvimento segundo ou computador um colega na.Consulte também <task> Complete. digite um nome para o arquivo de configurações. escolha Import and Export Settings. Observação Algumas categorias configurações podem conter informações sobre você ou seu computador que pode ser uma questão de segurança. Exportar configurações para um arquivo Você pode optar por exportar todas ou algumas das suas configurações atuais a um arquivo. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. Importar um arquivo. você pode usar esse arquivo em outros computadores ao importar esse arquivo para outra instalação do Visual Studio.vssettings. em seguida. Clique em Finish. No menu Tools. Import and Export Settings Wizard Esta página do importação e assistente exportar para configurações exibe informações sobre a tarefa configurações concluída com êxito ou não e todos os erros que foram encontrados. 7. Se você gostaria de salvar o arquivo em um local diferente. Visual Studio 340 . Consulte também Visual Studio COMO: Compartilhar configurações entre computadores Você pode exportar configurações para o editor. clique em Next Configurações. Você pode acessar este assistente a partir do Tools menu clicando Import and Export Settings. vssettings único em vários computadores. Observação Algumas categorias configurações podem conter informações que podem ser uma questão de segurança. No menu Tools. escolha Import and Export Settings. tem exportadas todas as sua configurações para um arquivo para que outras pessoas na equipe podem utilizá-lo. são salvas para o arquivo. 3. 4. clique em Import selected environment settings e clique em Next. save my current settings por criar um backup de suas personalizações IDE atuais. No What collection of settings do you want to import?. Clique em Finish. personalizações feitas. independentemente do computador no qual você torná-los na. selecione um arquivo na lista ou clique Browse para localizar um arquivo de configurações e clique em Next. overwriting my current settings por continuar sem fazer o backup suas personalizações IDE atuais. 6. importar esse arquivo completamente substitui as configurações existentes. Importar o arquivo se um arquivo de configurações contém apenas um subconjunto das categorias configurações. apenas aplica essas categorias e não afeta as configurações atuais para categorias não importadas. 5.vssettings único em um compartilhamento de rede. just import new settings.vssettings entre computadores Em vez de criar uma cópia das suas configurações atuais e usando a cópia em outro computador. optar No.vssettings. selecione as configurações opções você pretende importar do arquivo. somente você pode limpar todos os outras categorias configurações e apenas aplicar as configurações selecionadas sem alterar as configurações atuais para as categorias restantes Para importar configurações 1. Se você desejar se aplicar as configurações de fontes e cores e as configurações teclado desse arquivo. decidir se deve ou não para salvar as configurações atuais. Na caixa Save Current Settings de diálogo. examine os erros associados a importar as configurações em Details. Na Welcome to the Import and Export Settings Wizard Página. Um desenvolvedor na equipe por exemplo. Logon Save Current Settings. Se você está importando o arquivo configurações contém todas as categorias configurações possíveis. 7. Essas categorias configurações são identificadas por um ícone de aviso amarelo e preto. 8. Essa técnica pode ser útil se você desejar as personalizações mesmas exatas disponíveis em todas as vezes em vários computadores. se você Visual Studio 341 . A lista Tarefas por exemplo. optar Yes. você pode compartilhar um arquivo. Na página Import Complete. Quando você compartilhar um arquivo. No Which settings do you want to import?. Compartilhar um arquivo único. 2.Você também pode importar arquivos de configuração criados por outros usuários e aplicar essas configurações para o Visual Studio.vssettings selecionado. digite uma pasta compartilhada ou clique Browse para localizar um compartilhamento de rede. Você pode incentivar Essa consistência criando um arquivo. como o editor. clique em Import selected environment settings e clique em Next. Na Automatically save my settings to this file. Consulte também Visual Studio 6. No Which settings do you want to import. Para compartilhar um arquivo único configurações entre computadores 1.vssettings. 3. Para obter informações sobre como criar um arquivo. Consulte também Visual Studio Como: Alterar configurações selecionadas Você pode aplicar um sub-set das configurações de uma coleção configurações diferentes para as configurações atuais para criar um ambiente de desenvolvimento mais personalizada. e clique em Next No Which collection of settings do you want to import. No menu Tools. selecionar Yes. escolha Import and Export Settings. selecione uma coleção configurações na lista e clique em Next. Na página Save Current Settings.fechar a lista de tarefas em um computador. na próxima vez que você iniciar o Visual Studio em outros computadores.vssettings para um subconjunto de categorias configurações disponíveis que todos os desenvolvedores de seu grupo podem usar. 3. repita as etapas 1 a 4. 2. A Reset Complete página lista os erros associados a redefinindo as configurações com Details. Quando aplicado. Para obter mais informações sobre configurações predefinidas. Como: Especificar configurações para uma equipe Quando estiver trabalhando em um grupo. Clique em Finish.vssettings. No segundo computador. expanda a lista e selecione apenas a categorias ou itens de categoria que você deseja que se aplicam as configurações atuais. escolha Options Na pasta Environment. não será exibida. 5. consulte Configurações do Visual Studio. consulte COMO: Compartilhar configurações entre computadores. 4. escolha Import and Export Settings. 2. permitindo que desenvolvedores individuais para manter personalizações feitas para outras áreas do IDE. save my current settings. ele pode ser útil para que cada desenvolvedor usar as configurações mesmas exatas em algumas áreas do ambiente de desenvolvimento integrado (IDE). Visual Studio 342 . 5. essas configurações da equipe não seria substituem qualquer categoria não especificada no arquivo. 4. Na Welcome to the Import and Export Settings Wizard Página. Clique em OK. Para alterar configurações selecione 1. No menu Tools. Você pode configurar janelas de ferramentas no IDE para: • • • Mostrar ou ocultar automaticamente Guia Vínculo com outras janelas ferramenta Encaixar contra as bordas do IDE Visual Studio 343 . escolha Options. Partir do Tools menu. Janelas ferramenta e janelas de documento não podem ser agrupadas juntos no IDE. Consulte também Visual Studio Gerenciamento de janela O IDE (ambiente de desenvolvimento integrado) fornece várias ferramentas e opções para ajudá-lo a posicionar e mover entre janelas de documento e ferramenta.vssettings de grupo sempre que você iniciar o Visual Studio.O Visual Studio verifica que você estiver usando a versão mais recente do arquivo. 3. Janelas de documento são colocadas lado a lado-em painéis com guias. Esses tipos de janela dois se comportar de maneiras ligeiramente diferentes. Documentos com guias Você pode altera modos interface IDE usando o Geral. Quaisquer alterações feitas no arquivo.vssettings são aplicadas automaticamente.vssettings para uso em um grupo 1. caixa de diálogo Opções.vssettings de grupo. 5. O IDE usa esse modo por padrão. Ambiente. Na pasta Environment. Janelas de ferramentas Janelas de ferramentas são listados no menu View e são definidos pelo aplicativo atual e seus Add-ins. Insira um UNC ou caminho local. escolha Import and Export Settings. 2. Dois modos interface diferente são fornecidos para trabalhar com janelas de documento: Multiple documents modo e Tabbed documents modo. Tipos janela O ambiente de desenvolvimento integrado (IDE) contém dois tipos básicos janela: tool windows e document windows. Modo de interface Vários documentos Descrição O IDE fornece uma moldura pai que serve como um contêiner visual e lógica de todas as janelas de documento. Selecione Use team settings file. ou clique Browse para localizar o arquivo. Para especificar um arquivo. Clique OK para aplicar as configurações. 4. Você pode criar novas instâncias de uma janela ferramenta. Visual Studio 344 . escolha Dockable a partir do Window Menu. você pode exibir mais de uma ocorrência de determinadas janelas ferramenta ao mesmo tempo. Ambiente. Você pode organizar várias janelas de documento em grupos guia vertical ou horizontal e ordem facilmente aleatória documentos de um grupo guia para outro. com a janela mais alto-listada primeiro. Janelas dockable Em modo Tabbed. você pode exibir mais de uma janela do navegador. Além disso. Por exemplo. Você pode optar por trabalhar no modo documentos Tabbed (o padrão) ou no modo de interface documentos múltiplos (MDI). Dica Documentos com guias podem ser arrastados entre o IDE por suas guias. Janelas de documento Janelas de documento dinamicamente são criadas quando você abrir ou criar arquivos ou outros itens. Elas estendem sua capacidade para gerenciar espaço de trabalho limitado ao trabalhar com dois ou mais documentos abertos no IDE. ancorado Grupos guia Grupos guia estão disponíveis somente no Tabbed Documents modo. você pode tornar janelas de documento dockable ou undockable ao marcar ou desmarcar Dockable no menu Janela. Para obter mais informações. caixa de diálogo Opções. você poderá determinar como os botões fechar e AutoOcultar afetam um grupo de janelas de ferramentas ancorada juntos.• • Flutuar sobre Exibir em outros monitores Além disso. as janelas de documentos são undockable. Dica Determinados janelas de documento no IDE são realmente janelas ferramenta que têm a característica dockable está desativado. escolha Split No menu Window. escolhendo New Window no menu Window. Para essas janelas. Windows dividir Quando você encontrar mesmo que precisam exibir ou editar dois locais simultaneamente em um documento. Para dividir o documento em duas seções independentemente rolagem. Janelas tiled / Cascading O Windows pode ser lado a lado ou organizados em cascata pilhas somente no modo MDI. consulte Gerenciamento de janela. A lista de janelas de documento abertas é exibida no menu Window do atual na ordem z. Faça experiências com essas configurações para criar um documento edição ambiente que satisfaça suas necessidades e preferências. janelas de divisão podem ser útil. As maneiras em que você gerenciar as janelas de documento depende muito do modo de interface selecionado no Geral. Selecione Remove Split a partir do Window menu para restaurar a exibição única. No modo MDI. Ancorar janelas de ferramentas até a borda da moldura no IDE. COMO: Organizar e ancorar janelas O ambiente de desenvolvimento integrado (IDE) tem dois tipos de janelas: ferramenta janelas e janelas de documento. Escolha a Re-use current document window opção na página General do Environment Options. Essas opções estão disponíveis no Ajuda. muito semelhante janelas de ferramentas no IDE. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. Minimizar janelas de ferramentas ao longo da borda do IDE. Para obter mais informações sobre as diferenças entre janelas ferramenta e documentos. Para alterar as configurações. Você tem várias opções para organizar janelas no IDE. Ajudar a ferramenta janelas podem flutuar. caixa de diálogo Opções. Você pode aumentar a exibição e edição espaço para código. Por padrão. permitindo que cada novo documento você aberto substituir a última. consulte Tipos janela. Exibindo tópicos ajuda nas janelas É possível exibir tópicos Ajuda interna ou externamente. Visual Studio 345 . Observação Alterações para essas configurações só fazer terão efeito até que o IDE seja reiniciado. Para obter mais informações. Exibir janelas em monitores diferentes. incluindo o seguinte: • • • • • • Guia . dependendo do como você organizar as janelas no IDE. ajuda inicia tópicos da Ajuda em um programa externo chamado Microsoft Document Explorer. consulte Configurações do Visual Studio.Reutilizar janelas de documento Para reduzir o número de janelas abertos ao mesmo tempo. Observação Novos documentos será aberto no janela de documento atual para desde que o documento ativo não foi alterado. escolha Import and Export Settings No menu Tools.ancorado janelas de documento. você pode optar exibir todos os documentos inalterados na mesma janela do documento. Colocar janelas de documentos lado a lado. ou ser encaixado e fixado aberto ou defina para ocultar automaticamente quando não estiver em uso. Redefinir posicionamento janela para o layout padrão. Ambiente. ele flutua na parte superior de outras janelas das. Para janelas Editor ancorado 1. e você desejar ancorado Minimizar Windows da ferramenta Janelas de ferramentas. 4. caixa de diálogo Opções abre. 2. mova o ponteiro sobre a parte correspondente do losango guia Tópicos da janela aparece na área designada. Quando uma janela ferramenta é desencaixado ou não dockable. clique em Options. O losango guia permite-lhe encaixar rapidamente novamente uma janela ferramenta em um dos quatro lados de IDE. 2. minimizando janelas de ferramentas ao longo das bordas do IDE quando não estiver em uso. Expanda a Environment pasta. mova o ponteiro sobre à esquerda da versão o botão do mouse no losango guia. todos os que apareça no menu View. Ambiente. Ocultar automática só está disponível no modo vários documentos. 3.-lo. para que ele foco. Quando essa opção é definida. Visual Studio 346 . documentos abertos em instâncias do editor automaticamente são organizados em painéis com guias. As setas do losango quatro ponto em direção as quatro bordas de IDE. e selecione General. Ocultar automática permite-lhe ver mais do seu código ao mesmo tempo. ele pode ser encaixado para um lado de uma moldura em IDE. Um losango guia aparece quando você arrastar janelas de ferramentas do seu local atual para outro local no IDE. Clique na janela você deseja ocultar para que ele foco. Quando uma janela ferramenta estiver dockable. Em Window layout. versão o botão do mouse. Dica Para mover uma janela dockable sem ajustá-lo para o lugar. selecione a Tabbed documents opção. Para ancorado a janela em posição indicado. No menu Tools. suporte a um recurso chamado AutoOcultar. pressione CTRL ao arrastá-lo. Arraste a janela de ferramentas do seu local atual em direção ao meio de IDE. O Geral. clique em Dockable. você deve arrastar Solution Explorer para o meio do IDE. Um losango guia aparece. Para janelas de ferramentas ancorado 1.Encaixe Windows Editor janelas que exibem documentos podem ser organizadas em painéis com guias dentro do quadro de edição de IDE. Clique na janela ferramenta você deseja ancorado. No menu Window. se Solution Explorer está encaixado na borda direita do IDE ele na borda esquerda. 3. Quando você está arrastando a janela atingir a posição onde você deseja ancorado. Por exemplo. Para ativar AutoOcultar • 5. e. Para obter mais informações. caixa de diálogo Opções. Ocultar automática ativada Volta para sua guia quando uma janela hidden auto-perde o foco. clique em Auto Hide. Enquanto uma janela estiver hidden auto-. No menu Window. Para desativar AutoOcultar • • Clique na janela você deseja manter visíveis para que ele foco. selecione um item fora da janela atual. Para exibir uma janela hidden auto-. Dica Janelas de ferramentas que têm AutoOcultar ativado temporariamente slide no modo quando a janela tem foco. Ambiente. ele slides automaticamente na borda de IDE. ele slides volta fora de vista. ou —— Clique no ícone de anotações na barra de título da janela. ou —— Clique no ícone de anotações na barra de título da janela. clique Auto Hide para desmarcar a marca de seleção. Quando ela perde o foco. A janela slides no modo de exibição e está pronto para uso.• No menu Window. Visual Studio 347 . seu nome e ícone estão visíveis em uma guia na borda de IDE. Automática desativada ocultar Você pode controlar a velocidade em que esses transições ocorrem. consulte Geral. mova o ponteiro sobre o guia. Para ocultar a janela novamente. selecione a janela ferramenta você deseja ancorado. selecione a Multiple documents opção. ferramenta janelas podem ser minimizadas ao longo das bordas de IDE. Esta opção somente estará disponível em plataformas que dão suporte a vários monitores. Para colocar lado a lado janelas de documento • Se o IDE está sendo executado no Tabbed documents modo. 5. em seguida clique em Auto Hide Os slides janela volta para sua guia na borda de IDE. Ambiente. selecione uma guia e arraste-abaixo ou acima no lado de documento atual. Ambiente. No menu Tools. Em Window Layout. Expanda a Environment pasta. Dica Para mover uma janela dockable sem ajustá-lo para o lugar. pressione CTRL ao arrastá-lo pela tela monitor. 3. você pode colocar lado lado as janelas de documento. Selecionar OK. 4. Clique com o botão direito do mouse na janela ancorada ferramenta e. o Control Panel Consulte a Ajuda do Windows para obter mais informações. 7. clique em Options.Para ativar AutoOcultar para janelas de ferramentas 1. Observação Para determinar a Geral. caixa de diálogo Opções. Para exibir a janela. 2. 2. Usar as Display configurações em para configurar as configurações monitor vários. Tiling Windows do documento Se você deseja exibir mais de um documento ao mesmo tempo enquanto edita código. mova o ponteiro sobre sua guia na estrutura do IDE. caixa de diálogo Opções abre. Arraste a janela de ferramentas para o outro monitor. 6. você pode escolher que monitoram para exibir janelas no. No Multiple documents modo. seguida. se Auto Hide opera em janelas de ferramentas individualmente ou como ancorados grupos. ou —— Visual Studio 348 . consulte a Auto Hide button affects active tool windows only opção na Especificando um monitor Se você tiver um segundo monitor e seu suporta de plataforma usá-lo. Para colocar janelas de ferramentas em monitores diferentes 1. feche e reinicie Visual Studio. Quando Visual Studio funciona no vários modo documentos. e selecione General. Um contorno retangular aparece no local onde o novo lado de documento será colocado. O Geral. para e siga os procedimentos anteriores " " ancorado janelas de ferramentas. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. 2. consulte Geral. Para obter mais informações. uso uma das combinações de teclas de atalho atribuídas ao comando Window. Esta Visual Studio 349 . Redefinindo layouts da janela Você pode retornar o IDE para o layout janela original para a coleção configurações usando o Reset Window Layout comando. as seguintes ações ocorrem: • • • Todas as janelas são movidas para suas posições padrão. consulte Como: Alterar configurações selecionadas. ou pressione o atalho ALT+F7 e mantenha pressionado o ALT chave para exibir com o anteriormente arquivo ativo selecionado. Esta caixa de diálogo permite que você escolha rapidamente as janelas IDE e abrir arquivos você estiver usando.. Janelas que estão abertas no layout da janela padrão são abertas pelo comando. dependendo de suas configurações ativas ou da edição. Consulte também HOW TO: Windows IDE de lista e arquivos Active Como uma conveniência. clique em Reset Window Layout. No menu Windows. Para obter mais informações. clique no Windows menu e. Se o esquema de mapeamento do teclado padrão para o idioma em que você são programando atribui o atalho global CTRL + TAB para este comando. clique em Tile Horizontally ou Tile Vertically. você pode duas pressione este atalho e mantenha pressionada a tecla CTRL para exibir com a janela IDE anterior selecionada. Você pode especificar um layout janela padrão diferente. (IDE) o Ambiente de Desenvolvimento Integrado do Visual Studio fornece um IDE Navigator. Para redefinir posicionamento janela para o layout padrão 1. Com o anteriormente arquivo ativo selecionada. ou pressione o atalho ALT+F7 e mantenha pressionado o ALT chave para exibir com a janela IDE anterior selecionada o IDE Navigator o IDE Navigator o IDE Navigator o IDE Navigator Se o esquema de mapeamento do teclado para o idioma de desenvolvimento não incluir uma ligação chave para o Window. em seguida.NextDocumentWindowNav. você pode remapear o atalho para este comando na página Keyboard na pasta Environment da caixa Options de diálogo. Janelas que estão fechadas no layout janela padrão são fechadas pelo comando. Para exibir o IDE Navigator.• Se você tiver definido o IDE para usar o Multiple documents layout janela. clique em Yes.NextDocumentWindowNav Comando. caixa de diálogo Opções. Para obter mais informações. consulte Como: Trabalhar com combinações de teclas de atalho. ou se você preferir usar um ícone diferente. Na caixa de mensagem. modificando as configurações atuais. Quando você executar este comando. Ambiente. 2. Continuar a mantenha pressionada a tecla CTRL. Fechar. Consulte Caixa de diálogo do Windows Visual Studio () Esta caixa de diálogo permite que você para exibir. Pressione a tecla TAB para mover para baixo na Active Files lista. escolha Import and Export Settings No menu Tools. escolhendo Windows no Window menu. Name (Nome) Visual Studio 350 . Para exibir ou alterar as configurações.NextDocumentWindowNav comando. ou pressione SHIFT+F7 para mover de volta backup essas listas. Pressione a tecla F7 para mover para baixo e Active Files listas. escolha Import and Export Settings No menu Tools. 3. Você pode exibir esta caixa de diálogo. A IDE Navigator Fecha. e o item selecionado é exibida. 3. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. consulte Configurações do Visual Studio. e o item selecionado é exibida. A IDE Navigator Fecha. Quando você tenha selecionado o nome do item desejado. Para selecionar um item em uma lista do Windows e arquivos aberta com ALT+F7 1. versão a tecla ALT. versão a tecla CTRL. O IDE Navigator é exibida com o arquivo anterior selecionado. 2. Continuar a mantenha pressionada a tecla ALT. Para obter mais informações. e organizar documentos que estão abertos no editores e projetistas. Para obter mais informações. Pressione o atalho ALT+F7 para executar o Window. ou esquerda e direita para colunas adjacentes. consulte Configurações do Visual Studio. o IDE Windows -Ou-Pressione as teclas SETA para mover acima e abaixo essas listas. O IDE Navigator é exibida com a janela IDE anterior selecionada. -Ou-Pressione as teclas SETA para mover acima e abaixo esta lista. Para alterar as configurações.página Ajuda foi gravada com configurações Visual C# em mente. Pressione atalho CTRL + TAB para executar o Window. ou pressione SHIFT+TAB para mover de volta backup desta lista.NextDocumentWindowNav comando. Para selecionar um item em uma lista do Windows e arquivos aberta com as teclas CTRL+TAB 1. Quando você tenha selecionado o nome do item desejado. dependendo de suas configurações ativas ou da edição. ou esquerda e direita para colunas adjacentes. caixa de diálogo Opções nomes e o de dois ou janelas mais abertas são selecionadas. caixa de diálogo Opções nomes e o de dois ou janelas mais abertas são selecionadas. Colunas exibidas Uma lista em ordem alfabética ordenada das colunas exibidas na janela pai do momento. Redefinir Do Available Columns redefine e Displayed Columns listas para conter as colunas que eles contidos quando a caixa de diálogo foi exibida. Janelas normalmente não tem um caminho. os Geral. Disponível quando a opção " de ambiente " MDI (Interface de Documentos Múltiplos) estiver ativada no. Ativar Faz o documento ou ferramenta Janela selecionado o item ativo no editor ou Designer. Path Exibe o caminho completo para documentos. Lado a lado horizontalmente Exibe as janelas selecionadas um em cima do outro. Quando você fechar a caixa de diálogo. Ambiente. Fechar janelas Fecha os documentos selecionados e janelas em Da lista.Exibe os nomes das janelas de documentos e ferramenta. Lado a lado verticalmente Exibe a lado-a-lado Janelas selecionadas. Colunas disponíveis Uma lista em ordem alfabética ordenada das colunas que você pode exibir na janela pai. Consulte também Caixa de diálogo colunas Determina as colunas que irá ser exibidas na janela do qual a Columns caixa de diálogo é exibida. Visual Studio 351 . os Geral. Add Move as colunas selecionadas na caixa Available Columns para a Displayed Columns Caixa. as colunas são exibidas na janela do qual você exibida esta caixa de diálogo. Do Move Up clicando no Reset botão também desfaz quaisquer alterações de classificação que você fez usando e Move Down Botões. Remover Remove as colunas selecionadas da lista Displayed Columns para a Available Columns Lista. com o item ativo selecionado. Disponível quando a opção " de ambiente " MDI (Interface de Documentos Múltiplos) estiver ativada no. Ambiente. Mover para cima Move a coluna selecionada uma posição acima na ordem de exibição. e defina como a escolhida colunas são classificados Colunas de classificação Lista as colunas que serão classificadas na caixa de diálogo pai. Mover para cima Move o item selecionado cima na ordem de classificação. Mover para baixo Move a coluna selecionada uma posição na ordem de exibição abaixo. Remover Remove o item selecionado da lista de colunas a ser classificado.Adicionar tudo Move todas as colunas na lista Available Columns para a Displayed Columns Lista. Consulte também Caixa de diálogo colunas de classificação Caixa Sort Columns de diálogo determina como informações é organizado e exibida na janela pai através do qual a caixa é chamada. Decrescente Especifica que os itens na coluna selecionada serão classificados em ordem decrescente. especificar a ordem em que colunas são exibidas. Consulte Visual Studio 352 . Você pode usar a Sort Columns caixa para escolher colunas. Add Move o item selecionado da lista All Columns para a Sort Columns Lista. Mover para baixo Move o item selecionado para baixo na ordem de classificação. Remover tudo Move todas as colunas na lista Displayed Columns para a Available Columns Lista. Crescente Especifica que os itens na coluna selecionada serão classificados em ordem crescente. Todas as colunas Lista as colunas que podem ser classificadas na caixa de diálogo pai. janelas são colocadas lado a lado-em painéis com guias como eles são abertos Esse modo IDE padrão simplifica para percorrer os documentos que você está editando. O IDE fornece várias maneiras para mover rapidamente entre documentos abertos. Ou você pode ter criado ferramentas que você deseja usar no ambiente Visual Studio de desenvolvimento integrado (IDE). Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê podem diferir do que é descrito na Ajuda. consulte HOW TO: Windows IDE de lista e arquivos Active. Esta página Ajuda foi gravada com General Development Settings em mente. consulte Navegar através de código. Do IDE Navigator você pode usar para mover rapidamente para documentos que você está editando e para abrir janelas de ferramentas. Para obter informações sobre como salvar uma lista pessoal de útil tópicos de ajuda. Por exemplo. Pressione CTRL + SHIFT + TAB para ativar documentos abertos na ordem inversa. Estendendo o ambiente Visual Studio Embora Visual Studio você talvez precise um nível de controle adicionais ou maiores.. convém automatizar uma tarefa ou uma série de tarefas que você executar regularmente. Consulte também Automação e extensibilidade para Visual Studio Automação e extensibilidade se refere a capacidade de forma programática automatizar tarefas repetitivas e estender (IDE) o Visual Studio ambiente de desenvolvimento integrado com ferramentas como os suplementos e assistentes. Para obter mais informações sobre exibição e uso o IDE Navigator. Para obter informações sobre marcando e localizando locais específicos em arquivos. Para alterar as configurações. Para percorrer documentos abertos por ordem de uso • • Pressione CTRL + TAB para ativar documentos abertos na ordem que eles foram mais recentemente toucheds. escolha Import and Export Settings No menu Tools. Para obter mais informações. Ambiente. consulte Configurações do Visual Studio. Os tópicos a seguir explicam como usar os diversos modelos de programação para fazer isso. caixa de diálogo Opções. consulte Ajudar a janela de favoritos (Ajuda Explorer documento Microsoft). dependendo de suas configurações ativas ou da edição. Selecionar Windows do documento Se você tiver Tabbed Documents Modo selecionado no documento Geral. Visual Studio 353 . oferece várias ferramentas e a energia para executar quase cada tarefa.COMO: Navegar dentro do ambiente de desenvolvimento integrado O IDE (ambiente de desenvolvimento integrado) foi criado para tornar mais fácil de mover a janela da janela e documento ao documento. Toolwindows. fornecendo acesso fácil às janelas ferramenta no IDE em seus tipos nativos. Basta copiar o arquivo de Registro XML para as pastas apropriadas para Visual Studio para localizar e carregar o suplemento. janelas de ferramentas Visual Studio podem ser acessadas através das propriedades membro. você arquivos XML uso agora para definir as configurações de Registro para Add-ins. eventos. Quando você criar Add-ins. depuradores. Cada modelo contém tipos e membros que representam soluções.Para resolver esses problemas. o editor de código. Para obter mais informações. suplementos.CreateToolWindow2 Novo CreateToolWindow2 método torna mais fácil para criar suas próprias janelas de ferramentas personalizada que hospedam os controles do usuário. Conseqüentemente. Com esses modelos.Toolwindows Novo EnvDTE80. você pode acessar os componentes e eventos dentro do Visual Studio ambiente de desenvolvimento integrado (IDE) e seus projetos subjacente. Os arquivos contêm comentários que descrevem as marcas vários. como as janelas ferramenta. o DTE. e assim por diante. programável. automatizar tarefas repetitivas. Os modelos de objeto possam ser acessados por qualquer um dos quatro métodos:. o Código gerenciado Add-ins Add-In Wizard oferece suporte agora em C++. que ajudam a facilmente localizar e editar suas configurações. o DTE2. assim. janelas de ferramentas. Ele melhora a descoberta e usabilidade de janelas de ferramentas no modelo de objeto.ToolWindows objeto também está disponível como a EnvDTE80. documentos. O que há de novo no extensibilidade e automação do Visual Studio 2005 Apresenta Visual Studio uma série de modelos de objeto de destino. consulte Add-in de registro. Não Ferramentas opções gerenciados Opções ferramentas para código gerenciado.DTE2. assistentes. objetos de código.ToolWindows propriedade. Um controle correção é não mais necessário. para estender e automatizar o IDE recursos. As seções abaixo apresentar a você para automação e extensibilidade e mostram como usá-los para facilitar a programação. Visual Studio Rich modelos de programação conhecidos como os modelos de objeto de automação. e integrar outros aplicativos ao IDE. Visual Studio 354 . projetos. o Add-In Manager. Macros. Os modelos automação vários fornecem a capacidade para automatizar o ambiente e fornecer extensões e novos recursos a ela. há novas opções no menu • • • • • a Suplemento Assistente e Visual J# Add-In Wizard agora oferece suporte criando Add-ins usando Visual J# e Visual C++ 2005. o . Outras janelas ferramenta podem estar localizadas com a nova GetToolWindow Função. editores de código. e o Visual Studio Industry Partner (VSIP) program Novo para Visual Studio 2005 Os Visual Studio modelos de automação têm o seguintes alterações e novos recursos: • Rather Registro suplemento XML que registrar componentes no Registro do Windows. vários projetos.NET Framework como obter recursos de gerenciado Satellite DLLs. você pode estender a funcionalidade de IDE. usando esse arquivo é criado automaticamente. e mais. Cada modelo concentrates a uma área específica do IDE. consulte Add-in de segurança e Segurança macros e compartilhamento questões.. o Localizar síncrona EnvDTE80. como controles caixa de listagem. fazer para uma experiência mais consistente de programação. Para obter mais informações. • • • • • • • • • • • Visual Studio 355 . add-ins são criados usando os modelos Japonês (se eles estão disponíveis). consulte Novos membros de automação para Visual Studio 2005.TextDocumentKeyPressEventsClass. São Pastas de Solução (Solution Folders) recipientes do projeto que permitem a você para organizar melhor aplicativos grandes. e controles menu drop-down.dll) Para obter mais informações. além de projetos.EditPoint2.TextDocumentKeyPressEvents objeto que tem dois eventos para lidar com entradas pressionamento de de Tecla no Editor: EnvDTE80. eles são disponíveis no objeto Window da janela da ferramenta.Int32) método para inserir linhas em documentos no editor.InsertNewLine(System. eliminando dependência na biblioteca Microsoft Office (Mso. Todos Consistência do modelo de código os idiomas de programação em Visual Studio Uso do código principal Modelo em relação a versões anteriores.WaitForFindToComplete. Embora essas barras de ferramentas não estão disponíveis a partir da CommandBars coleção no objeto DTE. o AddNamedCommand avançada Novo EnvDTE80. Para obter mais informações. Soluções Pastas de solução agora podem conter pastas Solution. controles da caixa de edição da.VisualStudio.CommandBars.Find Objeto oferece uma nova propriedade EnvDTE80. que permite a você para especificar se uma pesquisa é executada de forma síncrona ou assincronamente Algumas Suporte barra Comando Janela ferramenta janelas ferramenta incluem uma barra de ferramentas para acessar sua funcionalidade. se você estiver executando japonês Visual Studio. consulte Alterações CommandBar para o Visual Studio 2005. Funcionalidade barra comando Novo conjunto barra de comando foi movida para um novo Visual Studio conjunto.BeforeKeyPress e EnvDTE80. Microsoft. Por exemplo.TextDocumentKeyPressEventsClass. apenas. como somente texto. o Método InsertNewLine modelo de automação Editor oferece um novo EnvDTE80. ícone ou texto e ícone.vsCommandControlType Parâmetro em AddNamedCommand2 agora permite-lhe especificar o estilo de um botão. e onde Visual Studio procura por arquivos de configuração. Você também pode criar tipos adicionais de controles para colocar nas barras de ferramentas e menus. Um Adições do modelo principal Novo conjunto chamado EnvDTE80 contém um número de novos membros de automação. Agora você Add-in e segurança de macro pode especificar se as macros são permitidas para executar. e o Assistente para Adicionar-in gera Add-ins com o idioma apropriado.• o Eventos KeyPress modelo de automação Editor oferece um novo EnvDTE80.Find2. se os suplementos têm permissão para carregar.DTE2..AfterKeyPress. Macros de exemplo Localização agora estão localizadas.AddIn. do Lista de tarefas (Visual Studio) Agora você Tarefas de navegação padrão lista pode ir diretamente para linhas de código clicando duas vezes em itens em sem que seja necessário fornecer código adicional. os suplementos criados no Visual Studio . Modelos de automação do Visual C++ A seguir é uma lista de novos tipos e membros para os Visual C++ modelos de automação.NET 2003 e que consultar esses podem bibliotecas. Isso ajuda a evitar quebrar o código existente que depende as montagens antigas permitindo você a atualizar os aplicativos com a nova funcionalidade. Mais Mais código exemplo Tópicos da Ajuda para os diversos modelos de objeto de automação agora recurso código de exemplo. A biblioteca originais e inalterados usado nas versões anteriores do Visual Studio — Como. VSLangProj e VSLangProj2 — são incluídos. Muitos deles têm ambas Visual Basic e Visual C# código. consulte Novos membros de automação para Visual Studio 2005. VSLangProj80 Este tópico lista todos os seus novos tipos e membros.NET 2002 ou Visual Studio . Para preservar compatibilidade com versões-e facilitar Migração de código. o modelo de projetos / criar contido em Microsoft.VCProjectEngine. seu projeto deve incluir uma referência para EnvDTE80.VisualStudio. na maioria dos casos. • Automação e extensibilidade do Visual Studio Novos membros de automação para Visual Studio 2005 Este tópico contém uma lista de todos os tipos novos para todos os modelos de automação (principais e idioma) em Visual Studio. conseqüentemente. e Visual J# Modelos de automação do projeto está em um novo conjunto.NET 2003 na maioria dos casos. Este tópico lista todos os seus novos tipos e membros. As bibliotecas originais e inalterados usados nas versões anteriores do Visual Studio — ou seja. para Visual Basic.VCProject e Visual Studio 356 . Se você desejar acessar qualquer uma da nova funcionalidade. ser migrados para Visual Studio 2005. os suplementos criados no Visual Studio . Conseqüentemente. Ela inclui: • Microsoft. ser migradas para Visual Studio 2005. Para obter mais informações.. no entanto.• Um Adições do modelo de idioma Novo conjunto chamado VSLangProj80 contém um número de novos membros de automação. EnvDTE — está incluído. Visual C#. na maioria dos casos a nova funcionalidade foi adicionada aos novos conjuntos.VisualStudio. Visual C# e Visual J#. Visual Basic C# / Model automação Project Visual J# / Visual Nova funcionalidade para todos os o Visual Basic. Comentários Existem atualizações para as áreas Recurso de automação a seguir: • • • Modelo de automação principal Visual Studio / Visual BasicVisual C# Projeto Modelo de automação Modelos de automação Visual C++ Modelo de automação Core Studio Visual Nova funcionalidade para o Visual Studio modelo de automação principal está em um novo conjunto. Pode. se você desejar. EnvDTE80. Adiciona Visual Studio 2005 uma grande quantidade de funcionalidade a Automação e atualiza funcionalidade existente.NET 2002 ou o Visual Studio . VisualStudio.VCCodeModel.VisualStudio.• o modelo de código contido em eo modelo Assistente contido em Microsoft. • Microsoft.VsWizard. Nome Tipo compileAsManagedOptions enum Novos membros managedAssemblyPure managedAssemblySafe managedAssemblyOldSyntax Enum BuildWithPropertySheetType compilerErrorReportingType enum eCLRImageType enum eCLRThreadAttribute enum cppExceptionHandling enum eDebuggerTypes enum driverOption enum eFileType enum Todos Todos Todos Todos Todos Todos Todos eFileTypeCSharpFile eFileTypeClassDiagram eFileTypeMHT eFileTypePropertySheet eFileTypeCUR eSqlClrPermissionLevel enum eWebRefUrlBehavior enum floatingPointModel enum linkerErrorReportingType enum Enum LinkTimeCodeGenerationOption machineTypeOption enum Todos Todos Todos Todos Todos machineAM33 machineARM machineEBC machineIA64 machineM32R machineMIPS machineMIPS16 machineMIPSFPU machineMIPSFPU16 machineMIPSR41XX machineSH3 Visual Studio 357 . SET) ShowNoMatchingRuleDialog (GET &amp. SET) ToolFileSearchPaths (GET &amp.machineSH3DSP machineSH4 machineSH5 machineTHUMB machineAMD64 midlTargetEnvironment enum subSystemOption enum midlTargetIA64 subSystemNative subSystemEFIApplication subSystemEFIBootService subSystemEFIROM subSystemEFIRuntime subSystemPosix subSystemWindowsCE Enum WholeProgramOptimizationTypes IVCBuildOptionsPage Todos ExtensionsToInclude (GET & SET) ExtensionsToHide (GET &amp. SET) IVCWizCtl IVCWizCtlUI Todos DatabaseConnection SuspendParsing ResumeParsing DoesFileOrDirectoryExist solutionExplorerMode VCActiveXReference Todos WrapperSuccessfullyGenerated (get) GenerationErrorMessage (get) VCCLCompilerTool ErrorReporting (GET & SET) EnablePREfast (GET &amp. SET) Visual Studio 358 . SET) ValidateSchemas (GET &amp. SET) floatingPointModel (GET &amp. SET) DefaultSolutionExplorerMode (GET &amp. SET) ShowMatchingRuleDialog (GET &amp. SET) GenerateXMLDocumentationFiles (GET &amp. SET) FloatingPointExceptions (GET &amp. OmitDefaultLibName (GET &amp. SET) OpenMP (GET &amp. SET) UseFullPaths (GET &amp. SET) VCCodeBase VCCodeClass Referências AddTemplateParameter RemoveTemplateParameter TemplateParameters Referências VCCodeElement VCCodeEvent Referências IsVirtual IsShared Funções VCCodeFunction AddTemplateParameter RemoveTemplateParameter TemplateParameters IsSealed Referências VCCodeModel DotNetNameFromLanguageSpecific LanguageSpecificNameFromDotNet ElementFromID VCCodeParameter IsConstant IsVolatile VCCodeProperty IsTrivial IsVirtual IsShared Funções Parâmetros VCCodeReference VCCodeStruct Todos AddTemplateParameter RemoveTemplateParameter TemplateParameters Referências Visual Studio 359 . SET) XMLDocumentationFileName (GET &amp. SET) UseUnicodeResponseFiles (GET &amp. SET) SqlPermissionLevel (GET &amp. SET) MPIAcceptFilter (GET &amp. SET) SqlPostDeployScript (GET &amp. SET) MPIRunArguments (GET &amp. SET) MPIRunWorkingDirectory (GET &amp. SET) MPIAcceptMode (GET &amp.VCCodeTypedef VCCodeVariable Referências Referências IsVolatile VCConfiguration BuildLogFile (GET & SET) BuildWithPropertySheet BuildWithPropertySheetPath ClearToolProperty Implantar DeploymentTool (get) ExcludeBuckets (GET & SET) InheritedPropertySheets (GET &amp. SET) SqlPreDeployScript (GET &amp. SET) EnvMerge (GET &amp. SET) ShimCommand (GET &amp. SET) IntrinsicPropertySheets (GET &amp. SET) VCDirectories Todos Visual Studio 360 . SET) MPIRunCommand (GET &amp. SET) SqlDeploySource (GET &amp. SET) PropertySheets (get) Vincular novamente SqlAssemblyOwner (GET & SET) SqlDebugScript (GET &amp. SET) WaitForBuild VCCustomBuildRule VCDebugSettings Todos ApplicationArguments (GET & SET) ApplicationCommand DebuggerFlavor (GET & SET) Env (GET &amp. SET) ManifestFile (GET &amp. SET) LinkLibraryDependencies (GET &amp. SET) ErrorReporting (GET & SET) GenerateManifest (GET &amp. SET) UseLibraryDependencyInputs (GET &amp. SET) VCManagedResourceCompilerTool VCManifestTool VCNMakeTool AdditionalOptions (GET & SET) Todos AssemblySearchPath (GET & SET) CompileAsManaged (GET &amp. SET) CLRImageType (GET &amp. SET) CLRThreadAttribute (GET &amp.VCFile VCFileCodeModel UnexpandedRelativePath IsManaged IsMCOldSyntax VCFileCodeUnion AddTemplateParameter RemoveTemplateParameter TemplateParameters Referências VCFilter Remove() UrlBehavior (get) VCLanguageManager VCLibrarianTool CompareTokenStreams UseUnicodeResponseFiles (GET &amp. SET) UseUnicodeResponseFiles (GET &amp. SET) ProfileGuidedDatabase (GET &amp. SET) KeyContainer (GET &amp. SET) AssemblyLinkResource (GET &amp. SET) DelaySign (GET &amp. SET) Driver (GET &amp. SET) Visual Studio 361 . SET) Profile (GET &amp. SET) Entradas (get) LinkTimeCodeGeneration (GET & SET) VCLinkerTool AdditionalManifestDependencies (GET & SET) AllowIsolation (GET &amp. SET) KeyFile (GET &amp. SET) ForcedUsingAssemblies (GET &amp. SET) Visual Studio 362 . SET) PreprocessorDefinitions (GET &amp. SET) DelaySign (GET &amp. SET) FullPath (get) GenerateManifests (GET & SET) IncludeHeaderFile LoadUserFile MakeManagedDBConnection ManagedDBConnection (GET & SET) ManagedDBProvider (GET &amp. SET) VCPlatform CommitChanges DebuggerTool (get) DefaultDirectory (get) DeploymentTool (get) DisableAlternateDebuggers (get) DumpfileExtensions (get) ExcludeDirectories (GET & SET) ExecutableExtensions (get) GeneralPageTool (get) GetMacroValue GetToolNameForKeyword IsDumpfile IsExecutable NumberOfPlatformMacros (get) PlatformMacro (get) vcprojCATIDS VCProject Todos AddToolFile AssemblyOriginatorKeyFile (GET & SET) AssemblyReferenceSearchPaths (GET &amp.ForcedIncludes (GET &amp. SET) ManifestKeyFile (GET &amp. SET) IncludeSearchPath (GET &amp. SET) ExcludedPermissions (GET &amp. SET) ManifestCertificateThumbprint (GET &amp. SET) VCProjectReference IsProjectLoaded VCPropertySheet (VCStyleSheet anteriormente) BuildLogFile (GET & SET) FileEncoding ConfigurationType ClearToolProperty Salvar UserMacros AddUserMacro RemoveAllUserMacros VCReference UseInBuild (GET & SET) SET VCReferences () AssemblyName (get) SubType (GET & SET) UseDependenciesInBuild (GET &amp. SET) SignManifests (GET &amp. SET) RemoveToolFile SaveUserFile ShowAllFiles (GET & SET) SignAssembly (GET &amp. SET) TargetZone (GET &amp. SET) ToolFiles (get) VCProjectConfigurationProperties VCProjectEngine OutputPath AddFakeProps CreatePropertySheet CreateToolFile LoadPropertySheet LoadToolFile PropertySheets RemovePropertySheet ToolFiles (get) ToolFileSearchPaths (GET &amp. SET) ValidateSchemas (GET &amp.ManifestTimestampUrl (GET &amp. SET) Visual Studio 363 . SET) CopyLocalDependencies (GET &amp. SET) CopyLocal (GET &amp.CopyLocalSatelliteAssemblies (GET &amp. SET) VCReferences Referências (get) AddAssemblyReferenceWithStrongName CanAddAssemblyReferenceWithStrongName AddProjectReferenceByIdentifier CanAddAssemblyReferenceByIdentifier AddReferenceToFile CanAddReferenceToFile VCRuntimeBooleanProperty VCRuntimeEnumProperty VCRuntimeEnumValue VCRuntimeIntegerProperty VCRuntimeProperty VCRuntimeStringProperty VCToolFile VCUserMacro VCXDCMakeTool Todos Todos Todos Todos Todos Todos Todos Todos Todos A seguir estão tipos e membros que foram removidos da Visual Studio 2005. Nome Tipo genProxyLanguage enum pchOption enum Enum RemoteDebuggerType Membros excluído genProxyCs pchGenerateAuto RemoteLocal RemotePipe runtimeLibraryOption enum rtSingleThreaded rtSingleThreadedDebug VCActiveXReference SET ControlGUID () SET ControlVersion () SET ControlLocale () VCAssemblyReference VCAuxiliaryManagedWrapperGeneratorTool VCCodeClass SET RelativePath () Todos AddEvent Templateization (get) VCCodeFunction Templateization (get) Visual Studio 364 . SET) OptimizeForProcessor (GET &amp. SET) BuildBrowserInformation (GET &amp. SET) OptimizeForWindowsApplication (GET &amp. SET) SET StyleSheets () ReferencesPath (GET & SET) FullReferencesPath (get) ReferenceTools (get) VCDesignerReference VCFileCodeModel VCFilter VCManagedWrapperGeneratorTool VCPrimaryInteropTool VCProjectConfigurationProperties VCProjectEngine VCProjectReference Todos Sincronizar Excluir Todos Todos BuildBrowserInformation (GET &amp. SET) RemoveProject NativeOutputForConfiguration SET ReferencedProjectIdentifier () SET ReferencedProject () VCReference BaseFileNameForConfiguration BuildNumberForConfiguration CultureForConfiguration FullPathForConfiguration MajorVersionForConfiguration MinorVersionForConfiguration Nome (set) PublicKeyTokenForConfiguration ReferenceConfigurations ReferenceIsManaged RevisionNumberForConfiguration StrongNameForConfiguration Visual Studio 365 .VCCodeStruct VCCodeUnion VCCLCompilerTool Templateization (get) Templateization (get) GlobalOptimizations (GET & SET) ImproveFloatingPointConsistancy (GET &amp. SET) VCConfiguration AppliedStyleSheets (GET &amp. SET) Cultura Descrição FullPath Identidade Visual Studio 366 .VersionForConfiguration VCReferenceconfiguration VCStyleSheet (changed to VCPropertySheet Todos Plataforma BuildBrowserInformation (GET &amp. SET) ToolSet (GET & SET) ReferencesPath (GET & SET) A seguir estão tipos e membros que foram alterados no Visual Studio 2005. Nome Tipo Membros alterados Alteração Era managedAssembly = 2 Alteração de nome membro Alteração de nome membro Era pchNone Parâmetro adicionado Era NonBrowsable Parâmetro digite alteração Parâmetro digite alteração Parâmetro digite alteração Parâmetro digite alteração Parâmetro digite alteração Parâmetro digite alteração Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de compileAsManagedOptions enum managedAssembly midlTargetEnvironment enum genProxyLanguage enum pchOption enum IVCProjectEngineEvents VCActiveXReference VCConfiguration midlTargetWin64 (midlTargetAMD64 agora) genProxyManagedCpp (genProxyManaged agora) pchNone = 0 ItemPropertyChange WrapperTool ManagedExtensions (GET & SET) WholeProgramOptimization (GET & SET) VCCLCompiler VCLinkerTool ExceptionHandling (GET & SET) LinkTimeCodeGeneration (GET & SET) VCProjectConfigurationProperties WholeProgramOptimization (GET & SET) ManagedExtensions (GET & SET) VCReference BuildNumber CopyLocal (GET &amp. parâmetro Label MajorVersion MinorVersion Nome (get) PublicKeyToken Referência RevisionNumber StrongName Version VCReferences AddAssemblyReference AddActiveXReference AddProjectReference RemoveReference Contagem VCStyleSheet / VCPropertySheet StyleSheetName (PropertySheetName agora) StyleSheetFile (PropertySheetFile agora) AppliedStyleSheets (InheritedPropertySheets agora) ManagedExtensions StyleSheetDirectory (PropertySheetDirectory agora) PropertySheet (get) VCXMLDataGeneratorTool GeneratedProxyLanguage (GET & SET) (now Namespace) Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome de parâmetro Parâmetro digite alteração Alteração de nome de parâmetro Alteração de nome de parâmetro Alteração de nome membro Visual Studio 367 . Visual Studio 368 . Usando caminhos embutidas. não assumir que como seu código usa somente funções de API que são consideradas " seguros " que seu aplicativo é automaticamente segura e protegida. imprevistas. Alguns podem estar inerentemente arriscada na forma que eles funcionam. Código que é inicialmente projetado e criado com segurança em mente é mais robusto que código escrito com segurança que é adicionada como um afterthought. somente especialmente se o aplicativo ficar muito popular. . comprometer seus dados. Um aplicativo seguro protege a confidencialidade. mais atraente para usuários.. bem Negligent práticas de programação podem expor seu aplicativo para como risco ou muito mais do que usar funções supposedly " perigosas ". Além disso. Utilizando seqüências de conexão embutidas. bem. e menor custo para corrigir e suporte. Há benefícios para criar aplicativos seguros. além disso. APIs arriscada Algumas funções API podem ser consideradas mais arriscadas que outros do ponto de vista de segurança. Aplicativos com segurança projetados são também mais resistente a criticism de mídia. Tais práticas podem incluir: • • • Não tratamento exceções corretamente. integridade. e disponibilidade de informações a clientes '.ou Suponha confiança ungranted. Além disso. Criar.Práticas recomendadas para segurança na automação Os desenvolvedores de automação Visual Studio devem compreender e aceitar a responsabilidade de criação de aplicativos seguros por noções básicas sobre vulnerabilidades de segurança. e se eles representam qualquer classificação de risco de segurança. Outras pessoas podem ser arriscadas se não chamado ou manipulados corretamente. regular. uma vulnerabilidade de segurança é uma falha em um produto que permite um invasor — mesmo quando o produto é usado corretamente — para: • • • apropriado privilégios no sistema do usuário. gravar. Para fins de discussão. protege a integridade e disponibilidade de recursos de processamento. configuração. O ponto é que você deve estar familiarizado com as armadilhas e quirks das várias funções API você chamar. e testar seu código de acordo. Suponha que seu código será executado nos ambientes hostis mais ser em vez disso. que controla proprietário ou administrador do sistema.. Possibilidade é proporcional que ele será usado em outro. Importante • Nunca pressupõem que será o aplicativo ser executado em alguns ambientes determinados. alterar ou redirecionar sua operação. assegurar que elas são usadas corretamente. editar e depurar macros.asp?url=/library/enus/dnnetsec/html/seccodeguide..com/library/default. Para informações. Ele usa o Visual Basic idiomas e é usado para criar. Para obter mais informações sobre macros. Outro ponto importante para compreender é que muitos problemas de segurança resultar de aplicativos que blindly confiam entrada dados. Completamente para proteger seus aplicativos. As linguagens de programação vários em Visual Studio fornecem objetos de automação adicionais por seus próprios conjuntos. Do EnvDTE são objetos COM que implementam a IDTExtensibility2 interface e se comunicar com o IDE através do modelo de objeto de automação principal que está contido em. As montagens de automação específicas projeto são: Nome do conjunto VSLangProj Descrição Visual BasicVisual C# e Visual J# projeto modelo de automação. Visual Studio 369 . você deve entender questões de segurança de código por pesquisar o assunto. O livro da Microsoft Press. Consulte também O espectro de automação Visual Studio oferece Visual Studio três níveis diferentes de extensibilidade:. consulte Add-in de segurança. O modelo de ferramentas estão contido no Microsoft. entretanto..VisualStudio. e EnvDTE80 montagens. Lembre-se.CommandBars.ou • Não verificando credenciais de usuário correta ou permissões. Recursos de segurança de automação Além de seguir estas diretrizes. Em vez disso.asp são recursos boas. Os suplementos e assistentes Os suplementos são aplicativos tempo-economia labor e anexar a e são usados dentro do Visual Studio ambiente de desenvolvimento integrado (IDE).NET cuidadosamente antes de criar seus aplicativos de automação. Writing Secure Code. elas também permitem que você para saber os Visual Studio modelos automação durante a gravação macros.microsoft. eles são um bom começo. Macros. consulte Automatizar ações Repetitive usando macros. que eles são não um panacea de todos problemas de segurança. Pesquise e seguir diretrizes de segurança . Não somente eles fornecem um aumento grande de produtividade permitindo que você para registrar várias ações no IDE e executá-las novamente como um único comando. e o Visual Studio Industry Partner (VSIP) program Macros Macros são a maneira mais fácil para estender (IDE) o Visual Studio ambiente de desenvolvimento integrado com o código. Visual Studio automação oferece algumas maneiras simples e específicos para ajudá-lo a proteger seu sistema de automação exploitations de segurança. suplementos e assistentes. É essencial que os aplicativos cuidadosamente examinar e avaliar dados como ele é recebido para verificar se os dados é válido e confiável antes de usá-lo. Macros também oferecem um ambiente de desenvolvimento Full-fledged chamado o IDE macros que seja baseado em Ide Visual Studio. e o site diretrizes codificação de segurança em http://msdn. Visual BasicVisual C# e Visual J# projeto modelo de automação. Microsoft. • Criar páginas de propriedades personalizadas para a Options caixa de diálogo no menu Tools.VCCodeModel Microsoft..VisualStudio. Microsoft. como os ISVs. Você pode implementar Add-ins em qualquer idioma consuming com tal.VSLangProj2 VSLangProj80 Microsoft..VisualStudio. Assistentes são aplicativos que levar usuários através de um processo de criação programas ou realizar tarefas de programação que são mais difíceis ou complicado que usual Instruções passo. Do New Project assistentes são geralmente chamados através de ou New File caixas de diálogo. Modelo de automação de código Visual C++. Para obter mais informações. Para a maioria dos desenvolvedores. sua propriedade intelectual é protegida.VCProjectEngine Projeto Visual C++ Modelo de automação. binário. Visual C# como Visual C++. Visual Basic e assim por diante. Para obter mais informações. as macros são suficientes para programação com o Visual Studio modelo de automação. você pode: • Hospedar sua ferramenta de uma menu ou barra de ferramentas no IDE. add-ins pode ser preferível para desenvolvedores.VsWizard Modelo de automação Assistente Visual C++. Em alguns casos. Add-ins também permite que sejam fazer algumas coisas que não podem macros. Como Add-ins são código compilado. • Criar janelas de ferramentas que agem como Visual Studio janelas de ferramentas. consulte Como Adicionar e identificador comandos:. Isso permite que você para facilmente acessá-lo enquanto você está programando. consulte Criando e Controlling ambiente Windows. Usando suplementos. Por exemplo. entretanto. • Adicionar contato e informações descritivas a ajuda sobre a Visual Studio Caixa.VCProject Visual BasicVisual C# e Visual J# projeto modelo de automação. Visual Studio oferece o assistente suplemento para ajudar os usuários criar um projeto Add-In e projeto de implantação. consulte Como criar páginas opções ferramentas personalizadas:. Você pode criar seus próprios assistentes criando um projeto que implementa a IDTWizard interface. Para obter mais informações. Programa Partner (VSIP) Industry Studio Visual Visual Studio 370 . Projeto Visual C++ Modelo de automação. • Ativar e desativar comandos de menus e a Visual Studio barra de comando dinamicamente. Add-ins cabe esses recursos na IDE Visual Studio como se fossem internos. que deseja perfeitamente adicionar todos recursos novos ao IDE.VisualStudio.VisualStudio. fornecendo acesso a mais interfaces e Total Visual Studio Integração ajuda. Entretanto. Para ajudar a orientá-lo para o método melhor. consulte Como criar um add-in: ou Passo-a-passo: Criando um assistente.com/vstudio/Extend. considere os seguintes fatores. Você Outros idiomas — pode criar os suplementos e assistentes. mas usuários de sua macro deverá clique no Tools menu. ou visite o site VSIP em http://msdn. aponte para Macros. suplementos. Um editor personalizado. o método exato deve escolher. Você também pode enviar uma macro como texto para uso por outros usuários. e assistentes atender à maioria de suas necessidades em Visual Studio. clique Load Macro Project Para iniciar usá-los. macros. Você deseja distribuir o código ou um aplicativo compilado? • Usar Distribuir código — uma macro. Para obter mais informações. alguns usuários. Você deve ser capaz para implementar um objeto com able CoCreate-na linguagem de programação. copiando arquivos do projeto uma macro para o novo local. Parceiros com VSIP. Para obter mais informações. O Visual Studio Industry Partner (VSIP) program foi criado para você pode fazer isso. que é uma coleção de SDKs. para distribuí-los. consulte Como gravar macros:. em seguida. Usar Distribuir um aplicativo compilado — um suplemento ou um assistente. precisará ir além os recursos do modelo Visual Studio de automação consideráveis. Depuração recursos avançados.Para a maioria dos usuários. assistentes e outros aplicativos que usam as interfaces de automação proteger sua propriedade intelectual a compilação. No entanto. Ele fornece parceiros VSIP controle maiores e mais ampla sobre o IDE. Escolhendo a abordagem de automação adequada Fornece Visual Studio várias opções para criar aplicativos de automação.microsoft. ou um aplicativo que usa as interfaces de automação. Por exemplo. um usuário pode querer incorporar um totalmente nova linguagem de programação ao IDE Visual Studio. Você pode implantar macros. é um conjunto do desenvolvedor e plataforma. add-ins. e. • • Visual Studio 371 . Para obter mais informações. VSIP. consulte Automatizar ações Repetitive usando macros ou Criando Add-ins e assistentes. Não há nenhuma configuração ou o registro. • Linguagem de programação que você deseja usar para desenvolver o aplicativo de automação? • Você Visual Basic — pode criar macros. A tarefa requer entrada do usuário? Uma Nenhuma entrada de usuário é necessário — macro ou add-in é adequado. possivelmente criar uma necessidade de: • • • Um novo tipo de projeto. No entanto. consulte Automatizar ações Repetitive usando macros ou Criando Add-ins e assistentes. ou assistentes. Para obter mais informações. VSIP fornece a ferramentas e informações necessárias para integrar o produtos para o Visual Studio ambiente. dependerá basicamente na tarefa iminente. Os suplementos. Para obter mais informações. pesquise a ajuda para Visual Studio Industry Partner (VSIP) program. usando a IDTExtensibility2 interface e a IDTWizard interface. você deve usar um projeto de implantação ou alguma outra forma de instalação. podem fornecer maior funcionalidade em ambiente de criação seus usuários '. um assistente pode ser mais apropriado. consulte Automatizar ações Repetitive usando macros ou Criando Add-ins e assistentes. caixa de diálogo Opções — -. e assistentes todos podem ser usados para automatizar tarefas. Como você acha que o usuário será iniciado o aplicativo? Usar Menus ou barras de comando — um suplemento. Se Entrada complexas — a entrada tem várias etapas ou Exigir verificação. consulte Como ferramenta Windows criar e controlar:. Como complicada é a tarefa você estiver automatizando? Se Muito simples — você pode realizar a tarefa na apenas algumas linhas de código. O suporte para um novo idioma de programação no Visual Studio ou um novo editor — Become a VSIP partner.• • Uma Entrada simples — macro. Add-in. referências. Adicionar Páginas de propriedades personalizadas para as ferramentas. Adicionar Ferramenta ou documento janela personalizadas — -. Para obter mais informações. uma macro é apropriada. ou assistente é adequado. ou add-in é adequado. Enquanto Complicado — macros podem incluir formulários. Os objetos nesses grupos funcional totalmente são descritos no Gráfico do modelo de objeto de automação.com/vstudio/Extend. um suplemento ou assistente pode ser mais apropriado. Usar Um atalho de teclado ou o Explorer macro — uma macro. O que é o tempo de vida de seu aplicativo? Uma Preciso apenas de hoje — macro gravada temporária pode ser suficiente. Noções básicas sobre como esses grupos funcionam torna mais fácil para compreender e usar o modelo. • • • • • • • • • • • • Funcional grupos de automação O modelo de objeto de automação consiste expansivas grupos funcional de objetos de alguns. suplementos. ins e assistentes suporte a essa funcionalidade Para obter mais informações. Become Um novo tipo de projeto — um parceiro VSIP.microsoft. Usando Novo projeto ou item novo item de menu — um assistente é característico para adicionar um novo projeto ou arquivo para um aplicativo. Uma Eu vai ser usando ele tempo term — macro.. consulte Como criar páginas opções ferramentas personalizadas:. O que você precisa desenvolver? Macros Uma tarefa automatizada —. Esses objetos controlar principais aspectos do ambiente de desenvolvimento integrado (IDE) e aplique a todos os tipos de projeto em Visual Studio. assistente. e classes. Para obter mais informações. ins e assistentes suporte a essa funcionalidade Para obter mais informações. consulte http://msdn. Os grupos são: Visual Studio 372 . VsWizard Eles representam (respectivamente). Para Visual Basic. porque ele — Qualquer Visual Studio idioma pode cada idioma em Visual Studio oferece um ou mais automação específicas projeto-modelos para acessar seus recursos especiais.VisualStudio. Rápido e fácil de Use Visual Studio 373 .VCProjectEngine Microsoft. projeto. tais como a Task List. a função primária do grupo objetos do evento é para fornecer acesso a eventos que ocorrem no IDE Um tal objeto do grupo é o TaskListEvents objeto.VisualStudio. esse modelo está localizado nos seguintes conjuntos: • • • VSLangProj. Por exemplo. Objetos de tratamento de eventos. e Toolbox. Visual C# e Visual J# projetos. VSLangProj2 VSLangProj80 Para obter mais informações sobre essa funcionalidade. que permite que você para responder a eventos que ocorrem em uma operação de criação. Use-los para criar ferramentas-com base Automation para uso em Visual Studio. Criar objetos. coleções. e o Visual C++ modelo Assistente. os conjuntos são: • • • • Microsoft.• • • • • • • • • Solução. Código objetos Editor. Consulte também Acessando o modelo de automação por usando macros Macros Visual Studio são uma maneira excelente para facilmente obter acesso aos diversos Visual Studio modelos de automação. Código objetos de manipulação definição. ou interfaces que contribuem para uma finalidade específica. Output janela. que permite que você para responder a eventos que ocorrem no Task List. Comandos objetos. o Visual C++ modelo código específico. Depuração objetos. Para Visual C++. Ferramenta específicas janela-objetos. como o início ou conclusão de uma compilação.VCCodeModel Microsoft. e objetos item projeto. Outra nesse grupo é o BuildEvents objeto. Ferramenta janela e documente objetos de manipulação.VCProject Microsoft.VisualStudio.VisualStudio. consulte Introdução à extensibilidade de projeto. o Visual C++ modelo de projeto. Cada grupo funcional consiste de um ou mais relacionados objetos. Modelos de automação específicas projetoAlém para o modelo — de automação " principal " então chamado. AddIn do seu projeto Expor Add-ins nos menus e barras de ferramentas Conectando Add-ins a teclas de atalho Novas alterações na funcionalidade barra de comando Como restaurar comandos que desaparecem de um menu Consulte Automatizar ações Repetitive usando macros O espectro de automação Visual Studio Funcional grupos de automação Como criar um add-in: Referência conjuntos de automação e o objeto DTE2 Add-in de registro Add-in de segurança Exibindo Add-ins em barras de ferramentas e menus Comandos Suplemento de ligação para chaves Alterações CommandBar para o Visual Studio 2005 Como restaurar comandos suplemento para o menu: No ambiente carregando. O modelo Automação fornece a capacidade de automatizar o ambiente e fornecer extensões e novos recursos a ela. eles podem ter uma tarefa ou série de tarefas que executar regularmente e gostaria de automatizar. (EnvDTE) já são fornecidos. Para obter mais informações sobre como criar. Para saber mais sobre Gravação e execução macros As três maneiras para acessar Visual Studio Automação Grupos functional de objetos no modelo de objeto de automação Como criar Add-ins Como referência espaço para nome EnvDTE e obter uma instância do objeto DTE Registrar um suplemento Como limitar o acesso a arquivo de Registro Xml. conhecido como o modelo de automação. Conseqüentemente. oferece várias ferramentas e a energia para executar quase cada tarefa. contra o IDE principal. e depuração macros. disposable para ajudar a automatizar um processo repetitivo. imediatamente para começar escrever código direita após iniciar o IDE macros e EnvDTE80 Macros são também uma maneira excelente para criar ferramentas de automação rápido. e controlar Add-ins HOW TO: com o Gerenciador de Suplementos controle Add-ins Visual Studio 374 . executado. Consulte também Criando Add-ins e assistentes Embora Visual Studio alguns desenvolvedores exigir um nível de controle adicionais ou maiores.Macros são criadas. descarregando. é fácil para executar e depurar o código de automação nele. Como referências para as bibliotecas de automação Principal. Visual Studio recursos um Rich programação modelo. e depurado em seu próprio ambiente separado. consulte Automatizar ações Repetitive usando macros. os desenvolvedores Por exemplo. Para resolver esse problema. usando. (IDE) o ambiente de desenvolvimento integrado macros. ou ainda mais sofisticadas ferramentas Automação. para estender e automatizar o IDE (ambiente de desenvolvimento integrado). sem iniciar outra instância do Visual Studio. Derivar DTE2 de DTE. consulte Funcional grupos de automação. Para Visual Studio 2005. Como os novos membros são mais robusta que versões anteriores e contêm a funcionalidade mais recente. você deve executar etapas para obter acesso a membros de automação. a abordagem recomendada é para usar os novos objetos e coleções ao escrever novos aplicativos de automação. coleções.NET 2002 e Visual Studio . a Add Item e New Project caixas de diálogo e como elas afetam Depuração Walkthrough: um projeto Addin Passo-a-passo: Criando um assistente Parâmetros de contexto para Launching assistentes Configurando Arquivos VSZ para iniciar assistentes Adicionando assistentes para a Adicionar Item e novas caixas de diálogo Project usando arquivos VSDir Como criar uma nova instância de Visual Studio forma Como criar e anexar a outra instância do programática ou anexar a uma instância específica de Visual Visual Studio: Studio que já está executando Como atualizar projetos de automação das versões anteriores do Visual Studio para Visual Studio 2005. Para obter uma lista completa dos novos objetos e coleções. adições e atualizações foram feitas para alguns desses objetos.NET 2003 para o Visual Studio 2005 Referência conjuntos de automação e o objeto DTE2 Para criar aplicativos de automação. Ele é o objeto pai para todos os objetos de automação principais. Por exemplo.0). quando você escrever novos aplicativos de Automação (como os suplementos). Assim. Migrando e atualizando Add-ins do Visual Studio . coleções.0 ".Depuração Add-ins Criando um assistente Iniciar assistentes programaticamente Arquivos do assistente (. se você usar membros do conjunto EnvDTE. Mais funções atualizadas no EnvDTE80 manter os mesmos nomes que versões anteriores mas acrescentar o número 2 ao nome da função. e seu objeto maior. você deve obtém uma referência para o objeto DTE2 de nível superior.vsz) Arquivos VSDir. e membros. você deve fazer referência os conjuntos de automação necessários. todos os itens de automação principais estavam localizados em um conjunto nomeado EnvDTE. Em vez de atualizar o conjunto existente e comprometer compatibilidade com versões-para existente Add-ins e projetos de automação. Embora novos itens sejam no EnvDTE80. hierárquica é o DTE objeto. Visual Studio 375 . Isso fornece acesso a todos os itens. consulte Novos membros de automação para Visual Studio 2005. e a nova versão do objeto Solution é chamada Solution2. Para fazer isso em uma etapa fazendo referência a biblioteca COM. e seus membros. Para obter informações sobre ganhar acesso aos modelos de objeto específicos projeto-. Primeiro. a nova versão da coleção TaskItems é denominada TaskItems2. certifique-se referência ambos EnvDTE e EnvDTE80.NET 2003. Além disso. " Ambiente de desenvolvimento Microsoft 8. a maior parte da funcionalidade de automação do principal é ainda em EnvDTE. novo e atualizado toda funcionalidade está em um conjunto chamado EnvDTE80 (EnvDTE versão 8. precisará também definir uma referência ao tanto o DTE objeto e o DTE2 objeto. No Visual Studio . e Segundo. e projetos na solução. com exceção dos projetos virtuais). Erro usando EnvDTE com conjuntos VSLangProj Descreve um possível erro você pode receber quando um projeto usa o EnvDTE conjunto e uma ou mais dos VSLangProj conjuntos. Uma solução pode conter dois projetos virtuais adicionais: a itens solução e os projetos Miscellaneous arquivos. O ProjectItem objeto representa itens individuais dentro do projeto. () contenha.Nesta seção Como adicionar referências a EnvDTE e Namespaces EnvDTE80: Demonstra como adicionar referências para os espaços para nome apropriado. Criando Add-ins e assistentes Fornece informações básicas sobre como criar suplementos e assistentes no Visual Studio. Controlar projetos e soluções O Visual Studio modelo de automação fornece objetos e coleções que permitem que você para controlar a solução. bem como referências a todos os projetos nessa solução. Como programaticamente criar solução e projeto configurações de Consulte Controlar a solução e seus projetos Como criar soluções e configurações construir Project: Visual Studio 376 . • Um projeto virtual é uma que não está associado a um projeto específico mas está associado a solução em vez disso. respectivamente que é retornado pelo Projects A ProjectItems coleção representa todos os itens contidos em um projeto (Project. projetos. além de cada idioma programação possui seu próprio modelo de automação do projeto que fornece acesso a recursos exclusivos para esse idioma. modelo de automação projeto agnostic idioma. e os itens de projeto dentro do projeto. Objetos e coleções • O Solution2 objeto e a Projects coleção e Projects. Seções relacionadas Gráfico do modelo de objeto de automação Fornece um mapa gráfico a todos os componentes compartilhados do modelo de objeto de automação. uma referência para a solução. Como obter referências a do DTE e objetos DTE2: Demonstra como obter referências aos objetos apropriados. Este núcleo. Anexar a instâncias específicas do IDE Fornece informações sobre como fazer referência uma instância específica de (IDE) o ambiente de desenvolvimento integrado. Para saber mais sobre Controlando a solução. independentemente da linguagem de programação na qual o aplicativo foi escrito. compilação. Como qualquer outra janela ferramenta no Visual Studio. Consulte Como alterar características da janela: Como controlar o editor de código (Visual Basic): Visual Studio 377 .. Visual C#. Você também pode criar suas próprias janelas de ferramentas para atender seu conteúdo personalizado. HOW TO: controle Solution Explorer Introdução à extensibilidade de projeto e Microsoft.VCProjectEngine. é Solution Explorer uma janela ferramenta no IDE Visual Studio que exibe uma imagem de sua solução e seus projetos e seus itens de projeto físico. Para informações. Uma janela ferramenta é uma janela criado por Visual Studio. referenciado ou chamado no aplicativo que esteja desenvolvendo. Trabalhando com os projetos — virtuais itens Solution e itens Miscellaneous projetos. com base em arquivo. e ToolBoxItems Coleções Você pode usar seus membros para adicionar e remover guias e itens ferramentas. Unmodeled Overview de projetos Trabalhar com itens Solution e itens Miscellaneous Salvando solução e projeto Persisting informações nos projetos e soluções variável valores entre sessões IDE (ambiente) de desenvolvimento integrado. Criando e Controlling ambiente Windows O Visual Studio IDE (ambiente de desenvolvimento integrado) é composto de várias janelas de ferramentas. como sua altura.VisualStudio. ou um que pode ser manipulado pelo Visual Studio Automação. Manipular código fonte e texto no editor do código. a janela ferramentas é representada pelo objeto ToolBox. como Solution Explorer e a Class View janela ferramenta. bem como a ToolBoxTabs. Controlando Visual Basic.VisualStudio. como tamanho. Manipular Solution Explorer. local. Enquanto algumas janelas ferramenta. você pode manipular as janelas próprios ainda. não faça têm recursos de automação explícitas.. O Visual Studio modelo de automação permite que você se manipular suas janelas e em muitos casos. e Visual J# projetos Controle Visual C++ Projetos. consulte Como alterar características da janela:. Por exemplo. e assim por diante.VCProjectMicrosoft. e se ele está ancorada ou Free-floating. Para saber mais sobre Alterar as características físicas de uma janela ferramenta. largura. você pode controlar seus parâmetros físicos. é Class View uma janela que exibe os símbolos ferramenta definido. seu conteúdo. Lidando com projetos que não oferecerem suporte o Visual Studio modelo de automação. HOW TO: controle Solution Explorer Descobrir Código com o modelo de código (Visual Basic) Como controlar a janela de saída: Controlar configurações opções ferramentas Como controlar a caixa de ferramentas: Como controlar a lista de tarefas: Como controlar a janela de comando: Como controlar a janela da Ajuda dinâmico: Manipular a gravação de macros a partir de um suplemento. texto: Manipular Solution Explorer e seu conteúdo. Do Task List manipular e seu conteúdo. Criar uma nova instância de Visual Studio onde a instância permanece carregada mesmo quando: o • Visual Studio 378 . Criar uma nova instância de Visual Studio onde a instância desligado quando: A contagem de referência externa em ambos o DTE objeto e o Solution objeto são 0. Manipular a Command janela e seu conteúdo. Do Toolbox manipular e seu conteúdo. Você pode. por exemplo: • • • • o Iniciar uma ocorrência Visual Studio com base em um caminho para um arquivo ou solução. Se duas instâncias da Visual Studio estiver executando em um sistema e ter a mesma solução abrir — por exemplo. Criar e manipular janelas de ferramentas. Alterar as configurações na caixa Options de diálogo no menu Tools. Carregar um arquivo ou solução em uma instância existente do Visual Studio. eO ambiente de desenvolvimento integrado (IDE) não é exibida para o usuário ou não está sob controle de usuário. Anexar a uma instância Visual Studio com base em um caminho para um arquivo ou solução. Manipulação da Dynamic Help janela e afetar atributos.Automatizar operações de pesquisa e substituição no Editor Como pesquisar e substituir automatizar do código. Usando o Visual Studio modelo de código para descobrir código. uma instância está executando uma compilação de solução e o outro é executar uma compilação — de depuração você pode programar o suplemento para diferenciá-las. Como usar Add-ins para macros de controle: Controlando modos de exibição de árvore em janelas de ferramentas usando o UIHierarchy objeto. HOW TO: Manipulate modos de exibição da árvore usando UIHierarchy Como ferramenta Windows criar e controlar: Como criar e anexar a outra instância do Visual Studio: Em alguns casos é útil para criar uma nova instância de Visual Studio forma programática ou anexar a uma instância específica de Visual Studio que já está sendo executado. Manipular a Output janela e seu conteúdo. GetObject(.8.8.Interaction.0").Interaction. Para obter uma referência a uma instância existente do IDE Visual Studio. eO IDE está sob controle de usuário.GetObject _ Visual Studio 379 .DTE2) MsgBox(dte80Obj.8. escolha Import e Export Settings no menu Tools. consulte Configurações do Visual Studio.VisualBasic. O IDE será exibido para o usuário. o Função CreateObject (Visual Basic) Ao usar a CreateObject função no Visual Basic. EnvDTE80.0" ou "VisualStudio.GetObject(.CreateInstance. _ "VisualStudio. true).VisualBasic. C# // Create a new instance of Visual Studio by using // GetTypeFromProgID and CreateInstance. } No exemplo Visual Basic. Observação As caixas de diálogo e comandos de menu que você vê podem ser diferentes das descritas em Help (Ajuda) dependendo das configurações ativas ou edição. A primeira instrução diretamente cria uma nova instância enquanto a segunda instrução cria uma nova instância.DTE2 dte8Obj = (EnvDTE80.0") ' --------------------------' -or' Change the path to your application.Solution. _ "VisualStudio." os exemplos abaixo ilustrar esses métodos três.Solution.ToString) End Sub ' -orDim inst As Object inst = Microsoft.VisualBasic. Esses procedimentos foram desenvolvidos com as configurações Development geral ativo.DTE2)obj. use um ou System.GetTypeFromProgID ("VisualStudio.Type type = System. Você pode siga um destes procedimentos: Visual Basic Private Sub GetInstance1 () Dim inst As Object Dim dte80Obj As EnvDTE80.8.o o A contagem de referência externa em ambos o DTE objeto e o Solution objeto são 0. o Os objetos retornados podem ser convertidos em seus objetos respectivos.0") dte80Obj = CType(inst.DTE. você pode passar valores de um "VisualStudio. Dim inst As Object inst = Microsoft.8.DTE.Type. você pode usar o Função GetObject (Visual Basic).0. Para obter mais informações. EnvDTE80. ambas as instruções criar uma nova instância de IDE Visual Studio. Para alterar as configurações.DisplayMode.DTE.Interaction.Activator. Object obj = System.CreateInstance(type.Activator. tais como DTE2 e Solution2. Exemplo Para criar uma nova instância do Visual Studio.DTE2 inst = Microsoft. criando uma nova solução. private void CreateNewInstance1() { System. sln". Novos membros de automação para Visual Studio 2005 Lista os novos tipos específicos e membros em Visual Studio 2005 Destaque. Para resolver esses problemas. vários projetos.("C:\Projects\WindowsApplication1\WindowsApplication1. Cada modelo concentrates a uma área específica do IDE. Visual Studio Rich modelos de programação conhecidos como os modelos de objeto de automação. como as janelas ferramenta. bem como os fundamentos de como criar suplementos e assistentes.Interaction. add-ins e assistentes e VSIP.Solution. Práticas recomendadas para segurança na automação Fornece conselhos para ajudar você segura Visual Studio e os aplicativos de automação. e assim por diante. Por exemplo. Criando Add-ins e assistentes Descreve os conceitos de automação e extensibilidade. Referência conjuntos de automação e o objeto DTE2 Visual Studio 380 .sln") ' --------------------------' -or' Change the path to your application. Dim inst As Object inst = Microsoft.VisualBasic. O espectro de automação Visual Studio Descreve os tipos de projetos de automação disponíveis para você em Visual Studio: macros. Escolhendo a abordagem de automação adequada Ajuda você a escolher as ferramentas mais eficientes para usar para realizar suas tarefas de automação.0") Estendendo o ambiente Visual Studio Embora Visual Studio você talvez precise um nível de controle adicionais ou maiores. oferece várias ferramentas e a energia para executar quase cada tarefa. Ou você pode ter criado ferramentas que você deseja usar no ambiente Visual Studio de desenvolvimento integrado (IDE). Nesta seção O que há de novo no extensibilidade e automação do Visual Studio 2005 Descreve as atualizações e melhorias de extensibilidade e automação os modelos em Visual Studio 2005 Vários. Acessando o modelo de automação por usando macros Ilustra como programa contra os diversos modelos de automação usando macros. convém automatizar uma tarefa ou uma série de tarefas que você executar regularmente. o editor de código.. _ "VisualStudio. Os modelos automação vários fornecem a capacidade para automatizar o ambiente e fornecer extensões e novos recursos a ela.8. As seções abaixo apresentar a você para automação e extensibilidade e mostram como usá-los para facilitar a programação.GetObject _ ("C:\Projects\WindowsApplication1\WindowsApplication1. Funcional grupos de automação Lista as diversas áreas de Visual Studio que pode ser automatizada. para estender e automatizar o IDE recursos. Como criar e anexar a outra instância do Visual Studio: Explica como criar uma nova instância do Visual Studio ou anexar a um arquivo existente. como salvar variáveis entre sessões IDE. alterar características janela. Macros permite que sejam automatizar ações repetitivas. diversos itens. editar. controlar configurações opções ferramentas.Fornece detalhes sobre como usar as ferramentas fundamentos de automação. O IDE de Macros é separado do IDE Visual Studio. e manipular modos de exibição de árvore. Visual Studio 381 . Implementar e usando Extenders de automação Explica como adicionar e filtrar propriedades em objetos usando Extenders Automação. automatizar pesquisa de texto e substituir. e outros Visual Studio itens. que pode conter recursos para uso em seus aplicativos de automação. e unmodeled projetos. manipular. descobrir Código com o modelo de código. Respondendo a eventos de automação Demonstra como usar o Visual Studio modelo de automação para manipular eventos que ocorrem no ambiente. Automatizar ações Repetitive usando macros Explica como criar e usar macros para automatizar ações no Visual Studio. Seções relacionadas Personalizar o ambiente de desenvolvimento Demonstra como personalizar barras de ferramentas. teclas de atalho. Como Adicionar e identificador comandos: Explica como criar e manipular comandos em Visual Studio Menus ou barras de ferramentas usando o Visual Studio modelo de automação. controlar macros. Controlar projetos e soluções Ilustra como controlar projetos e soluções usando Visual Studio objetos de automação. Macros do Visual Studio Uma macro é uma série de comandos e instruções que você agrupa como um único comando para realizar uma tarefa automaticamente. como para trabalhar com itens de solução. Inclui Visual Studio o ambiente de desenvolvimento integrado macros (IDE). Criando DLLs satélite Managed Walkthrough: Fornece informações sobre como criar satélite DLLs. usando UIHierarchy. Criando e Controlling ambiente Windows Explica como criar e controlar janelas de ferramentas. e execute macros. e como criar configurações de solução. Nesta seção Como gravar macros: Descreve como criar e gravar macros. que é usado somente para criar. Macros Fornece detalhes sobre o Macros objeto. HOW TO: identificador eventos de ambiente em macros Discute o modelo EnvironmentEvents. Segurança macros e compartilhamento questões Aborda as questões de segurança principal sobre macros: Proteção de propriedade intelectual. Ambiente de Desenvolvimento macros Descreve todas as caixas de diálogo do IDE de Macros.NET Framework em macros: Descreve como habilitar Visual Studio macros para referência componentes COM usando o utilitário TLBIMP. Gravação de Macro e executando questões Oferece soluções para problemas normalmente encontrados na gravação e execução macros.HOW TO: executar macros Aborda várias maneiras de executar macros e passar parâmetros. o Find método. Mensagens de erro Macros do Visual Studio Lista todas as mensagens de erro associadas a Visual Studio macros. operação item. e Ferramentas Opções entre Visual Studio macros e Visual Studio. Depurar macros Descreve o que fazer quando ocorrem erros em suas macros. Diferenças funcionalidade entre Macros do Visual Studio e Visual Studio Descreve diferenças no modelo de extensibilidade. que representa o Visual Studio Gravador de macro. Document objeto. e prevenção de vírus e proteção. projetos. Salvar e exportando arquivos macros Descreve como salvar e exportar arquivos macro no IDE de Macros. Como gerenciar macros: Descreve o Explorer macros e seus menus de contexto. Exemplos macros Lista e descreve as macros amostras incluídas Visual Studio. propriedades. o OnMacrosRuntimeReset evento e o OnStartupComplete evento. Como referência com e componentes . Como gerenciar macros: Descreve como editar uma macro existente ou criar um novo arquivo manualmente. Visual Studio 382 . Seções relacionadas Automatizar ações Repetitive usando macros Fornece uma visão geral sobre como usar macros para automatizar procedimentos ou seqüências repetidas de pressionamentos de teclas. e qualquer tipo de projeto que precisa para estender ou automatizar o IDE.0" Visual Studio 383 . Visual C++ incluindo Visual C#Visual Basic. mas referência de configuração do projeto está procurando por uma versão anterior desse conjunto. VSLangProj2 e Namespaces VSLangProj80 Esses espaços para nome contém todos os as classes. adicionando uma referência para os conjuntos VSLangProj. versão ' = 7. VSLangProj2 Para obter uma descrição dos tipos do projeto de automação e recursos de automação. escrever código para a macro sendo gravadas.0..Como usar Add-ins para macros de controle: Descreve como usar objeto o Visual Studio do modelo Macros de automação para macros de controle sendo registradas no IDE. Consulte também Introdução à extensibilidade de projeto O modelo de objeto está disponível simplesmente.FileNotFoundException Erro ao carregar arquivo EnvDTE. Visual C# e Visual J#.0" encoding="utf-8" ?> <configuration> <runtime> <assemblyBinding xmlns="urn:schemas-microsoftcom:asm. Para obter uma lista completa dos objetos no espaço para nome.config) do seu projeto. Para fazer isso. Para obter mais informações sobre como executar os exemplos. Macros são gravadas no ambiente de desenvolvimento integrado macros usando Visual Basic.dll a qualquer projeto. VSLangProj2. interfaces.xx versão.50318"> <dependentAssembly> <assemblyIdentity name="EnvDTE" publicKeyToken= "b03f5f7f11d50a3a"/> <bindingRedirect oldVersion="7. consulte COMO: Adicionar ou remover referências no Visual Studio. incluindo pausar e reativar o gravador.0. consulte Como compilar e executar objeto automação os exemplos código do modelo:.0. Visual C# e Visual J# projetos.Isso significa que o modelo de objeto está disponível para Macros. Para obter mais informações.0. Do Visual Basic nos tópicos Os exemplos são gravados em e Visual C# idiomas. o VSLangProj.3300. e enumerações para Visual Basic. a versão do EnvDTE que é incluída no Visual Studio 2005 é 8. 7.3300.0 Esse erro é devido a um conflito de resolução tipo Runtime.dll e VSLangProj80.IO. VSLangProj. você pode obter o seguinte erro em tempo de execução: ": ": Unhandled Exception System. você deve adicionar um redirecionamento de ligação para a versão mais recente EnvDTE ao arquivo de configuração (.NET. e Visual J# Os tópicos de referência para e VSLangProj80 membros incluir a sintaxe para cada um desses idiomas. consulte Modelo de Objeto de Extensibilidade para projetos Visual Basic. Ou seja. consulte Criando Add-ins e assistentes. Add-ins pode ser gravados em qualquer um dos idiomas .0. adicione um " arquivo de configuração de aplicativos " ao seu projeto e substituí seu conteúdo pelo seguinte: <?xml version="1.v1" appliesTo="v2.dll. suplementos. Para corrigir esse problema.xx. Possível erro usar conjuntos VSLangProj com assembly EnvDTE Ocasionalmente se você criar um projeto que referencia um ou mais dos conjuntos VSLangProj e o EnvDTE conjunto. Isso permitirá Visual Studio para carregar a versão mais recente do EnvDTE e evitar que o erro ocorra. e determinar se o gravador está funcionando no momento. contém uma coleção de Reference3 objetos. a Visual Basic. Visual C# Como o tipo da propriedade Object é objeto. O tipo da propriedade é determinado em tempo de execução pelo idioma do projeto.Project proj. O References objeto não contém as referências de um projeto da Web. Objeto importações A Imports propriedade contida pelo objeto VSProject2 mantém uma coleção de Imports declarações que se aplicam a um projeto inteiro Visual Basic. O objeto DTE é o objeto de nível superior no modelo Visual Studio de automação.Item(1).NET. outros projetos ActiveX. Referências de um projeto da Web podem ser recuperadas por acessar a ProjectItems Propriedade da propriedade WebReferencesFolder. removendo. References Coleção. e referências. O Reference3 objeto representa uma referência de projeto e é principalmente um objeto somente leitura que ofereça suporte um Remove método.Solution. using VSLangProj. pastas. Na ou Visual J# projeto. e a VSLangProj80. consulte Reference e Reference3 objeto. using VSLangProj2. VSLangProj80. using EnvDTE80. Visual Studio 384 . você deve convertido a referência ao digitar VSProject2. Não há nenhum equivalente em um Visual C# projeto. você pode manipular do projeto Propriedades.) e aumentando eventos (adicionando. consulte Introdução ao objeto VSProject2.newVersion="8. Depois que você tiver uma referência para o VSProject2 item.Projects. e alterar referências) com. um projeto é representado pelo objeto genérico Project. using VSLangProj80. Imports VSLangProj) não precisa a ser adicionado ao arquivo de código. instruções importações.VSProject2. EnvDTE.0.Imports retorna Nothing propriedade ou null quando aplicado a um Visual C# projeto Para obter mais informações. configurações. consulte Imports. References propriedade. vsproject = (VSLangProj80. a conversão seria como o seguinte se o primeiro projeto foram um Visual Basic projeto: C# using EnvDTE. Em uma macro. a Object propriedade retorna um objeto do tipo VSProject2.0"/> </dependentAssembly> </assemblyBinding> </runtime> </configuration> Objeto VSProject2 Este objeto fornece acesso a outros objetos no modelo de extensibilidade.VSproject2 vsproject. a instrução correspondente Imports (por exemplo. O Project objeto tem uma Object propriedade.0. Para obter mais informações e exemplos de código. conjuntos . arquivos. e WebReferencesFolder propriedade. contida pelo objeto VSProject2. Para obter mais informações. proj = DTE2. Se uma instrução importações for adicionada a essa coleção. Este objeto suporta adicionando e removendo instruções importações e elevar eventos em resposta a adição e remoção instruções. Referências e objetos de referência A References propriedade.VSProject2)proj. O References objeto tem suporte para adicionar referências (. No modelo de extensibilidade geral. A Object propriedade é do tipo OBJECT. EnvDTE. using VSLangProj80. O conteúdo da coleção dependem do idioma. métodos.Solution. e BuildManager Objeto. e em ou Visual C# projeto.Projects. propriedades. Object.ProjectItems. Nesta seção Gráfico hierarquia VSLangProj (VSLangProj2 e VSLangProj80) Ilustra as relações de objetos no espaço para nome VSLangProj. O BuildManager objeto trata saída ferramenta personalizada. um Visual Basic Projetando o objeto digite VSProjectItem teria esta aparência em uma macro: C# using EnvDTE. VSProjectItem método. o tipo da propriedade é VSProjectItem. Pi = (VSProject2)DTE2.Project proj.VSProjectItem pi. e criar novo projeto tipos de item. o objeto genérico ProjectItem representa um item de projeto.VSProjectItem e objetos BuildManager O VSProjectItem objeto é a contraparte item de projeto do objeto VSProject2. using VSLangProj2. o conteúdo também dependem das se o item é um arquivo ou uma pasta.Item(1). especificando o da propriedade índice baseado em 1 ou seu nome. using EnvDTE80.Item(1). Introdução ao objeto BuildManager Objeto. e eventos são usados para automatizar tarefas no ambiente de desenvolvimento. using VSLangProj. Namespace VSLangProj (VSLangProj2 e VSLangProj80) Visual Studio 385 . No modelo de extensibilidade geral. Objeto Configuration As propriedades nesse objeto são equivalentes às propriedades encontradas na guia Configuration Properties da caixa de diálogo Property Pages no IDE do projeto. • • • Modelo de Objeto de Extensibilidade para projetos Visual Basic. Um Property objeto pode ser obtido a partir da coleção. Visual C# e Visual J# Esses objetos. VSLangProj. Objeto ProjectItem As propriedades nesse objeto são equivalentes às propriedades encontradas na janela Properties quando um item de projeto está selecionado no Solution Explorer. Em cada caso a Properties propriedade é uma coleção de objetos do tipo Propriedade. consulte RunCustomTool. criar novos tipos de projeto. O VSProjectItem objeto contém propriedades que vincular ao item de projeto pai e projeto. Propriedade Properties Modelo de extensibilidade geral tem uma Properties propriedade em três objetos: • Objeto Project As propriedades nesse objeto são equivalentes às propriedades encontradas na guia Common Properties da caixa de diálogo Property Pages no IDE do projeto. No caso de itens de projeto. e um método que força a execução de uma ferramenta personalizada nesse item. Para obter mais informações. Nesta seção Visual modelo código C++ Explica como manipular internos elementos. podem ser chamados. Cada modelo inclui objetos que representa partes de um Visual C++ projeto predefinidos. Objetos podem ser manipulados com Visual C++ ou com outros idiomas suporte por Visual C++. incluindo depuração. tais como Visual C#. Visual Basic. Automação e extensibilidade do Visual Studio Bem-vindo ao Assistente suplemento. interfaces. tais como uma classe definida ou função dentro de um Visual C++ projeto. expanda Other Project Types. métodos e eventos podem ser tratados em qualquer linguagem compatível com o . e associados wrappers gerenciados que podem ser usados com qualquer linguagem compatível com ou o .NET Framework para automatizar ações que ocorrem no ambiente Visual Studio de desenvolvimento integrado (IDE). Introdução ao Extensibilidade do Projeto no Visual Basic e Visual C# Descreve como controlar Visual Basic e Visual C# projetos e soluções usando seus objetos de automação. clique em Extensibility e clique duas vezes em qualquer Visual Studio Add-in ou Shared Add-in no painel Visual Studio 386 . Modelo de Objeto de Extensibilidade do Visual C++ Esta seção da documentação Visual C++ aborda quatro modelos de objeto que compõem o Visual C++ modelo de objeto extensibilidade. Propriedades podem ser lidas e conjunto. Para iniciar o assistente add-in. Assistente para Adicionar-in Visual Studio Este painel apresenta ao assistente add-in. Cada modelo pode ser manipulado com Visual Basic macros ou através da Properties janela. Seções relacionadas Referência de automação e extensibilidade Inclui informações de referência para os modelos de extensibilidade.NET Framework com ou. O Visual C++ modelo de objeto extensibilidade é um conjunto de objetos COM. Visual modelo Assistente C++ Explica como oferecem suporte a Automação para assistentes de design. abra a New Project caixa. Seções relacionadas Referência de automação e extensibilidade Contém idioma tópicos de referência para o modelo de automação do ambiente de desenvolvimento integrado (IDE). Modelo do Project C++ Visual Explica o modelo que regula projetos e cria.Descreve espaço para nome contendo extensões do espaço para nome VSLangProj. Visual C# e exemplos de extensibilidade Project J# Visual Fornece links para tópicos contendo exemplos Programação de extensibilidade. VCCodeModel Os tipos e membros relacionados ao Visual C++ código de automação. Framework Back Move para a página anterior do assistente do suplemento ou para a New Project caixa de diálogo se o foco estiver na primeira página. Inclui tipos e membros novos no Visual Studio 2005. Extensibility Contém a IDTExtensibility2 interface que hospedam métodos que manipulam eventos add-in. Visual C# e Visual J# projeto de automação. Nesta seção EnvDTE Os tipos e membros relacionadas à automação. Visual C# e Visual J# Projeto Automação. e a depuração para todos os Visual Studio idiomas. consulte Criando Add-ins e assistentes. Inclui tipos e membros novos no Visual Studio 2005. extensibilidade. Para obter mais informações. VSLangProj2 Tipos e membros que se relacionam com Visual Basic. Cancel Cancelar o Assistente para Adicionar-in e a criação do suplemento. extensibilidade. e a depuração para todos os Visual Studio idiomas. para Visual Studio 2005 que se relacionam com Visual Basic. EnvDTE80 Os tipos e membros. relacionados ao automação. O assistente suplemento cria uma estrutura básica add-in que você pode complementar posteriormente. Consulte também Tarefas Referência de automação e extensibilidade Os tópicos a seguir se relacionam ao automação e extensibilidade no Visual Studio para componentes compartilhados e específicos do idioma. VSLangProj80 Tipos e membros. Novo. Next Mover para a próxima página do Assistente do suplemento. VCProject Os tipos e membros relacionados ao Visual C++ projeto Automação. novo para Visual Studio 2005. VSLangProj Tipos e membros que se relacionam com Visual Basic. Visual Studio 387 . Visual C# e Visual J# projeto de automação.Templates. coleções. métodos. Modelo de Objeto de Extensibilidade do Visual C++ Lista todos os objetos. e constantes relacionadas às montagens vários Visual C++. VsWizard Os tipos e membros relacionadas à Visual C++ automação Assistente. propriedades.VCProjectEngine Os tipos e membros relacionados ao Visual C++ projeto Automação. Visual Studio 388 . Inclui tipos e membros novos no Visual Studio 2005. interfaces. eventos. Inclui tipos e membros novos no Visual Studio 2005. a Janela Immediate. Visual Studio comandos seguem determinadas regras sintaxe geral que são explicadas abaixo. Visual Studio 389 . Sintaxe comando Visual Studio Visual comandos Studio podem ser inseridos na janela. Concluir comando nomes compatíveis com as regras de sintaxe a seguir: • • Categorias de comando. Criando de linha de comando visual (C#). Options Dialog Box e no. e comandos de menu no IDE têm um equivalente de linha de comando que você pode digitar na Janela de Comando. digite o seguinte comando na janela. Environment Options como um filho do comando File. a sintaxe completa reflete a colocação de comandos no sistema menu IDE. Muitos comandos podem ser gravados em um dos dois formatos. bem como e macros.Visual Studio Comandos e opções Visual comandos Studio permitem direta interação com o ambiente de desenvolvimento integrado por meio do teclado (IDE). e nomes de comandos são separadas por um ponto (.). os Comandos guia. consulte o Referência MSBuild. Immedia janela te. e Criando a partir da linha de comando. Nomes de comandos concluída A sintaxe completa para comandos é baseada em caixa de diálogo listados Keyboard. Criando a partir da linha de comando Para obter informações sobre criação projetos no Visual Studio linguagens de programação a partir da linha de comando. ou o Localizar / comando caixa para exibir uma caixa de diálogo ou executar um comando. Environment Options nome comando completo. ou CommandFind/Command na caixa.) Para obter informações sobre como configurar um arquivo de esquema XML MSBuild para criar projetos. o Nova caixa de diálogo do arquivo Para exibir esta caixa de diálogo. Na maioria dos casos. o comando que exibe aparece Keyboard. (>) é usado para indicar que um comando em vez de uma operação de pesquisa ou de depuração é a seguir Para obter informações sobre a sintaxe de comando. Consulte Compilando a partir da linha de comando (Visual Basic). usando a sintaxe de comando completa. consulte Visual Studio comandos com argumentos e Opções de linha de comando Devenv. >File. O conjunto de comandos disponíveis inclui todos os comandos listados na Keyboard. Espaços e pontuação são removidos de todos os nomes de comando conforme exibido na barra de menus. como menus. pronto para que você possa faça sua seleção. Em cada caso. janelas. o sinal maior. ou CommandFind/Command caixa e pressione ENTER. Muitas caixas de diálogo. Personalizar caixa de diálogo Visual Studio () Aliases definidos pelo usuário. Immedia janela te.NewFile A New File caixa de diálogo aparece. Environment. Opções VCBUILD Visual C++ (. Por exemplo. uma menor Formulário ou alias. NewFile Mytext /t:"General\Text File" /e:"Source Code (text) Editor" Observação Argumentos comando devem ser inseridos na ordem especificada para o comando. Comandos e argumentos compatíveis com a seguinte sintaxe: • • • • Comandos nomes e argumentos são separados por espaços Valores argumento que contenham espaços devem ser colocados entre aspas Use o circunflexo (^ caracteres para caracteres de escape) Abreviações argumento caractere único-podem ser combinadas. digitado sem opções.MakeUpperCase digitando o seguinte: >alias upper Edit. Por exemplo. usando o alias comando. e abre-no Editor de Código fonte. você pode combinar as abreviações argumento único caractere para /case (/c. para nomes comando completo para ajudá-lo a lembrar e digite os comandos mais rapidamente. a /case opção de comando Edit. ou CommandFind/Command caixa. você pode criar um alias para o comando Edit. Você também pode criar aliases que incluem nomes de comandos e seus argumentos. O Visual Studio vem com um conjunto de aliases predefinidos. O exemplo a seguir cria um novo arquivo de texto chamado MyText. sem exibir a New File caixa de diálogo. Por exemplo.txt. Switches e seus argumentos podem ser colocados em qualquer ordem. Por exemplo. Para obter mais informações. Por exemplo. (/w) como /cw em vez de /c /w) e /word Muitos switches nome comando têm nomes completo e curto que podem ser usados de forma intercambiável. Você também pode criar um novo arquivo de um modelo. consulte Visual Studio comandos com argumentos. Você também pode criar seus próprios aliases personalizados ou alterar aliases predefinidos. consulte Predefinidas visual aliases de comando Studio. exibe a New File caixa de diálogo. Para exibir uma lista de todos os aliases atuais. tais como nomes de arquivo ou opções que executar um comando. em vez de como um Visual Studio 390 .MakeUpperCase Na próxima vez em que você selecione texto no editor e inserir >upper na janela. Escape caracteres Um caractere de interpolação (^) em uma linha de comando significa que o caractere imediatamente após ele é interpretada literalmente. Por exemplo. o comando File. incluindo a opção /t.NewFile. >File.Aliases de comando Você pode criar nomes curtos.Find também pode ser gravada /c. Para obter uma lista completa. Immedia janela te. com base em modelo " Arquivo General\Text ". o texto será exibido em letras maiúsculas. digite o seguinte comando na janela Command: >alias Comandos com argumentos Alguns comandos permitem que você para fornecer argumentos. o comando que exibe a New File caixa de diálogo tem o alias nf padrão. sem exibir todas as caixas de diálogo ou outras interfaces de usuário. ou aliases. Print. Esta seção explica os comandos e aliases disponíveis a partir da Command janela. a barra de status exibe a mensagem. Isso ocorre porque todas as versões localizadas do IDE entender inglês comandos.Find ^^t /regex Uma interpolação funciona da mesma se ele está dentro ou fora aspas. para este comando também pode ser gravado: >? varA As duas versões desse comando retornará o valor da variável varA. use o Comando Imprimir: >Debug. se o comando está disponível no momento ou não. Conclusão Automática para comandos A Command janela. para melhor compatibilidade entre inglês e versões localizadas do Visual Studio. ele será ignorado.NouveauFichier o mesmo comando. Embora você pode salvar macros usando um nome localizado. Por exemplo. Para exibir a Command janela. A lista de conclusão automático exibe todos os possíveis correspondentes nomes de comandos e aliases. Visual Studio 391 . Nomes de comandos internacionais Em versões localizadas do IDE.NewFile ou Fichier. carets. e selecione Command Window. Por exemplo. Predefinidas visual aliases de comando Studio Contém uma lista do availabe aliases comando predefinidas com Visual Studio. Visual Studio comandos com argumentos Contém informações sobre os Visual Studio comandos que obtém argumentos. barras à esquerda. Se você digitar ou selecionar um comando disponível. Immedia janela te. >Edit. Janela de Comando A Command janela é usada para executar comandos ou aliases diretamente no ambiente Visual Studio de desenvolvimento integrado (IDE). Isso pode ser usado para incorporar aspas normais ("). Nomes de macro são semelhantes aos nomes de comandos. Se uma interpolação for o último caractere na linha. Você pode executar os comandos de menu e comandos que não aparecem em qualquer menu. ou quaisquer outros caracteres literais em um valor parâmetro ou opção. Exibindo os valores de variáveis Para verificar o valor de uma variável varA. nomes de comandos podem ser inseridos no idioma nativo do IDE ou no inglês. O comando " não está disponível " e o comando será ignorado.caractere de controle. você pode digitar no francês IDE para executar uma File.Print varA O ponto de interrogação (?) é um alias para Debug. espaços. com exceção da opção nomes. mas nem todas as versões localizadas do IDE entende localizado um idioma diferente. e Find/Command Caixa fornecem conclusão automática quando você insere nomes de comandos e aliases. escolha Other Windows No menu View. é melhor para salvar macros usando nomes em inglês. se os valores de variáveis varA e varB são diferente. Ação Alternar entre a lista de comandos inseridos anteriormente.EvaluateStatement(varA=varB) Visual Studio 392 . pressionando ENTER. >cmd Os seguintes atalhos ajudam a navegar enquanto no modo de comando. Exemplo ? myvar Alterne para uma janela imediata. Isso permite que você para selecionar. Solução Preceda a expressão com um ponto de interrogação (?). e em seguida. O igual (=) sinal A janela utilizada para digitar o EvaluateStatement Comando determina se um sinal de igual (=) é interpretado como um operador de comparação ou como um operador de atribuição. SETA ABAIXO ou CTRL+SETA PARA BAIXO Dica Você pode copiar todos ou parte de um comando anterior para a linha de entrada. Você não pode usar operadores de atribuição na janela Command.Inserir comandos O maior que Símbolo. Rola para cima a janela. immed Alternar novamente para a janela de comando a partir de uma janela imediata. Inserir immed na janela sem o maior que (>) sinal Inserir cmd na janela. realçando todo ou parte dele. no você alternar automaticamente no modo marcar. Local do cursor Linha de entrada KeyBinding Seta para baixo e para baixo Conteúdo da janela de comando Conteúdo da janela de comando CTRL+SETA PARA CIMA Role para baixo a janela. Tarefa Avaliar uma expressão. um sinal de igual (=) é interpretado como um operador de comparação. Modo marcar Quando você clica em qualquer linha anterior na janela Command. Caso. e colá-los na linha atual. aparece na extremidade esquerda da janela de comando como um prompt para novas linhas (>) Use as teclas SETA PARA CIMA e SETA PARA BAIXO para rolar pela comandos emitidos anteriormente. Na janela Command. editar e copiar texto de comandos anteriores à medida que você faria em qualquer editor de texto. por exemplo. e o comando >Debug. rolagem a ele. EvaluateStatement(varA=varB) irá atribuir a variável varA o valor da variável varB. /pgm:123 equivale a /p:123 /g:123 /m:123. Várias opções de forma curta podem ser combinadas em um grupo. imprimir variável valores.Retornará um valor de False.ReplaceInFiles o comando e /case/pattern:regex são opções (exibirá o caractere de barra [/]) é regex o valor da opção /pattern. Por exemplo. Ele permite que você para Visual Studio 393 . por exemplo. Certas regras se aplicam ao lidar com tais comandos. Na janela Immediate. A posição do opções e parâmetros pode ser interchanged livremente na linha de comando com a exceção do comando Shell. ele será ignorado. um sinal de igual (=) é interpretado como um operador de atribuição. esse valor se aplicará a cada opção. a /case opção não tem valor e var[1-3]+oldpar são parâmetros Observação Qualquer comando. Quase cada opção suporte de um comando tem duas formas: Um formulário curto (um caractere) e uma forma longa. ou quaisquer outros caracteres literais em um valor parâmetro ou opção. Se uma interpolação for o último caractere na linha.Find ^^t /regex Uma interpolação funciona da mesma se ele está dentro ou fora aspas. execute instruções. com exceção da opção nomes. Isso pode ser usado para incorporar aspas normais ("). que requer suas opções e parâmetros em uma ordem específica. • • • • é Edit. opção. alterna e valores. Parâmetros. Por exemplo. parâmetro. carets. opções. O seguinte é um exemplo de um comando Rich para esclarecer a terminologia. barras à esquerda. Janela Immediate A Immediate janela é usada para depuração e avaliar expressões. e valores Alguns Visual Studio comandos comandos tem necessárias e argumentos opcionais. Escape caracteres Um caractere de interpolação (^) em uma linha de comando significa que o caractere imediatamente após ele é interpretada literalmente. o comando >Debug. e assim por diante. Um erro ocorre se qualquer uma das opções no grupo não aceita um valor. por outro lado. /p /g /m pode ser expresso como alternativa como /pgm. Edit. ou valor que contém espaços deve ter aspas duplas nos dois lados. >Edit. espaços. em vez de como um caractere de controle. Portanto. Se opções curta são combinados em um grupo e considerando um valor. Por exemplo.ReplaceInFiles /case /pattern:regex var[1-3]+ oldpar Neste exemplo. alternar para a Command janela. Por exemplo. Exibindo os valores de variáveis Esta janela pode ser especialmente útil quando estiver depurando um aplicativo. Observação Para emitir um Visual Studio Comando na janela Immediate. escolha Windows a partir do Debug Menu e selecione Immediate. Tarefa Avaliar uma expressão. Para exibir a Immediate janela. Os comandos disponíveis incluem EvaluateStatement. Solução Preceda a expressão com um ponto de interrogação (?). Modo marcar Visual Studio 394 . Digite o comando. para verificar o valor de uma variável myVar. abra um projeto para edição. Esta seção contém informações sobre os comandos disponíveis a partir da Immediate janela. Para inserir vários comandos. Inserir immed na janela sem o maior que (>) sinal. prefacing-lo >cmd com um maior sinal que (>). A Immediate janela também suporta IntelliSense. Alternar para a janela de comando. Você pode usar esta janela para emitir comandos individuais Visual Studio.Print. que pode ser usada para atribuir valores a variáveis. Use as teclas SETA PARA CIMA e SETA PARA BAIXO para rolar pela comandos emitidos anteriormente. >alias Inserir cmd na janela.Print varA O ponto de interrogação (?) é um alias para Debug. prefacing-lo com um maior sinal que (>). Inserir comandos Você deve digitar o maior que entrar (>) ao emitir Visual Studio comandos na janela Immediate.inserir expressões para ser avaliada ou executados pelo idioma de desenvolvimento durante a depuração. immed Alternar de volta para a janela Imediata. para este comando também pode ser gravado: >? varA As duas versões desse comando retornará o valor da variável varA. você pode usar o Comando Imprimir: >Debug. Comandos da janela Imediata Contém links para tópicos que descrevem os comandos disponíveis a partir da Immediate janela. você deve preceda o comando com um maior sinal que (>). Exemplo ? a+b Temporariamente entrar no modo Comando enquanto no modo Immediate (para executar um único comando). Quando você clica em qualquer linha anterior na janela Immediate. A Find/Command caixa está localizada em ferramentas padrão na maioria dos Visual Studio 2005 idiomas de programação. por outro lado. Localizar / comando caixa A Find/Command caixa permite que você a localizar e substituir texto. Na janela Immediate. Na janela Command. Você pode usar determinadas combinações de teclas com a caixa Localizar / comando. Caso. Para obter mais informações. Localizar e substituir Por padrão. o comando >Debug. quando você digitar texto na caixa Find/Command e pressione ENTER. um sinal de igual (=) é interpretado como um operador de atribuição. um sinal de igual (=) é interpretado como um operador de comparação. se os valores de variáveis varA e varB são diferente. A Find/Command caixa mantém os itens inseridos últimas 20 e exibe-os em uma lista drop-down. preceda-los com um caractere maior que (>). Portanto. O igual (=) sinal A janela utilizada para digitar o EvaluateStatement Comando determina se um sinal de igual (=) é interpretado como um operador de comparação ou como um operador de atribuição. e colá-los na linha atual.EvaluateStatement(varA=varB) Retornará um valor de False. Para Localizar uma seqüência Na caixa Comando Digite a seqüência e pressione ENTER Visual Studio 395 . Isso permite que você para selecionar. Não use operações de atribuição na janela Command. o clique com o mouse ou pressione CTRL + /. consulte Localizando e substituindo. Você pode navegar através da lista usando as teclas SETA. editar e copiar texto de comandos anteriores à medida que você faria em qualquer editor de texto. Localizar / comando caixa Para ir para a Find/Command caixa. ele procura o texto no documento atual ou janela usando as opções especificadas na pesquisa e substituição a Localizar e Substituir janela.EvaluateStatement(varA=varB) irá atribuir a variável varA o valor da variável varB. por exemplo. e o comando >Debug. Para emitir comandos individuais Visual Studio. por exemplo. no você alternar automaticamente no modo marcar. e para executar comandos. Por exemplo. por exemplo. Personalizar caixa de diálogo Visual Studio () A Commands guia permite que você para adicionar e remover comandos nas barras de ferramentas. exibindo as definições de pesquisa atual. digite o Visual Studio comando.Find ^^t /regex Uma interpolação funciona da mesma se ele está dentro ou fora aspas. será exibida a Find Results 1 janela Find "mybutton". Se. ou quaisquer outros caracteres literais em um valor parâmetro ou opção. Se uma interpolação for o último caractere na linha.NewFile c:\temp\MyFile /t:"General\Text File" Como alternativa. outros ter necessário argumentos em sua sintaxe. a janela Localizar resultados 1 aparecerá. você também pode usar a janela de comando para inserir e executar um ou vários comandos. Consulte Comandos guia. a última vez você pesquisados do Rápido Localizar. barras à esquerda. >Edit. Current document Inserir comandos Para usar a Find/Command caixa para emitir um único Visual Studio Comando ou alias em vez de procurar por texto. Localizar e Substituir janela. com exceção da opção nomes. Por exemplo: >File. Selecione Customize no menu Tools para exibir a Customize caixa de diálogo e escolha Commands. Observação As opções disponíveis nas caixas de diálogo e os nomes e locais dos comandos de menu que você vê Visual Studio 396 . e alterar as imagens usadas para botões da barra de ferramentas. em vez de como um caractere de controle. Isso pode ser usado para incorporar aspas normais (").Localizar a próxima ocorrência da seqüência Pesquisar a índice da Ajuda Navegue até uma linha de código específica Localizar um objeto Pressione ENTER Digite a seqüência e pressione F1 Digite o número da linha e pressione CTRL + G Digite a seqüência e pressione F2 Ao procurar na caixa Find/Command. espaços. Para obter uma lista de comandos. Alguns comandos ou aliases podem ser inseridos e executados por si. Escape caracteres Um caractere de interpolação (^) em uma linha de comando significa que o caractere imediatamente após ele é interpretada literalmente. Para obter uma lista de comandos que possuem argumentos. exibirá um símbolo maior que (>). consulte Visual Studio Comandos e opções. ele será ignorado. você selecionado a Match case opção. consulte Visual Studio comandos com argumentos. carets. Match case. Reorganizar Comandos Exibe a Rearrange Commands caixa de diálogo. ou especificar se deseja exibir texto em vez de uma imagem para o comando. dependendo da quais ferramentas e designers estão disponíveis. caixa de diálogo Opções. o título menu aparecerá duas vezes. Comandos Exibe os comandos e imagens comando baseadas na categoria que você selecionou. Categorias Especifica o conjunto de comandos que são exibidos na caixa Commands de listagem. Esta lista de títulos é dinâmica. escolha Import and Export Settings No menu Tools. Modificar seleção Exibe uma lista de comandos você pode usar para personalizar a exibição do botão na barra de ferramentas. Por exemplo. para que você possa modificar menus. oferecendo dois conjuntos comando diferente. Ambiente. para que você pode especificar combinações de teclas de atalho para comandos. dependendo de suas configurações ativas ou da edição. permitindo que a ordem das categorias e títulos menu para alterar. Visual Studio 397 . consulte Configurações do Visual Studio. Este botão estará disponível depois que você selecionar um botão de comando em uma barra de ferramentas que deseja personalizar. Observação Não é possível para dois menus em designers diferentes para compartilhar o mesmo título. Você pode arrastar um comando para a barra de ferramentas que você deseja personalizar. e seus menus se tiver sido personalizados.podem diferir do que é descrito na Ajuda. As categorias de comandos são baseadas em títulos menu fornecidos pela ferramentas e designers que o ambiente atualmente suporta. Para obter mais informações. poderá alterar as teclas Imagem ou acelerador. Para alterar as configurações. Teclado Exibe o teclado. Em tais casos.