Noções básicas sobre o arquivo de personalização

Cada cabeçalho de seção no arquivo de personalização consiste em colchetes ([]) contendo um tipo e um parâmetro. Os quatro tipos de seção são indicados pelas cadeias de caracteres literais connect, sql, userlist ou logs. O parâmetro é a cadeia de caracteres literal, o padrão, um identificador especificado pelo usuário ou nada.

Importante

A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.

Portanto, cada seção é marcada com um dos seguintes cabeçalhos de seção:

  
[ connect default ] [ connect    
identifier   
] [ sql  default ] [ sql    
identifier   
] [ userlist    
identifier   
] [ logs ]  
  

Os cabeçalhos de seção têm as partes a seguir.

Parte	Descrição
connect	Uma cadeia de caracteres literal que modifica uma cadeia de conexão.
sql	Uma cadeia de caracteres literal que modifica uma cadeia de caracteres de comando.
userlist	Uma cadeia de caracteres literal que modifica os direitos de acesso de um usuário específico.
logs	Uma cadeia de caracteres literal que especifica um arquivo de log que registra erros operacionais.
default	Uma cadeia de caracteres literal que será usada se nenhum identificador for especificado ou encontrado.
identifier	Uma cadeia de caracteres que corresponde a uma cadeia de caracteres na cadeia de caracteres connect ou command. – Use esta seção se o cabeçalho da seção contiver connect e a cadeia de caracteres do identificador for encontrada na cadeia de conexão. – Use esta seção se o cabeçalho da seção contiver sql e a cadeia de caracteres do identificador for encontrada na cadeia de caracteres de comando. – Use esta seção se o cabeçalho da seção contiver userlist e a cadeia de caracteres do identificador corresponder a um identificador de seção connect.

O DataFactory chama o manipulador, transmitindo os parâmetros do cliente. O manipulador pesquisa cadeias de caracteres inteiras nos parâmetros do cliente que correspondem aos identificadores nos cabeçalhos de seção apropriados. Se uma correspondência for encontrada, o conteúdo dessa seção será aplicado ao parâmetro do cliente.

Uma seção específica é usada nas seguintes circunstâncias:

• Uma seção connect será usada se a parte do valor da palavra-chave da cadeia de conexão do cliente, "Data Source=value", corresponder a um identificador de seção connect.

• Uma seção sql será usada se a cadeia de caracteres de comando do cliente contiver uma cadeia de caracteres que corresponda a um identificador de seção sql.

• Uma seção connect ou sql com um parâmetro padrão será usada se não houver nenhum identificador correspondente.

• Uma seção userlist será usada se o identificador da seção userlist corresponder a um identificador de seção connect. Se houver uma correspondência, o conteúdo da seção userlist será aplicado à conexão regida pela seção connect.

• Se a cadeia de caracteres em uma conexão ou cadeia de caracteres de comando não corresponder ao identificador em nenhum cabeçalho de seção connect ou sql e não houver nenhum cabeçalho de seção connect ou sql com um parâmetro padrão, a cadeia de caracteres do cliente será usada sem modificação.

• A seção logs é usada sempre que o DataFactory está em operação.

Consulte Também

Seção Conexão do arquivo de personalização
Seção Logs do arquivo de personalização
Seção SQL do arquivo de personalização
Seção UserList do arquivo de personalização
Personalização do DataFactory
Configurações necessárias de cliente
Escrever seu próprio manipulador personalizado