Readme_Exemplo do componente Alterar Maiúsculas e Minúsculas

Artigo
09/18/2009

Esse exemplo funciona apenas com o SQL Server 2005 e o SQL Server 2008. Ele não funcionará com nenhuma versão do SQL Server anterior ao SQL Server 2005.

O exemplo Alterar Maiúsculas e Minúsculas demonstra um componente de transformação com uma saída síncrona. Esse componente altera o padrão de maiúsculas e minúsculas de um caractere em uma cadeia de caracteres, modificando um único caractere na coluna especificada, à medida que as linhas passam pelo componente. Para permitir que os usuários do componente especifiquem o caractere na coluna e o tipo de conversão que está ocorrendo, o componente adiciona duas propriedades personalizadas na coluna de entrada de cada coluna selecionada para o componente. Essas propriedades especificam o caractere a ser alterado na coluna e se ele deve ser alterado para maiúscula ou minúscula.

Dica

Para obter mais informações sobre componentes com saídas síncronas, consulte "Criando um componente de transformação com saídas síncronas" nos Manuais Online do SQL Server.

Esse exemplo demonstra também como implementar uma saída de erro para um componente de fluxo de dados. Se o usuário especificou redirecionar linhas para a saída de erro, o componente irá direcionar uma linha para sua saída de erro quando o índice do caractere a ser alterado exceder o comprimento da cadeia de caracteres.

Este exemplo não tem suporte em sistemas operacionais com base no Itanium.

Importante

Os exemplos de código de Programação de Fluxo de Dados do Integration Services destinam-se a demonstrar a funcionalidade básica que você deve implementar para criar um componente de fluxo de dados personalizado. Os exemplos não incluem suporte completo para personalização no Editor Avançado. Por exemplo, você não pode usar o Editor Avançado para adicionar ou remover entradas e saídas ou configurar colunas.

Os exemplos são fornecidos somente para fins educativos. Eles não devem ser usados em um ambiente de produção nem foram testados nesse tipo de ambiente. A Microsoft não fornece suporte técnico para esses exemplos.

Executando o exemplo

Se você já souber como localizar, criar e instalar exemplos de código, poderá ir diretamente para a seção Testando o exemplo e ler sobre como configurar e executar o exemplo de código.

Pré-requisitos

Este exemplo requer que os seguintes componentes sejam instalados.

Microsoft Visual Studio
Microsoft SQL Server Integration Services

Local

Se o exemplo de código tiver sido instalado no local padrão, o exemplo estará localizado no seguinte diretório:

C:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Integration Services\Programming Samples\Data Flow\ChangeCase Component Sample

A solução C# do exemplo de código está localizada no diretório CS e a solução Visual Basic, no diretório VB.

Para obter informações sobre o processo de duas etapas necessário para instalar os exemplos, consulte Considerações para instalar exemplos e bancos de dados de exemplo do SQL Server.

Criando o exemplo

Se você ainda não gerou um arquivo de chave de nome forte na pasta Exemplos, use o procedimento a seguir para gerar esse arquivo. Os projetos de exemplo são configurados para assinar assemblies no momento da criação com este arquivo de chave. Você pode exibir as propriedades de assinatura na guia Assinatura da caixa de diálogo Propriedades do Projeto.

Para gerar um arquivo de chave de nome forte

Para abrir um prompt de comando do Microsoft Visual Studio, clique em Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2008, Visual Studio Tools e clique em Prompt de comando do Visual Studio 2008.

- ou -

Para abrir um prompt de comando do Microsoft .NET Framework, clique em Iniciar, aponte para Todos os Programas, Microsoft .NET Framework SDK 2.0 e clique em Prompt de Comando do SDK.
No prompt de comando, use o comando CD (alterar diretório) para alterar a pasta atual da janela Prompt de Comando para a pasta Exemplos. O arquivo de chave que você criar nessa pasta será usado por todos os exemplos de código do SQL Server.

Dica

