Partager via


Mappage basé sur les attributs (LINQ to SQL)

LINQ to SQL mappe une base de données SQL Server à un modèle objet LINQ to SQL en appliquant des attributs ou en utilisant un fichier de mappage externe. Cette rubrique présente l'approche basée sur les attributs.

Dans sa forme de base, LINQ to SQL mappe une base de données à un DataContext, une table à une classe, ainsi que des colonnes et des relations aux propriétés sur ces classes. Vous pouvez également utiliser des attributs pour mapper une hiérarchie d'héritage dans votre modèle objet. Pour plus d'informations, consultez Procédure : générer le modèle objet en Visual Basic ou C# (LINQ to SQL).

Les développeurs qui utilisent Visual Studio effectuent en général un mappage basé sur les attributs à l'aide du Concepteur Objet/Relationnel. Pour plus d'informations, consultez Concepteur Objet/Relationnel (Concepteur O/R) et Concepteur Objet/Relationnel (Concepteur O/R) et Concepteur Objet/Relationnel (Concepteur O/R). Vous pouvez également utiliser l'outil en ligne de commande SQLMetal ou coder manuellement ces attributs. Pour plus d'informations, consultez Procédure : générer le modèle objet en Visual Basic ou C# (LINQ to SQL).

RemarqueRemarque

Vous pouvez également mapper à l'aide d'un fichier XML externe.Pour plus d'informations, consultez Référence de mappage externe (LINQ to SQL).

Les sections suivantes décrivent plus en détail le mappage basé sur les attributs. Pour plus d'informations, consultez l'espace de noms System.Data.Linq.Mapping.

Attribut DatabaseAttribute

Utilisez cet attribut pour spécifier le nom par défaut de la base de données si la connexion n'a fourni aucun nom. Cet attribut est facultatif, mais si vous l'utilisez, vous devez appliquer la propriété Name, comme décrit dans le tableau suivant.

Propriété

Type

Par défaut

Description

Name

Chaîne

Consultez Name

Utilisé avec sa propriété Name, spécifie le nom de la base de données.

Pour plus d'informations, consultez DatabaseAttribute.

Attribut TableAttribute

Utilisez cet attribut pour désigner une classe comme classe d'entité associée à une table ou une vue de base de données. LINQ to SQL traite les classes qui possèdent cet attribut comme des classes persistantes. Le tableau suivant décrit la propriété Name.

Propriété

Type

Par défaut

Description

Name

Chaîne

Même chaîne que le nom de la classe

Désigne une classe comme une classe d'entité associée à une table de base de données.

Pour plus d'informations, consultez TableAttribute.

Attribut ColumnAttribute

Utilisez cet attribut pour désigner un membre d'une classe d'entité comme représentant d'une colonne d'une table de base de données. Vous pouvez appliquer cet attribut à n'importe quel champ ou propriété.

Seuls les membres que vous identifiez comme des colonnes sont récupérés et rendus persistants lorsque LINQ to SQL enregistre les modifications dans la base de données. Il est supposé que les membres sans cet attribut sont non persistants et ne sont pas soumis aux insertions ou mises à jour.

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

AutoSync

AutoSync

Never

Indique au Common Language Runtime (CLR) de récupérer la valeur après une opération d'insertion ou de mise à jour.

Options : Always, Never, OnUpdate, OnInsert.

CanBeNull

Boolean

true

Indique qu'une colonne peut contenir des valeurs Null.

DbType

Chaîne

Type déduit de colonne de base de données

Utilise des types et des modificateurs de base de données pour spécifier le type de la colonne de base de données.

Expression

Chaîne

Vide

Définit une colonne calculée dans une base de données.

IsDbGenerated

Boolean

false

Indique qu'une colonne contient des valeurs générées automatiquement par la base de données.

IsDiscriminator

Booléen

false

Indique que la colonne contient une valeur de discriminateur pour une hiérarchie d'héritage LINQ to SQL.

IsPrimaryKey

Booléen

false

Spécifie que ce membre de classe représente une colonne qui est une clé primaire ou fait partie des clés primaire de la table.

IsVersion

Booléen

false

Identifie le type de colonne du membre comme horodatage ou numéro de version de base de données.

UpdateCheck

UpdateCheck

Always, à moins que IsVersion ait la valeur true pour un membre

Spécifie l'approche de LINQ to SQL concernant la détection de conflits d'accès concurrentiel optimiste.

Pour plus d'informations, consultez ColumnAttribute.

RemarqueRemarque

Les valeurs des propriétés AssociationAttribute et ColumnAttribute Storage respectent la casse.Assurez-vous, par exemple que les valeurs utilisées dans l'attribut de la propriété AssociationAttribute.Storage correspondent à la casse des noms de propriétés correspondants utilisés ailleurs dans le code.Cela s'applique à tous les langages de programmation .NET, y compris à ceux qui ne respectent généralement pas la casse, notamment Visual Basic.Pour plus d'informations sur la propriété Storage, consultez DataAttribute.Storage.

Attribut AssociationAttribute

Utilisez cet attribut pour désigner une propriété comment représentant une association dans la base de données, telle qu'une relation entre une clé étrangère et une clé primaire. Pour plus d'informations sur les relations, consultez Procédure : mapper des relations de base de données (LINQ to SQL).

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

DeleteOnNull

Boolean

false

Placé sur une association 1:1 dont tous les membres de clé étrangère sont non Nullable, supprime l'objet lorsque l'association a la valeur Null.

DeleteRule

Chaîne

Aucune

Ajoute le comportement de suppression à une association.

IsForeignKey

Boolean

false

Si la valeur est True, désigne le membre comme clé étrangère dans une association qui représente une relation de base de données.

IsUnique

Booléen

false

Si la valeur est True, indique une contrainte d'unicité sur la clé étrangère.

OtherKey

Chaîne

ID de la classe connexe

Désigne un ou plusieurs membres de la classe d'entité cible comme valeurs de clés de l'autre côté de l'association.

ThisKey

Chaîne

ID de la classe conteneur

Désigne des membres de cette classe d'entité comme représentant les valeurs de clés sur ce côté de l'association.

Pour plus d'informations, consultez AssociationAttribute.

RemarqueRemarque

Les valeurs des propriétés AssociationAttribute et ColumnAttribute Storage respectent la casse.Assurez-vous, par exemple que les valeurs utilisées dans l'attribut de la propriété AssociationAttribute.Storage correspondent à la casse des noms de propriétés correspondants utilisés ailleurs dans le code.Cela s'applique à tous les langages de programmation .NET, y compris à ceux qui ne respectent généralement pas la casse, notamment Visual Basic.Pour plus d'informations sur la propriété Storage, consultez DataAttribute.Storage.

Attribut InheritanceMappingAttribute

Utilisez cet attribut pour mapper une hiérarchie d'héritage.

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

Code

Chaîne

Aucune. La valeur doit être fournie.

Spécifie la valeur de code du discriminateur.

IsDefault

Booléen

false

Si la valeur est True, instancie un objet de ce type lorsqu'aucune valeur de discriminateur du magasin ne correspond à l'une des valeurs spécifiées.

Type

Type

Aucune. La valeur doit être fournie.

Spécifie le type de la classe dans la hiérarchie.

Pour plus d'informations, consultez InheritanceMappingAttribute.

Attribut FunctionAttribute

Utilisez cet attribut pour désigner une méthode comme représentant une procédure stockée ou une fonction définie par l'utilisateur dans la base de données.

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

IsComposable

Boolean

false

Si la valeur est false, indique le mappage à une procédure stockée. Si la valeur est True, indique le mappage à une fonction définie par l'utilisateur.

Name

Chaîne

Même chaîne que le nom dans la base de données

Spécifie le nom de la procédure stockée ou de la fonction définie par l'utilisateur.

Pour plus d'informations, consultez FunctionAttribute.

Attribut ParameterAttribute

Utilisez cet attribut pour mapper des paramètres d'entrée sur les méthodes de procédure stockée.

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

DbType

Chaîne

Aucune

Spécifie le type de base de données.

Name

Chaîne

Même chaîne qu'un nom de paramètre dans la base de données

Spécifie un nom pour le paramètre.

Pour plus d'informations, consultez ParameterAttribute.

Attribut ResultTypeAttribute

Utilisez cet attribut pour spécifier un type de résultat.

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

Type

Type

(Aucune)

Utilisé sur les méthodes mappées aux procédures stockées qui retournent IMultipleResults. Déclare les mappages de type valide ou attendu pour la procédure stockée.

Pour plus d'informations, consultez ResultTypeAttribute.

Attribut DataAttribute

Utilisez cet attribut pour spécifier des noms et des champs de stockage privés.

Le tableau suivant décrit les propriétés de cet attribut.

Propriété

Type

Par défaut

Description

Name

Chaîne

Identique au nom dans la base de données

Spécifie le nom de la table, de la colonne, etc.

Storage

Chaîne

Accesseurs publics

Spécifie le nom du champ de stockage sous-jacent.

Pour plus d'informations, consultez DataAttribute.

Voir aussi

Autres ressources

Référence (LINQ to SQL)