Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Utilisation d'objets liés aux données dans le code

LightSwitch génère les objets et membres qui décrivent vos données. Les noms de ces objets et membres correspondent aux noms d'éléments dans votre solution. Par exemple, si vous ajoutez une table nommée Customer, LightSwitch génère un objet nommé Customer. Cette rubrique décrit chaque type d'objet qui est généré par LightSwitch . Pour consulter des exemples de code qui utilisent ces objets et membres pour effectuer des tâches liées aux données communes, consultez Réalisation de tâches liées aux données à l'aide du code.

L'illustration suivante résume les objets et membres générés de votre modèle de données.

Hiérarchie des objets générés

L'objet Application fournit l'accès de niveau supérieur aux objets de votre application. Pour accéder à l'objet Application, ouvrez un fichier de code utilisateur dans l'éditeur de code, puis tapez Application. Les types de méthodes et propriétés qui s'affichent dans IntelliSense après avoir tapé Application et « . » changeront selon le fichier de code dans lequel vous écrivez le code. Dans la plupart des cas, vous pouvez utiliser une propriété de l'objet Application pour obtenir un objet qui représente l'utilisateur actuel.

L'objet DataWorkspace est l'objet de niveau supérieur pour l'accès à toutes les données. L'objet DataWorkspace contient une propriété pour chaque source de données de votre projet. Par exemple, si vous avez une source de données nommée NorthwindData, LightSwitch génère une propriété nommée NorthwinddData. Lorsque vous tapez DataWorkspace dans l'Éditeur de code, la propriété NorthwindData devient disponible dans une liste déroulante.

L'illustration suivante montre certains membres générés qui peuvent s'afficher dans une liste déroulante.

Propriétés de source de données de l'objet DataWorkspace

LightSwitch génère un objet pour chaque source de données dans votre projet. Cet objet contient des membres que vous pouvez utiliser pour accéder aux données. Les membres d'un objet source de données incluent des propriétés de jeu d'entités et des méthodes de requête.

L'illustration suivante montre certains membres générés qui peuvent s'afficher dans une liste déroulante.

Membres de l'objet source de données

Gg445195.collapse_all(fr-fr,VS.120).gifPropriétés de jeu d'entités

Une propriété de jeu d'entités retourne une collection d'entités. LightSwitch génère une propriété de jeu d'entités pour chaque entité dans la source de données. Par exemple, si votre source de données contient une entité nommée Customer, LightSwitch génère une propriété nommée Customers. Vous pouvez utiliser la propriété Customers pour obtenir un objet EntitySet qui représente une collection d'entités Customer.

L'objet EntitySet contient également des membres qui vous permettent de vérifier si l'utilisateur actuel a l'autorisation de lire, mettre à jour ou supprimer des entités dans la collection. Pour plus d'informations, consultez Réalisation de tâches liées aux données à l'aide du code.

Remarque Remarque

EntitySet est l'un des types d'objets collection d'entité. Pour optimiser les performances de votre code, assurez-vous que vous utilisez le type approprié d'objet collection d'entités pour le type de logique métier que vous écrivez. Pour plus d'informations, consultez Objets collection d'entités et performance.

Gg445195.collapse_all(fr-fr,VS.120).gifMéthode de requête

Une méthode de requête obtient le résultat d'une requête. LightSwitch génère une méthode pour chaque requête définie dans votre source de données. Le nom de la méthode correspond au nom de la requête. Une requête peut retourner une seule entité ou une collection d'entités de type IDataServiceQueryable.

Remarque Remarque

IDataServiceQueryable<T> est l'un des types d'objets collection d'entité. Pour optimiser les performances de votre code, assurez-vous que vous utilisez le type approprié d'objet collection d'entités pour le type de logique métier que vous écrivez. Pour plus d'informations, consultez Objets collection d'entités et performance.

Par défaut, LightSwitch génère les méthodes de requête suivantes pour chaque entité de la source de données.

  1. <Entity Name>_Single.

  2. <Entity Name>_SingleOrDefault.

Ces deux méthodes acceptent un segment de clé primaire et retournent un seul objet d'entité. Si aucune entité n'est retournée, la méthode <Entity Name>_Single renvoie une exception tandis que la méthode <Entity Name>_SingleOrDefault retourne une valeur Null (Nothing en Visual Basic).

LightSwitch génère une EntityObject pour chaque entité dans une collection d'entités. Par exemple, si votre code a extrait une collection de commandes, la collection contient un EntityObject qui représente chaque commande. Un EntityObject contient des membres que vous pouvez utiliser pour supprimer une entité, lire ou mettre à jour la valeur des propriétés d'entité ou obtenir des entités associées. Vous pouvez obtenir un EntityObject d'un objet collection d'entités tel qu'un EntitySet ou en appelant une méthode de requête qui retourne une entité. Pour plus d'informations, consultez Réalisation de tâches liées aux données à l'aide du code.

