TableAttribute Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Désigne une classe en tant que classe d’entité associée à une table de base de données.
public ref class TableAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)]
public sealed class TableAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=false, Inherited=false)>]
type TableAttribute = class
inherit Attribute
Public NotInheritable Class TableAttribute
Inherits Attribute
- Héritage
- Attributs
Exemples
[Table(Name = "Customers")]
public class Customer
{
// ...
}
<Table(Name:="Customers")> _
Public Class Customer
' ...
End Class
Remarques
Utilisez l’attribut TableAttribute pour désigner une classe en tant que classe d’entité associée à une table ou vue de base de données. LINQ to SQL traite les classes qui ont l’attribut TableAttribute comme des classes persistantes.
LINQ to SQL prend uniquement en charge le mappage à table unique. Autrement dit, une classe d’entité doit être mappée à une seule table de base de données et vous ne pouvez pas mapper une table de base de données à plusieurs classes en même temps.
Vous pouvez utiliser la Name propriété de l’attribut TableAttribute pour spécifier un nom pour la table, et vous pouvez éventuellement utiliser le nom du schéma pour qualifier un nom de table. Si vous ne spécifiez pas de nom à l’aide de la Name propriété, le nom de la table est supposé être identique au nom de la classe.
Noms qualifiés de schéma
Vous pouvez éventuellement utiliser le nom du schéma pour qualifier un nom de table. Par défaut, le jeton à gauche de la première période de la Name chaîne est considéré comme le nom du schéma. Le reste du nom est considéré comme le nom de la table. Le fournisseur cite le nom de la table selon les besoins. Par exemple, le fournisseur LINQ to SQL pour SQL Server s’assure que les crochets sont utilisés au moins là où ils sont nécessaires.
Note
Dans certains cas, vous devez citer explicitement des attributs, car le fournisseur de SQL Server ne peut pas citer automatiquement. Le tableau suivant montre quelques exemples.
| Cas | Exemple : Nom de l’identificateur | Exemple : Chaîne attendue dans les attributs | Sinon... |
|---|---|---|---|
| Le nom du schéma contient un point | Schéma : « A.B » Tableau : « C » |
"[A.B]. C" | La première période est supposée séparer le nom du schéma du nom de la table. |
Le nom du schéma/de la table commence par @ |
« @SomeName » | « [@SomeName] » | Supposé être un nom de paramètre. |
Le schéma commence par [ et se termine par ] |
« [Schema.Table] » | "[[Schéma]. [Table]]] » | L’identificateur non cité ressemble à un identificateur entre guillemets. |
La table commence par [ et se termine par ] |
« [Table] » | « [[Table]]] » | L’identificateur non cité ressemble à un identificateur entre guillemets. |
Constructeurs
| Nom | Description |
|---|---|
| TableAttribute() |
Initialise une nouvelle instance de la classe TableAttribute. |
Propriétés
| Nom | Description |
|---|---|
| Name |
Obtient ou définit le nom de la table ou de la vue. |
| TypeId |
En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute) |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| GetHashCode() |
Retourne le code de hachage pour cette instance. (Hérité de Attribute) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| IsDefaultAttribute() |
En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut de la classe dérivée. (Hérité de Attribute) |
| Match(Object) |
En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute) |