DataContext.DeferredLoadingEnabled Propriedade

Definição

Namespace:

System.Data.Linq

Assembly:

System.Data.Linq.dll

Obtém ou define um valor que indica se as relações um para muitos ou um para um devem ser carregadas com atraso.

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

Valor da propriedade

Boolean

true se o carregamento adiado estiver habilitado; caso contrário, false.

Comentários

Quando o código acessa uma dessas relações, nulo é retornado se a relação é um-para-um e uma coleção vazia é retornada se for um-para-muitos. As relações ainda podem ser preenchidas definindo a LoadOptions propriedade.

O cenário principal dessa propriedade é permitir que você extraia uma parte do modelo de objeto e o envie para fora (por exemplo, para um serviço Web).

Observação

Se essa propriedade for definida false como após a execução de uma consulta, uma exceção será gerada. Consulte a seção Modos Válidos abaixo para obter mais informações.

Modos válidos

O carregamento adiado requer o acompanhamento de objetos. Somente os três modos a seguir são válidos:

• ObjectTrackingEnabled = false. DeferredLoadingEnabled é ignorado e inferido para ser false. Esse comportamento corresponde a um somente leitura DataContext.

• ObjectTrackingEnabled = true. DeferredLoadingEnabled = false. Essa situação corresponde a um DataContext que permite que os usuários carreguem um grafo de objeto usando LoadWith diretivas, mas não permite o carregamento adiado.

• Ambos estão definidos como true. Este é o padrão.

Os sinalizadores podem não ser alterados após a execução de uma consulta. Qualquer alteração após a execução da primeira consulta que usa que DataContext gera uma exceção.