Présentation du fichier de personnalisation

Chaque en-tête de section du fichier de personnalisation se compose de crochets ([]) contenant un type et un paramètre. Les quatre types de section sont indiqués par les chaînes littérales connect, sql, userlist et logs. Le paramètre est la chaîne littérale, la valeur par défaut, un identificateur spécifié par l’utilisateur ou rien.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.

Par conséquent, chaque section est marquée avec l’un des en-têtes de section suivants :

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

Les en-têtes de section ont les parties suivantes.

Élément	Description
connect	Chaîne littérale qui modifie une chaîne de connexion.
sql	Chaîne littérale qui modifie une chaîne de commande.
userlist	Chaîne littérale qui modifie les droits d’accès d’un utilisateur spécifique.
logs	Chaîne littérale qui spécifie une erreur opérationnelle d’enregistrement de fichier journal.
default	Chaîne littérale utilisée si aucun identificateur n’est spécifié ou trouvé.
identifier	Chaîne qui correspond à une chaîne dans la chaîne connect ou command. - Utilisez cette section si l’en-tête de section contient connect et que la chaîne d’identificateur est trouvée dans la chaîne de connexion. - Utilisez cette section si l’en-tête de section contient sql et que la chaîne d’identificateur est trouvée dans la chaîne de commande. - Utilisez cette section si l’en-tête de section contient userlist et que la chaîne d’identificateur correspond à un identificateur de section connect.

DataFactory appelle le gestionnaire, en passant des paramètres clients. Le gestionnaire recherche des chaînes entières dans les paramètres clients qui correspondent aux identificateurs dans les en-têtes de section appropriés. Si une correspondance est trouvée, le contenu de cette section est appliqué au paramètre client.

Une section particulière est utilisée dans les circonstances suivantes :

• Une section connect est utilisée si la partie valeur du mot clé de chaîne de connexion client « Data Source=value », correspond à un identificateur de section connect.

• Une section sql est utilisée si la chaîne de commande cliente contient une chaîne qui correspond à un identificateur de section sql.

• Une section connect ou sql avec un paramètre par défaut est utilisée s’il n’existe aucun identificateur correspondant.

• Une section userlist est utilisée si l’identificateur de section userlist correspond à un identificateur de section connect. S’il existe une correspondance, le contenu de la section userlist est appliqué à la connexion régie par la section connect.

• Si la chaîne d’une chaîne de connexion ou de commande ne correspond à aucun identificateur dans les en-têtes de section connect ou sql, et qu’il n’y a pas d’en-tête de section connect ou sql avec un paramètre par défaut, la chaîne cliente est utilisée sans modification.

• La section logs est utilisée chaque fois que DataFactory est en cours de fonctionnement.

Voir aussi

Fichier de personnalisation, section connect
Fichier de personnalisation, section Logs
Fichier de personnalisation, section SQL
Fichier de personnalisation, section UserList
Personnalisation de DataFactory
Paramètres client obligatoires
Écriture d’un gestionnaire personnalisé