DbSet 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.
Version non générique de qui peut être utilisée lorsque le type d’entité n’est pas connu au moment de DbSet<TEntity> la génération.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification="Name is intentional")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", Justification="Casing is intentional")]
public abstract class DbSet : System.Data.Entity.Infrastructure.DbQuery
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification="Name is intentional")]
public abstract class DbSet : System.Data.Entity.Infrastructure.DbQuery
type DbSet = class
inherit DbQuery
Public MustInherit Class DbSet
Inherits DbQuery
- Héritage
- Attributs
Constructeurs
DbSet() |
Crée un instance d’un lorsqu’il DbSet est appelé à partir du constructeur d’un type dérivé qui sera utilisé comme double de test pour dbSets. Les méthodes et propriétés qui seront utilisées par le double de test doivent être implémentées par le double de test, à l’exception de AsNoTracking, AsStreaming, un Include où l’implémentation par défaut est une opération sans opération. |
Propriétés
ElementType |
Type d'é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 cet ensemble. 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. |
Sql |
Obtient une String représentation de la requête sous-jacente. (Hérité de DbQuery) |
Méthodes
Add(Object) |
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(IEnumerable) |
Ajoute la collection d’entités donnée dans le contexte sous-jacent à l’ensemble, chaque entité étant placée à l’état Ajouté de sorte qu’elle soit insérée dans la base de données lorsque SaveChanges est appelé. |
AsNoTracking() |
Retourne une nouvelle requête dans laquelle les entités retournées ne seront pas mises en cache dans .DbContext (Hérité de DbQuery) |
AsStreaming() |
Obsolète.
Retourne une nouvelle requête qui diffusera en continu les résultats au lieu de la mise en mémoire tampon. (Hérité de DbQuery) |
Attach(Object) |
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 générique DbSet<TEntity> é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 attachée à l’ensemble. 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 attachée à l’ensemble. 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(Object) |
Version non générique de qui peut être utilisée lorsque le type d’entité n’est pas connu au moment de DbSet<TEntity> la génération. |
Find(Object[]) |
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(CancellationToken, Object[]) |
Recherche de manière 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(Object[]) |
Recherche de manière 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() |
Version non générique de qui peut être utilisée lorsque le type d’entité n’est pas connu au moment de DbSet<TEntity> la génération. |
GetType() |
Version non générique de qui peut être utilisée lorsque le type d’entité n’est pas connu au moment de DbSet<TEntity> la génération. |
Include(String) |
Spécifie les objets connexes à inclure dans les résultats de la requête. (Hérité de DbQuery) |
Remove(Object) |
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(IEnumerable) |
Supprime la collection d’entités donnée du contexte sous-jacent à l’ensemble, chaque entité étant placée à l’état Supprimé de sorte qu’elle soit supprimée de la base de données lorsque SaveChanges est appelé. |
SqlQuery(String, Object[]) |
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 pour cet ensemble 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 toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter. Contexte. Set(typeof(Blog)). SqlQuery(« SELECT * FROM dbo. Publie WHERE Author = @p0« , userSuppliedAuthor); Vous pouvez également construire un DbParameter et le fournir à SqlQuery. Cela vous permet d’utiliser des paramètres nommés dans la chaîne de requête SQL. Contexte. Set(typeof(Blog)). SqlQuery(« SELECT * FROM dbo. Publie WHERE Author = @author« , new SqlParameter(« @author », userSuppliedAuthor)); |
ToString() |
Retourne une String représentation de la requête sous-jacente. (Hérité de DbQuery) |
Implémentations d’interfaces explicites
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) |
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.ContainsListCollection |
Retourne |
IListSource.GetList() |
Lève une exception qui indique que la liaison directe à une requête de magasin n'est pas prise en charge. Au lieu de cela, renseignez un DbSet avec des données, par exemple à l’aide de la méthode d’extension Load, puis liez aux données locales. Pour WPF, lier à DbSet.Local. Pour Windows Forms, créez une liaison avec DbSet.Local.ToBindingList (). (Hérité de DbQuery) |
IQueryable.Expression |
Expression LINQ IQueryable. (Hérité de DbQuery) |
IQueryable.Provider |
Fournisseur IQueryable. (Hérité de DbQuery) |