Para determinar a pasta onde se encontram os exemplos, clique em Iniciar, aponte para Todos os Programas, aponte para Microsoft SQL Server 2008, aponte para Documentação e Tutoriais e clique em Diretório de Exemplos. Se o local de instalação padrão tiver sido usado, os exemplos estarão localizados em <unidade>:\Arquivos de Programas\Microsoft SQL Server\100\Samples.
No prompt de comando, execute o seguinte comando para gerar o arquivo de chave:
```
sn -k SampleKey.snk
```
Importante

Para obter mais informações sobre um par de chaves de nome forte, consulte "Resumos de segurança: nomes fortes e segurança no .NET Framework" no .NET Development Center do MSDN.

Para criar o exemplo no Microsoft Visual Studio 2008

No menu Arquivo | Abrir, clique em Projeto e abra ChangeCase.sln em sua linguagem de programação preferida.
No menu Criar, clique em Criar ChangeCase para criar o projeto.

Instalando o exemplo

Este exemplo é fornecido em Visual Basic e C#. Para distinguir os assemblies de cada versão do exemplo, CS ou VB são anexados ao nome do assembly de saída. Depois de criar com êxito o componente, siga estas etapas para adicioná-lo a uma tarefa Fluxo de Dados no Business Intelligence Development Studio.

Para copiar o componente à pasta PipelineComponents

Abra o Windows Explorer ou o aplicativo de sua preferência para trabalhar no sistema de arquivos.
Copie o assembly (ChangeCaseCS.dll ou ChangeCaseVB.dll) para a pasta PipelineComponents localizada em %system%\Arquivos de Programas\Microsoft SQL Server\100\DTS.

Para instalar o componente no GAC (cache de assembly global) arrastando o assembly

Abra o Windows Explorer ou o aplicativo de sua preferência para trabalhar no sistema de arquivos.
Arraste o assembly da pasta PipelineComponents para a pasta onde o GAC (cache de assembly global) está localizado, em %system%\assembly.

Para instalar o componente no GAC (Cache de Assembly Global) usando gacutil.exe

Abra uma janela do prompt de comando.
Digite o seguinte comando para executar gacutil.exe e instalar a versão C# do componente no GAC:

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\100\DTS\PipelineComponents\ ChangeCaseCS.dll "

- ou -

Digite o seguinte comando para executar gacutil.exe e instalar a versão do Visual Basic do componente no GAC:

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\100\DTS\PipelineComponents\ ChangeCaseVB.dll "

Para adicionar o componente à Caixa de Ferramentas

Abra o Business Intelligence Development Studio.
Clique com o botão direito do mouse na caixa de ferramentas e clique em Escolher Itens.
Na caixa de diálogo Escolher Itens da Caixa de Ferramentas, clique na guia Itens de Fluxo de Dados SSIS.
Clique na caixa de seleção de seu componente e clique em OK.

Dica

Se o componente não for exibido na lista, clique em Procurar para localizar o componente. Porém, nesse caso, talvez ele não seja instalado corretamente.

Depois de concluir essas etapas, o componente estará visível na seção Transformações de Fluxo de Dados da Caixa de Ferramentas e poderá ser adicionado à tarefa Fluxo de Dados no designer .

Testando o exemplo

Depois de adicionar o componente de exemplo à tarefa Fluxo de Dados e conectá-lo a um componente que fornecerá linhas a ele, você poderá configurá-lo como consta no Designer SSIS.

Para configurar o componente de exemplo em um pacote

Clique na guia Colunas de Entrada do Editor Avançado e selecione as colunas que o componente modificará. O tipo de utilização das colunas selecionadas deve ser definido como Leitura/Gravação porque o componente modifica os valores da coluna em vigor à medida que processa cada uma das linhas de dados de entrada.
Clique na guia Propriedades da Coluna do Editor Avançado para especificar o índice de caracteres baseado em zero para modificar em cada coluna de entrada que é modificada e também para especificar se o caractere daquele índice deve ser alterado para maiúscula (0) ou minúscula (1).

Share via