DataContext.DeferredLoadingEnabled Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se deve atrasar o carregamento de relações um-para-muitos ou um-para-um.
public:
property bool DeferredLoadingEnabled { bool get(); void set(bool value); };public bool DeferredLoadingEnabled { get; set; }member this.DeferredLoadingEnabled : bool with get, setPublic Property DeferredLoadingEnabled As BooleanValor de Propriedade
true se o carregamento diferido estiver ativado; caso contrário, false.
Observações
Quando o código acede a uma destas relações, o null é devolvido se a relação for um-para-um, e uma coleção vazia é devolvida se for um-para-muitos. As relações ainda podem ser preenchidas ao definir a LoadOptions propriedade.
O principal cenário para esta propriedade é permitir extrair uma parte do modelo de objetos e enviá-la (por exemplo, para um serviço Web).
Note
Se esta propriedade for definida para false depois de uma consulta ter sido executada, é lançada uma exceção. Consulte a secção de Modos Válidos abaixo para mais informações.
Modos válidos
O carregamento diferido requer rastreio de objetos. Apenas os seguintes três modos são válidos:
ObjectTrackingEnabled =
false. DeferredLoadingEnabled é ignorado e inferido-se que éfalse. Este comportamento corresponde a um modo de apenas DataContextleitura .ObjectTrackingEnabled =
true. DeferredLoadingEnabled =false. Esta situação corresponde a um DataContext que permite aos utilizadores carregar um grafo de objetos usando LoadWith diretivas, mas não permite o carregamento diferido.Ambos estão definidos para
true. Este é o padrão.
As bandeiras não podem ser alteradas após a execução de uma consulta. Qualquer alteração após a execução da primeira consulta que a DataContext use lança uma exceção.