DbSet, classe
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Version non générique de DbSet<TEntity> qui peut être utilisée lorsque le type d'entité n'est pas connu au moment de la génération.
Hiérarchie d'héritage
System.Object
System.Data.Entity.Infrastructure.DbQuery
System.Data.Entity.DbSet
Espace de noms : System.Data.Entity
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification := "Name is intentional")> _
<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")> _
Public MustInherit Class DbSet _
Inherits DbQuery
'Utilisation
Dim instance As DbSet
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification = "Name is intentional")]
[SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
public abstract class DbSet : DbQuery
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix", Justification = L"Name is intentional")]
[SuppressMessageAttribute(L"Microsoft.Design", L"CA1010:CollectionsShouldImplementGenericInterface")]
public ref class DbSet abstract : public DbQuery
[<AbstractClassAttribute>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification = "Name is intentional")>]
[<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")>]
type DbSet =
class
inherit DbQuery
end
public abstract class DbSet extends DbQuery
Le type DbSet expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode protégée") |
DbSet | Crée une instance d'un DbSet lors d'un appel depuis le constructeur d'un type dérivé qui servira à vérifier une deuxième fois DbSets.Les méthodes et les propriétés qui serviront au double test doivent être implémentées par le double test, à l'exception d'AsNoTracking, d'AsStreaming et d'Include pour lesquels l'implémentation par défaut correspond à une absence d'opération. |
Top
Propriétés
| Nom | Description | |
|---|---|---|
.gif "Propriété publique") |
ElementType | Type de l'élément IQueryable. (Hérité de DbQuery.) |
|
Local | Obtient un ObservableCollection<T> qui représente une vue locale de toutes les entités ajoutées, inchangées et modifiées dans ce jeu.Cette vue locale reste synchronisée lorsque les entités sont ajoutées ou supprimées du contexte.De même, les entités ajoutées à ou supprimées de la vue locale seront ajoutées ou supprimées automatiquement du contexte. |
Top
Méthodes
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
Add | Ajoute l'entité donnée au contexte sous-jacent au jeu avec l'état « Added », de sorte qu'elle sera insérée dans la base de données lorsque SaveChanges est appelé. |
|
AddRange | Ajoute la collection d'entités spécifiée au contexte sous-jacent au jeu. Chaque entité passe alors à l'état « Added » afin d'être insérée dans la base de données lorsque SaveChanges sera appelé. |
|
AsNoTracking | Retourne une nouvelle requête où les entités retournées ne seront pas mises en cache dans le DbContext. (Hérité de DbQuery.) |
|
AsStreaming | Obsolète. Retourne une nouvelle requête qui transmettra en continu les résultats au lieu de les mettre en mémoire tampon. (Hérité de DbQuery.) |
|
Attach | Joint l'entité donnée au contexte sous-jacent au jeu.Autrement dit, l'entité est placée dans le contexte dans un état Unchanged, tout comme si elle avait été lue à partir de la base de données. |
|
Cast<TEntity> | Retourne l'objet DbSet<TEntity> générique équivalent. |
|
Create() | Crée une nouvelle instance d'une entité pour le type de ce jeu.Notez que cette instance n'est pas ajoutée ou jointe au jeu.L'instance retournée sera un proxy si le contexte sous-jacent est configuré pour créer des proxys et si le type d'entité satisfait les spécifications pour la création d'un proxy. |
|
Create(Type) | Crée une nouvelle instance d'une entité pour le type de ce jeu ou pour un type dérivé du type de ce jeu.Notez que cette instance n'est pas ajoutée ou jointe au jeu.L'instance retournée sera un proxy si le contexte sous-jacent est configuré pour créer des proxys et si le type d'entité satisfait les spécifications pour la création d'un proxy. |
|
Equals | Détermine si le jeu spécifié est égal au jeu actuel. (Substitue DbQuery.Equals(Object).) |
|
Finalize | (Hérité de Object.) |
|
Find | Recherche une entité avec les valeurs de clé primaire données.Si une entité avec les valeurs de clé primaire données existe dans le contexte, elle est retournée immédiatement sans demande au magasin.Sinon, une demande d'entité avec les valeurs de clé primaire données est faite au magasin et cette entité, si trouvée, est jointe au contexte et retournée.Si aucune entité n'est trouvée dans le contexte ou le magasin, null est retourné. |
|
FindAsync(Object[]) | Recherche de façon asynchrone une entité avec les valeurs de clé primaire données.Si une entité avec les valeurs de clé primaire données existe dans le contexte, elle est retournée immédiatement sans demande au magasin.Sinon, une demande d'entité avec les valeurs de clé primaire données est faite au magasin et cette entité, si trouvée, est jointe au contexte et retournée.Si aucune entité n'est trouvée dans le contexte ou le magasin, null est retourné. |
|
FindAsync(CancellationToken, Object[]) | Recherche de façon asynchrone une entité avec les valeurs de clé primaire données.Si une entité avec les valeurs de clé primaire données existe dans le contexte, elle est retournée immédiatement sans demande au magasin.Sinon, une demande d'entité avec les valeurs de clé primaire données est faite au magasin et cette entité, si trouvée, est jointe au contexte et retournée.Si aucune entité n'est trouvée dans le contexte ou le magasin, null est retourné. |
|
GetHashCode | Retourne la fonction de hachage pour le jeu spécifié. (Substitue DbQuery.GetHashCode().) |
|
GetType | Obtient le type de jeu actuel. |
|
Include | Spécifie les objets connexes à inclure dans les résultats de la requête. (Hérité de DbQuery.) |
|
MemberwiseClone | (Hérité de Object.) |
|
Remove | Marque l'entité donnée comme Deleted, de sorte qu'elle sera supprimée de la base de données lorsque SaveChanges est appelé.Notez que l'entité doit exister dans le contexte dans un autre état avant que cette méthode soit appelée. |
|
RemoveRange | Supprime la collection d'entités spécifiée du contexte sous-jacent au jeu. Chaque entité passe alors à l'état « Deleted » afin d'être supprimée dans la base de données lorsque SaveChanges sera appelé. |
|
SqlQuery | Crée une requête SQL brute qui retournera des entités dans ce jeu.Par défaut, les entités retournées sont suivies par le contexte ; cela peut être modifié en appelant AsNoTracking sur le DbRawSqlQuery retourné.Notez que les entités retournées sont toujours du type de ce jeu et jamais d'un type dérivé.Si la table ou les tables interrogées peuvent contenir des données pour d'autres types d'entités, la requête SQL doit être écrite convenablement pour garantir que seules les entités du type correct sont retournées.Comme pour tout API qui accepte SQL, il est important de paramétrer toutes les entrées utilisateur afin de se prémunir contre une attaque d'injection SQL.Vous pouvez inclure des espaces de paramètre réservés dans la chaîne de requête SQL, puis fournir des valeurs de paramètre comme arguments supplémentaires.Toute valeur de paramètre fournie sera automatiquement convertie en un DbParameter.context.Set(typeof(Blog)).SqlQuery("SELECT * FROM dbo.Posts WHERE Author = @p0", userSuppliedAuthor); Sinon, construisez un DbParameter et fournissez-le à SqlQuery.Cela vous permet d'utiliser des paramètres nommés dans la chaîne de requête SQL.context.Set(typeof(Blog)).SqlQuery("SELECT * FROM dbo.Posts WHERE Author = @author", new SqlParameter("@author", userSuppliedAuthor)); |
|
ToString | Retourne une représentation String de la requête sous-jacente. (Hérité de DbQuery.) |
Top
Implémentations d'interface explicite
| Nom | Description | |
|---|---|---|
.gif "Implémentation d'interface explicite") .gif "Propriété privée") |
IListSource.ContainsListCollection | Retourne false. (Hérité de DbQuery.) |
|
IQueryable.Expression | Expression LINQ IQueryable. (Hérité de DbQuery.) |
.gif "Méthode privée") |
IEnumerable.GetEnumerator | Retourne un IEnumerator qui lorsqu'il est énuméré exécute la requête sur la base de données. (Hérité de DbQuery.) |
|
IListSource.GetList | Lève une exception qui indique que la liaison directe à une requête de magasin n'est pas prise en charge.À la place, renseignez un DbSet avec les données, par exemple en utilisant la méthode d'extension Load, puis créez une liaison avec les données locales.Pour la liaison de WPF à DbSet.Local.Pour Windows Forms, créez une liaison avec DbSet.Local.ToBindingList(). (Hérité de DbQuery.) |
|
IQueryable.Provider | Fournisseur IQueryable. (Hérité de DbQuery.) |
|
IDbAsyncEnumerable.GetAsyncEnumerator | Retourne un IDbAsyncEnumerator qui lorsqu'il est énuméré exécute la requête sur la base de données. (Hérité de DbQuery.) |
Top
Sécurité des threads
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.