Mappages de types personnalisés SQL-CLR (LINQ to SQL)

Le mappage de type entre SQL Server et le langage Common Language Runtime (CLR) est automatiquement spécifié lorsque vous utilisez l'outil de ligne de commande SQLMetal ou le Concepteur Objet/Relationnel (Concepteur O/R).

Lorsqu'aucun mappage personnalisé n'est effectué, ces outils assignent des mappages de types par défaut, comme décrit dans Mappage de type SQL-CLR (LINQ to SQL). Si vous souhaitez que les mappages de types s'effectuent différemment de ceux par défaut, vous devez les personnaliser.

Lors de la personnalisation des mappages de types, l'approche recommandée consiste à modifier un fichier DBML intermédiaire. Vous devez ensuite utiliser ce fichier DBML personnalisé lorsque vous créez les fichiers de code et de mappage à l'aide de SQLMetal ou du Concepteur O/R.

Après avoir instancié l'objet DataContext à partir des fichiers de code et de mappage, la méthode DataContext.CreateDatabase crée une base de données en fonction des mappages de types spécifiés. En l'absence d'attributs type CLR spécifié dans les mappages, les mappages de types par défaut sont utilisés.

Personnalisation à l'aide de SQLMetal ou du Concepteur O/R

SQLMetal et le Concepteur O/R vous permettent de créer automatiquement un modèle objet qui inclut les informations de mappage de type à l'intérieur ou à l'extérieur du fichier de code. Ces fichiers étant remplacés par SQLMetal ou le Concepteur O/R, chaque fois que vous recréez vos mappages, l'approche recommandée en termes de spécification de mappages de types personnalisés consiste à personnaliser un fichier DBML.

Pour personnaliser des mappages de types à l'aide de SQLMetal ou du Concepteur OR, commencez par générer un fichier DBML. Puis, avant de générer le fichier de code ou de mappage, modifiez ce fichier DBML de façon à identifier les mappages de types souhaités. Si vous utilisez SQLMetal, vous devez modifier manuellement les attributs Type et DbType dans le fichier DBML pour personnaliser les mappages de types. Si vous utilisez le Concepteur O/R, vous pouvez apporter vos modifications dans celui-ci. Pour plus d'informations sur l'utilisation du Concepteur O/R, consultez Concepteur Objet/Relationnel (Concepteur O/R).

Remarque
Certains mappages de types peuvent entraîner des exceptions de dépassement de capacité ou de perte de données lors de la traduction à partir de la base de données ou vers celle-ci.Consultez attentivement la matrice de comportement au moment de l'exécution de mappages de types dans Mappage de type SQL-CLR (LINQ to SQL) avant de procéder à la personnalisation.

Pour que SQLMetal ou le Concepteur O/R reconnaisse les personnalisations de mappage de type, vous devez vous assurer que ces outils incluent le chemin d'accès à votre fichier DBML personnalisé lorsque vous générez le fichier de code ou de mappage externe. Même si cela n'est pas requis dans le cadre de la personnalisation de mappage de type, nous vous recommandons de séparer systématiquement les informations de mappage de type du fichier de code et de générer le fichier de mappage externe supplémentaire. Cela offre une certaine souplesse en vous évitant d'avoir à recompiler le fichier de code.

Intégration des modifications de base de données

En cas de modification de la base de données, vous devez mettre à jour le fichier DBML afin qu'il prenne ces modifications en compte. L'une des méthodes utilisées consiste à créer automatiquement un nouveau fichier DBML et à effectuer de nouveau les personnalisations de mappage de type. Vous pouvez aussi comparer les différences entre le nouveau fichier DBML et le fichier DBML personnalisé, puis mettre ce dernier à jour manuellement afin de prendre en compte les modifications de base de données.

Voir aussi

Référence

Mappage de type SQL-CLR (LINQ to SQL)

Concepts

Génération de code dans LINQ to SQL