L'illustration suivante affiche les membres d'une entité Order nommée myOrder. L'entité Order contient des propriétés d'entité telles que OrderDate, OrderID et Freight. L'entité Order contient également des membres que vous pouvez utiliser pour obtenir la collection Order_Details connexe et le Customer qui a passé la commande.

Propriétés d'un objet entité

Dans cet exemple, la propriété Customer retourne une entité Customer. Une entité Customer représente le côté « un » de la relation Customer-Order.

La propriété Order_Details retourne une collection d'entités Order_Details. L'entité Order_Details représente le côté « plusieurs » de la relation Order-Order_Details. L'objet d'une collection Order_Details est de type EntityCollection.

Cette illustration montre également une propriété nommée Order_DetailsQuery. Les propriétés qui se terminent par le mot Query retournent un objet IDataServiceQueryable.

Remarque Remarque

EntityCollection et IDataServiceQueryable sont les deux types d'objets collection d'entité. Pour optimiser les performances de votre code, assurez-vous que vous utilisez le type approprié d'objet collection d'entités pour le type de logique métier que vous écrivez. Pour plus d'informations, consultez Objets collection d'entités et performance.

Lorsque vous utilisez un objet collection d'entités dans une expression LINQ, LightSwitch exécute une opération qui extrait des entités de la couche serveur. Type d'objet que vous utilisez pour déterminer si LightSwitch extrait toutes les entités dans une collection ou uniquement un sous-ensemble d'entités. Pour vérifier que votre code s'exécute comme prévu, choisissez le type le plus approprié d'objet de collection pour la logique devmétier que vous écrivez. Il existe deux types d'objets de collection d'entités : les objets qui entrainent l'évaluation par LightSwitch d'une expression LINQ à distance par , et les objets qui entraînent l'évaluation locale par LightSwitch d'une expression LINQ.

Gg445195.collapse_all(fr-fr,VS.120).gifOpérations LINQ : Exécution distante contre Exécution locale

Si vous utilisez un objet EntitySet ou IDataServiceQueryable dans une expression LINQ, LightSwitch passe l'expression LINQ entière au service de données de la couche serveur. Les résultats de l'expression sont ensuite passés en retour au code appelant. Ce type d'exécution de requête est efficace, car seules les entités qui satisfont la requête sont retournées au code appelant. Toutefois, seul un sous-ensemble d'opérateurs de requête est pris en charge par le service de données. Si votre expression requiert d'autres opérateurs LINQ, envisagez d'utiliser d'autres types d'objets collection.

L'illustration suivante affiche une expression LINQ qui utilise un objet IDataServiceQueryable. Cet exemple montre l'opération LINQ passant l'expression entière au service de données et retournant uniquement des entités Order qui satisfont les conditions de la requête.

Exécution distante d'une expression de requête

Si vous utilisez un objet EntityCollection ou un objet IEnumerable dans une expression LINQ, LightSwitch ne passes pas l'expression LINQ au service de données. À la place, LightSwitch récupère toutes les entités du type donné. L'expression est ensuite appliquée localement à la collection entière. Si une collection d'entités est volumineuse, ce type d'exécution de requête peut avoir un impact sur les performances. Toutefois, votre code peut utiliser l'ensemble complet d'opérateurs LINQ. De plus, cette approche peut avoir un sens lorsque vous voulez passer les entités de collection complète à d'autres méthodes dans votre code.

L'illustration suivante affiche une expression LINQ qui utilise un objet EntityCollection. Cet exemple montre l'opération LINQ qui extrait toutes les entités Order pour un client particulier. Les conditions de la requête sont ensuite appliquées localement à la collection entière.

Exécution locale d'une expression de requête

Gg445195.collapse_all(fr-fr,VS.120).gifExemples : obtention d'objets collection d'entités dans le code

L'exemple suivant montre comment obtenir des collections d'entités Order dans l'exemple de base de données Northwind.

Pour obtenir cet objet collection d'entités

Utiliser ce code

Exécution distante ou locale

EntitySet

DataWorkspace.Northwind.Orders

Or

myOrder.Details.EntitySet()

Remote

IDataServiceQueryable

myCustomer.OrdersQuery

Or

DataWorkspace.Northwind.Orders.GetQuery()

Remote

EntityCollection

myCustomer.Orders

Local

IEnumerable

myCustomer.OrdersQuery.Execute()

Or

DataWorkspace.Northwind.Orders.GetQuery().Execute()

Remote

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft