DataContext.DeferredLoadingEnabled Propriété

Définition

Espace de noms:

System.Data.Linq

Assembly:

System.Data.Linq.dll

Obtient ou définit une valeur qui indique s'il faut charger en différé les relations un-à-plusieurs ou un-à-un.

public:
 property bool DeferredLoadingEnabled { bool get(); void set(bool value); };

public bool DeferredLoadingEnabled { get; set; }

member this.DeferredLoadingEnabled : bool with get, set

Public Property DeferredLoadingEnabled As Boolean

Valeur de propriété

Boolean

true si le chargement différé est activé ; sinon, false.

Remarques

Lorsque le code accède à l’une de ces relations, null est retourné si la relation est un-à-un, et une collection vide est retournée si elle est un-à-plusieurs. Les relations peuvent toujours être remplies en définissant la LoadOptions propriété .

Le scénario main de cette propriété consiste à vous permettre d’extraire une partie du modèle objet et de l’envoyer (par exemple, à un service Web).

Notes

Si cette propriété a la valeur false après l’exécution d’une requête, une exception est levée. Pour plus d’informations, consultez la section Modes valides ci-dessous.

Modes valides

Le chargement différé nécessite le suivi des objets. Seuls les trois modes suivants sont valides :

• ObjectTrackingEnabled = false. DeferredLoadingEnabled est ignoré et déduit comme étant false. Ce comportement correspond à un objet en lecture seule DataContext.

• ObjectTrackingEnabled = true. DeferredLoadingEnabled = false. Cette situation correspond à un DataContext qui permet aux utilisateurs de charger un graphique d’objet à l’aide LoadWith de directives, mais il n’active pas le chargement différé.

• Les deux sont définis sur true. Il s’agit de la valeur par défaut.

Les indicateurs ne peuvent pas être modifiés après l’exécution d’une requête. Toute modification après l’exécution de la première requête qui utilise qui DataContext lève une exception.