Exemplo de tecnologia de construção de objeto
Este exemplo demonstra o uso de objeto seqüências de caracteres de construção em um ambiente. NET.Strings de construção de objetos são seqüências de caracteres de inicialização que podem ser especificadas ou editadas por meio da ferramenta administrativa Serviços de componente, eliminando a necessidade de codificar as informações de configuração dentro de componentes.Interface do usuário do exemplo é um formulário com um botão que cria um objeto que usa seqüências de caracteres de construção.Caixas de mensagens exibem os vários estágios de ativação.
Para obter informações sobre como usar os exemplos, consulte os tópicos a seguir:
Para compilação a amostra usando o aviso de comando
Aberto o janela do aviso de comando e navegar até um de subpastas sob o diretório Technologies\ComponentServices\ObjectConstruction específicos do linguagem.
Tipo de MSBuild ObjectConstructionCS.sln or MSBuild ObjectConstructionVB.sln, dependendo de sua escolha de linguagem de programação.
Para compilação a amostra usando o Visual Studio
em aberto Windows Explorer e navegar até um de subpastas sob o diretório Technologies\ComponentServices\ObjectConstruction específicos do linguagem.
clicar duas vezes no ícone para ObjectConstructionCS.sln ou ObjectConstructionVB.sln, dependendo de sua escolha de linguagem, de programação para em em aberto o arquivo no Visual Studio.
Sobre o Compilação menu, clicar Criar solução.
Para executar este exemplo
Abra a janela do aviso de comando ou no Windows Explorer e navegar até o diretório que contém o arquivo executável compilado.
Tipo de OCDemo.exe na linha de comando ou no início do arquivo executável clicando duas vezes no Windows Explorer.Observação Se você está executando a versão do Visual Basic (no subdiretório \VB) do aplicativo de exemplo ou translation from VPE for Csharp (no subdiretório \CS) sistema autônomo isso determinará qual componente COM + atributos você editará administrativamente em uma etapa posterior.
Quando o programa é iniciado, clicar no botão rotulado como Criar objeto.Uma caixa de mensagem será exibida em cada preparar de ativação.Anote o valor de seqüência de caracteres de construção de objeto informado na telefonar para IObjectConstruct::Construct.
Iniciar a ferramenta administrativa Serviços de componente clicando em Iniciar-> todos os programas-> Ferramentas administrativas-> Serviços de componentes e localizar o aplicativo COM + OCDemoSvr expandindo aplicativos Computer\COM + Services\Computers\My componente no painel esquerdo do navegador.
localizar o componente Microsoft.Exemplos.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest expandindo OCDemoSvr\Components.
clicar com o botão direito do mouse no componente ObjectConstructionTest e selecionar Propriedades no menu pop-up.
clicar no Ativação guia e insira um valor de texto novo no campo de edição de seqüência de caracteres de construtor.clicar OK para aceitar a alterar.
Retorne para o aplicativo OCDemo e clicar Criar objeto novamente.Observe o valor novo reportado pelo método IObjectConstruct (ele deve ser a string recém-editada COM + explorer componente página de propriedades).
Para desinstalar a amostra
navegar até o diretório onde você executou o msbuild.exe ou abrir o arquivo .sln.
Tipo de /t ObjectConstructionVB.sln MSBuild.exe: limpeza or /t ObjectConstructionCS.sln MSBuild.exe: limpeza, dependendo de sua escolha de linguagem, na linha de comando de programação.Isso chama o Ferramenta de instalação de serviços do .NET (Regsvcs.exe) e o Global ferramenta cache assembly (Gacutil.exe) com comutador /u para remover os arquivos de amostra do catálogo COM + e o cache de assembly global.
Requisitos
Plataforma: Windows 2000, Windows XP, Windows servidor 2003
.NET estrutura versão: 2.0, 1.1, 1.0
Comentários
Para obter mais informações sobre criação binário de amostra e as etapas de inscrição, consulte os comentários em arquivos de código-fonte.
Este procedimento mostra como criar um componente COM + com construção de objetos ativado e usando uma seqüência de caracteres de construção padrão.Criar uma instância de objeto, vários métodos de componente exibem caixas de mensagens para demonstrar o pedido de telefonar.Você modificar a seqüência de caracteres de construção de objeto usando a ferramenta de administração de serviços de componente e execute novamente o exemplo para observar que a seqüência de caracteres de construção do objeto passado para a ocorrência do componente foi alterado.
.gif "Observação") Observação: |
|---|
Você deve usar o Global ferramenta cache assembly (Gacutil.exe) Para instalar o conjunto de OCDemoSvr.dll para o global cache de assemblies antes de executar a amostra. Gacutil.exe está localizado no SDK\ <versão> No diretório \Bin.Por exemplo, se você criou a versão do Visual Basic do exemplo, navegar até a pasta C:\Documents and Settings\ O nome de usuário\Meus Documentos\ Exemplos\Technologies\ComponentServices\ObjectConstruction\VB diretório e tipo de gacutil -i OCDemoSvr.dll. |
O nome do componente conforme exibido na ferramenta administrativa Serviços de componentes é Microsoft.Exemplos.Technologies.ComponentServices.ObjectConstruction.ObjectConstructionTest.
Quando construção do objeto está habilitada para um componente, COM + chama e implementa o IObjectContruct::Construct método imediatamente depois que ele cria uma instância do objeto. A seqüência de construção do objeto especificada sistema autônomo propriedades de ativação do componente é passada sistema autônomo um argumento ao método.Isso, em combinação com o código do componente que usa corretamente a seqüência de caracteres do objeto, efetivamente fornece construção do objeto com parâmetros.
Você pode especificar um valor de seqüência de caracteres padrão para a seqüência de caracteres de construção na propriedade padrão do ConstructionEnabledAttribute, em catálogo COM +, ou ambos.
Um desenvolvedor de componentes pode usar esse recurso, por exemplo, para escrever um componente que mantém uma conexão ODBC genérica.A seqüência de caracteres de construção do objeto seria Isenção um DSN exato que pode ser alterado com a ferramenta administrativa Serviços de componentes.
Strings de construção de objetos podem ser útil em combinação com + objeto pooling de serviços.
Consulte também
Conceitos
Usar tipos de COM em código gerenciado
Referência
Global ferramenta cache assembly (Gacutil.exe)