DataContext.DeferredLoadingEnabled Propriedade

Definição

Namespace:

System.Data.Linq

Assembly:

System.Data.Linq.dll

Obtém ou define um valor que indica se relações de um-para-muitos ou de um-para-um devem ter o carregamento adiado.

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 adiamento de carregamento for 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 main cenário dessa propriedade é permitir que você extraia uma parte do modelo de objeto e a envie (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 como 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 são definidos como true. Esse é 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.