Mappage de type SQL-CLR (LINQ to SQL)

Article
08/23/2008

Mise à jour : November 2007

Dans LINQ to SQL, le modèle de données d'une base de données relationnelle mappe à un modèle objet qui est exprimé dans le langage de programmation de votre choix. Lors de l'exécution de l'application, LINQ to SQL traduit les requêtes LINQ dans le modèle objet en SQL et les envoie à la base de données pour exécution. Lorsque la base de données retourne les résultats, LINQ to SQL traduit ces derniers en objets que vous pouvez utiliser dans votre propre langage de programmation.

Pour traduire des données entre le modèle objet et la base de données, un mappage de type doit être défini. LINQ to SQL utilise un mappage de type pour faire correspondre chaque type CLR (Common Language Runtime) à un type SQL Server particulier. Vous pouvez définir des mappages de types et d'autres informations de mappage, telles que la structure de la base de données et les relations entre les tables, à l'intérieur du modèle objet à l'aide du mappage basé sur des attributs. Vous pouvez également spécifier les informations de mappage en dehors du modèle objet à l'aide d'un fichier de mappage externe. Pour plus d'informations, consultez Mappage basé sur les attributs (LINQ to SQL) et Référence de mappage externe (LINQ to SQL).

Cette rubrique aborde les points suivants :

Mappage de type par défaut
Matrice de comportement au moment de l'exécution de mappages de types
Différences de comportement entre l'exécution CLR et l'exécution SQL
Mappage d'enum
Mappage de types numériques
Mappage de texte et mappage XML
Mappage de types de date et d'heure
Mappage de types binaires
Mappages divers

Mappage de type par défaut

Vous pouvez créer automatiquement le modèle objet ou le fichier de mappage externe à l'aide du Concepteur Objet/Relationnel (Concepteur O/R) ou de l'outil de ligne de commande SQLMetal. Les mappages de types par défaut pour ces outils définissent les types CLR qui sont choisis pour mapper à des colonnes à l'intérieur de la base de données SQL Server. Pour plus d'informations sur l'utilisation de ces outils, consultez Création du modèle objet (LINQ to SQL).

Vous pouvez également utiliser la méthode CreateDatabase pour créer une base de données SQL Server basée sur les informations de mappage contenues dans le modèle objet ou le fichier de mappage externe. Les mappages de types par défaut pour la méthode CreateDatabase définissent le type des colonnes SQL Server qui sont créées pour mapper aux types CLR définis dans le modèle objet. Pour plus d'informations, consultez Procédure : créer dynamiquement une base de données (LINQ to SQL).

Matrice de comportement au moment de l'exécution de mappages de types

Le diagramme suivant présente le comportement au moment de l'exécution attendu de mappages de types spécifiques lorsque des données sont récupérées de la base de données ou enregistrées dans celle-ci. À l'exception de la sérialisation, LINQ to SQL ne prend pas en charge le mappage entre des types de données CLR ou SQL Server qui ne sont pas spécifiés dans cette matrice. Pour plus d'informations sur la prise en charge de la sérialisation, consultez Sérialisation binaire.

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.

Mappage pour les types SQL et CLR

Mappage de type personnalisé

Avec LINQ to SQL, vous n'êtes pas limité aux mappages de types par défaut utilisés par le Concepteur O/R, SQLMetal et la méthode CreateDatabase. Vous pouvez créer des mappages de types personnalisés en les spécifiant explicitement dans un fichier DBML. Ce fichier vous permet ensuite de créer le fichier de code du modèle objet et de mappage. Pour plus d'informations, consultez Mappages de types personnalisés SQL-CLR (LINQ to SQL).

Différences de comportement entre l'exécution CLR et l'exécution SQL

En raison des différences de précision et d'exécution entre le CLR et SQL Server, vous pouvez obtenir des résultats différents ou un comportement différent en fonction de l'endroit où vous effectuez vos calculs. Les calculs effectués dans des requêtes LINQ to SQL sont en fait traduits en données Transact-SQL, puis exécutés sur la base de données SQL Server. Les calculs effectués en dehors de requêtes LINQ to SQL sont exécutés dans le contexte du CLR.

Voici, par exemple, quelques-unes des différences de comportement existant entre le CLR et SQL Server :

SQL Server trie certains types de données différemment des données de type équivalent dans le CLR. Par exemple, le type de données SQL Server UNIQUEIDENTIFIER est trié différemment du type de données CLR System.Guid.
SQL Server gère certaines opérations de comparaison de chaînes différemment par rapport au CLR. Dans SQL Server, le comportement de comparaison de chaînes dépend des paramètres de classement définis sur le serveur. Pour plus d'informations, consultez Utilisation des classements dans la documentation en ligne de SQL Server.
SQL Server peut retourner des valeurs différentes pour certaines fonctions mappées par rapport au CLR. Par exemple, les fonctions d'égalité sont différentes car SQL Server considère que deux chaînes sont égales si elles ne diffèrent que par l'espace en fin de chaîne, tandis que le CLR les considère alors comme différentes.

Mappage d'enum

LINQ to SQL prend en charge le mappage du type System.Enum CLR à des types SQL Serveur de deux façons :

Mappage à des types numériques SQL (TINYINT, SMALLINT, INT, BIGINT)

Lorsque vous mappez un type System.Enum CLR à un type numérique SQL, vous mappez la valeur entière sous-jacente du type System.Enum CLR à la valeur de la colonne de la base de données SQL Server. Par exemple, si un type System.Enum nommé DaysOfWeek contient un membre nommé Tue ayant la valeur entière sous-jacente 3, ce membre mappe à une valeur 3 de la base de données.
Mappage à des types texte SQL (CHAR, NCHAR, VARCHAR, NVARCHAR)

Lorsque vous mappez un type System.Enum CLR à un type texte SQL, la valeur de la base de données SQL est mappée aux noms des membres System.Enum CLR. Par exemple, si un type System.Enum nommé DaysOfWeek contient un membre nommé Tue ayant la valeur entière sous-jacente 3, ce membre mappe à une valeur Tue de la base de données.

Remarque :
Lors du mappage de types texte SQL à un type System.Enum CLR, incluez uniquement les noms des membres Enum dans la colonne SQL mappée. Les autres valeurs ne sont pas prises en charge dans la colonne SQL mappée à Enum.

Le Concepteur O/R et l'outil de ligne de commande SQLMetal ne peuvent pas mapper automatiquement un type à une classe Enum CLR. Vous devez configurer explicitement ce mappage en personnalisant un fichier DBML destiné à être utilisé par le Concepteur O/R et SQLMetal. Pour plus d'informations sur le mappage de type personnalisé, consultez Mappages de types personnalisés SQL-CLR (LINQ to SQL).

Du fait qu'une colonne SQL destinée à l'énumération sera du même type que les autres colonnes de texte ou numériques, ces outils ne reconnaîtront pas votre intention et procèderont par défaut au mappage décrit dans les sections Mappage de types numériques et Mappage de texte et mappage XML suivantes. Pour plus d'informations sur la génération de code avec le fichier DBML, consultez Génération de code dans LINQ to SQL.

La méthode DataContext.CreateDatabase crée une colonne SQL de type numérique pour mapper un type System.Enum CLR.

Mappage de types numériques

LINQ to SQL vous permet de mapper de nombreux types numériques CLR et SQL Server. Le tableau suivant présente les types CLR que le Concepteur O/R et SQLMetal sélectionnent lors de la création d'un modèle objet ou d'un fichier de mappage externe basé sur votre base de données.

Type SQL Server	Mappage de type CLR par défaut utilisé par le Concepteur O/R et SQLMetal
BIT	System.Boolean
TINYINT	System.Int16
INT	System.Int32
BIGINT	System.Int64
SMALLMONEY	System.Decimal
MONEY	System.Decimal
DECIMAL	System.Decimal
NUMERIC	System.Decimal
REAL/FLOAT(24)	System.Single
FLOAT/FLOAT(53)	System.Double

Le tableau suivant présente les mappages de types par défaut utilisés par la méthode DataContext.CreateDatabase pour définir le type des colonnes SQL Server qui sont créées pour mapper aux types CLR définis dans votre modèle objet ou votre fichier de mappage externe.

Type CLR	Type SQL Server par défaut utilisé par DataContext.CreateDatabase
System.Boolean	BIT
System.Byte	TINYINT
System.Int16	SMALLINT
System.Int32	INT
System.Int64	BIGINT
System.SByte	SMALLINT
System.UInt16	INT
System.UInt32	BIGINT
System.UInt64	DECIMAL(20)
System.Decimal	DECIMAL(29,4)
System.Single	REAL
System.Double	FLOAT

Vous pouvez choisir de nombreux autres mappages numériques, mais certains 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. Pour plus d'informations, consultez Matrice de comportement au moment de l'exécution de mappages de types.

Types decimal et money

La précision par défaut du type DECIMAL SQL Server (18 chiffres décimaux à gauche et à droite du séparateur décimal) est beaucoup plus faible que la précision du type System.Decimal CLR auquel il est associé par défaut. Cela peut entraîner une perte de précision lorsque vous enregistrez des données dans la base de données. Toutefois, l'inverse peut se produire si le type DECIMAL SQL Server est configuré avec une précision supérieure à 29 chiffres. Lorsqu'un type DECIMAL SQL Server a été configuré avec une précision supérieure à celle du type System.Decimal CLR, une perte de précision peut se produire lors de la récupération de données de la base de données.

Les types MONEY et SMALLMONEY SQL Server, qui sont également associés au type System.Decimal CLR par défaut, ont une précision beaucoup plus faible, ce qui peut entraîner des exceptions de dépassement de capacité ou de perte de données lors de l'enregistrement de données dans la base de données.

Mappage de texte et mappage XML

Il existe également de nombreux types basés sur du texte et types XML que vous pouvez mapper à l'aide de LINQ to SQL. Le tableau suivant présente les types CLR que le Concepteur O/R et SQLMetal sélectionnent lors de la création d'un modèle objet ou d'un fichier de mappage externe basé sur votre base de données.

Type SQL Server	Mappage de type CLR par défaut utilisé par le Concepteur O/R et SQLMetal
CHAR	System.String
NCHAR	System.String
VARCHAR	System.String
NVARCHAR	System.String
TEXT	System.String
NTEXT	System.String
XML	System.Xml.Linq.XElement

Type CLR	Type SQL Server par défaut utilisé par DataContext.CreateDatabase
System.Char	NCHAR(1)
System.String	NVARCHAR(4000)
System.Char[]	NVARCHAR(4000)
Type personnalisé implémentant Parse() et ToString()	NVARCHAR(MAX)

Vous pouvez choisir de nombreux autres mappages basés sur du texte et mappages XML, mais certains 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. Pour plus d'informations, consultez Matrice de comportement au moment de l'exécution de mappages de types.

Types XML

Le type de données XML SQL Server est disponible à partir de Microsoft SQL Server 2005. Vous pouvez mapper le type de données XML SQL Server à XElement, XDocument ou String. Si la colonne stocke des fragments XML qui ne peuvent pas être lus dans XElement, la colonne doit être mappée à String pour éviter des erreurs d'exécution. Les fragments XML qui doivent être mappés à String incluent les éléments suivants :

Séquence d'éléments XML
Attributs
Identificateurs publics
Commentaires

Bien que vous puissiez mapper XElement et XDocument à SQL Server comme illustré dans la matrice de comportement au moment de l'exécution de mappages de types, la méthode DataContext.CreateDatabase n'a aucun mappage de type SQL Server par défaut pour ces types.

Types personnalisés

Si une classe implémente Parse() et ToString(), vous pouvez mapper l'objet à n'importe quel type texte SQL (CHAR, NCHAR, VARCHAR, NVARCHAR, TEXT, NTEXT, XML). L'objet est stocké dans la base de données en envoyant la valeur retournée par ToString() à la colonne de la base de données mappée. L'objet est reconstruit en appelant Parse() sur la chaîne retournée par la base de données.

Remarque :
LINQ to SQL ne prend pas en charge la sérialisation à l'aide de System.Xml.Serialization.IXmlSerializable.

Mappage de types de date et d'heure

LINQ to SQL vous permet de mapper de nombreux types de date et d'heure SQL Server. Le tableau suivant présente les types CLR que le Concepteur O/R et SQLMetal sélectionnent lors de la création d'un modèle objet ou d'un fichier de mappage externe basé sur votre base de données.

Type SQL Server	Mappage de type CLR par défaut utilisé par le Concepteur O/R et SQLMetal
SMALLDATETIME	System.DateTime
DATETIME	System.DateTime
DATETIME2	System.DateTime
DATETIMEOFFSET	System.DateTimeOffset
DATE	System.DateTime
TIME	System.TimeSpan

Type CLR	Type SQL Server par défaut utilisé par DataContext.CreateDatabase
System.DateTime	DATETIME
System.DateTimeOffset	DATETIMEOFFSET
System.TimeSpan	TIME

Vous pouvez choisir de nombreux autres mappages de types de date et d'heure, mais certains 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. Pour plus d'informations, consultez Matrice de comportement au moment de l'exécution de mappages de types.

Remarque :
Les types DATETIME2, DATETIMEOFFSET, DATE et TIME SQL Server sont disponibles à partir de Microsoft SQL Server 2008. LINQ to SQL prend en charge le mappage à ces nouveaux types à partir de .NET Framework version 3.5 SP1.

System.DateTime

La plage et la précision du type System.DateTime CLR sont supérieures à celles du type DATETIME SQL Server, qui est le mappage de type par défaut pour la méthode DataContext.CreateDatabase. Afin d'éviter les exceptions liées à des dates en dehors de la plage de DATETIME, utilisez DATETIME2, qui est disponible à partir de Microsoft SQL Server 2008. DATETIME2 peut correspondre à la plage et à la précision du type System.DateTime CLR.

Les dates SQL Server n'ont aucun concept de TimeZone, une fonctionnalité qui est largement prise en charge dans le CLR. Les valeurs TimeZone sont enregistrées telles quelles dans la base de données sans conversion TimeZone, indépendamment des informations DateTimeKind d'origine. Lorsque les valeurs DateTime sont récupérées de la base de données, leur valeur est chargé telle quelle dans un DateTime avec un DateTimeKind de Unspecified. Pour plus d'informations sur les méthodes System.DateTime prises en charge, consultez Méthodes System.DateTime (LINQ to SQL).

System.TimeSpan

Microsoft SQL Server 2008 et .NET Framework 3.5 SP1 vous permettent de mapper le type System.TimeSpan CLR au type TIME SQL Server. Toutefois, il y a une grande différence entre la plage prise en charge par le type System.TimeSpan CLR et celle prise en charge par le type TIME SQL Server. Les valeurs de mappage inférieures à 0 ou supérieures à 23:59:59.9999999 heures sur le type TIME SQL entraînent des exceptions de dépassement de capacité. Pour plus d'informations, consultez Méthodes System.TimeSpan (LINQ to SQL).

Dans Microsoft SQL Server 2000 et SQL Server 2005, vous ne pouvez pas mapper des champs de base de données à TimeSpan. Toutefois, les opérations sur TimeSpan sont prises en charge car des valeurs TimeSpan peuvent être retournées par la soustraction DateTime ou introduites dans une expression sous forme de variable littérale ou liée.

Mappage de types binaires

Il existe de nombreux types SQL Server que vous pouvez mapper au type System.Data.Linq.Binary CLR. Le tableau suivant présente les types SQL Server qui entraînent la définition d'un type System.Data.Linq.Binary CLR par le Concepteur O/R et SQLMetal lors de la création d'un modèle objet ou d'un fichier de mappage externe basé sur votre base de données.

Type SQL Server	Mappage de type CLR par défaut utilisé par le Concepteur O/R et SQLMetal
BINARY(50)	System.Data.Linq.Binary
VARBINARY(50)	System.Data.Linq.Binary
VARBINARY(MAX)	System.Data.Linq.Binary
VARBINARY(MAX) avec l'attribut FILESTREAM	System.Data.Linq.Binary
IMAGE	System.Data.Linq.Binary
TIMESTAMP	System.Data.Linq.Binary

Type CLR	Type SQL Server par défaut utilisé par DataContext.CreateDatabase
System.Data.Linq.Binary	VARBINARY(MAX)
System.Byte	VARBINARY(MAX)
System.Runtime.Serialization.ISerializable	VARBINARY(MAX)

Vous pouvez choisir de nombreux autres mappages de types binaires, mais certains 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. Pour plus d'informations, consultez Matrice de comportement au moment de l'exécution de mappages de types.

FILESTREAM SQL Server

L'attribut FILESTREAM des colonnes VARBINARY(MAX) est disponible à partir de Microsoft SQL Server 2008 ; vous pouvez mapper à cet attribut à l'aide de LINQ to SQL à partir de .NET Framework version 3.5 SP1.

Bien que vous puissiez mapper des colonnes VARBINARY(MAX) avec l'attribut FILESTREAM à des objets Binary, la méthode DataContext.CreateDatabase ne peut pas créer automatiquement des colonnes avec l'attribut FILESTREAM. Pour plus d'informations sur FILESTREAM, consultez Vue d'ensemble de FILESTREAM dans la documentation en ligne de Microsoft SQL Server.

Sérialisation binaire

Si une classe implémente l'interface ISerializable, vous pouvez sérialiser un objet en n'importe quel champ binaire SQL (BINARY, VARBINARY, IMAGE). L'objet est sérialisé et désérialisé en fonction de la façon dont l'interface ISerializable est implémentée. Pour plus d'informations, consultez Sérialisation binaire.

Mappages divers

Le tableau suivant présente les mappages de types par défaut pour divers types qui n'ont pas encore été mentionnés. Il présente les types CLR que le Concepteur O/R et SQLMetal sélectionnent lors de la création d'un modèle objet ou d'un fichier de mappage externe basé sur votre base de données.

Type SQL Server	Mappage de type CLR par défaut utilisé par le Concepteur O/R et SQLMetal
UNIQUEIDENTIFIER	System.Guid
SQL_VARIANT	System.Object

Type CLR	Type SQL Server par défaut utilisé par DataContext.CreateDatabase
System.Guid	UNIQUEIDENTIFIER
System.Object	SQL_VARIANT

LINQ to SQL ne prend en charge aucun autre mappage de type pour ces types divers. Pour plus d'informations, consultez Matrice de comportement au moment de l'exécution de mappages de types.

Voir aussi

Référence

Mappage basé sur les attributs (LINQ to SQL)

Référence de mappage externe (LINQ to SQL)

Incompatibilité entre types SQL-CLR (LINQ to SQL)

Autres ressources

Fonctions et types de données (LINQ to SQL)

Partager via