BindingOperations.EnableCollectionSynchronization Metoda

public:
 static void EnableCollectionSynchronization(System::Collections::IEnumerable ^ collection, System::Object ^ lockObject);

public static void EnableCollectionSynchronization (System.Collections.IEnumerable collection, object lockObject);

static member EnableCollectionSynchronization : System.Collections.IEnumerable * obj -> unit

Public Shared Sub EnableCollectionSynchronization (collection As IEnumerable, lockObject As Object)

Parametry

Poznámky

Aplikace WPF může zobrazit kolekci dat pomocí ItemsControl některé nebo jedné z jejích podtříd (ListBox, DataGrid, TreeView, ListViewatd.). WPF kanáluje veškerý přístup ke kolekci prostřednictvím podtřídy CollectionView.  ItemsControl Obě a CollectionView mají spřažení s vláknem, na kterém ItemsControl byl vytvořen, což znamená, že jejich použití v jiném vlákně je zakázáno a vyvolá výjimku. Toto omezení se v podstatě vztahuje i na kolekci.

Kolekci můžete chtít použít na více vláknech.   Například chcete aktualizovat kolekci (přidat nebo odebrat položky) ve vlákně "shromažďování dat" a současně zobrazit výsledky ve vlákně "uživatelského rozhraní", aby uživatelské rozhraní zůstalo responzivní, zatímco probíhá shromažďování dat. V takové situaci zodpovídáte za zajištění synchronizovaného přístupu ke kolekci ("bezpečný pro přístup z více vláken") a za zaručení, že přístup z WPF (konkrétně z CollectionView) bude součástí stejného synchronizačního mechanismu. Voláním EnableCollectionSynchronization(IEnumerable, Object) metody to můžete provést pomocí jednoduchého mechanismu zámku.

Chcete-li použít kolekci ve více vláknech, z nichž jedno je vlákno uživatelského rozhraní, které vlastní ItemsControl, musíte provést následující kroky:

1. Vytvořte instanci objektu, který se má uzamknout při přístupu ke kolekci.

2. Synchronizujte veškerý přístup z aplikace do kolekce uzamčením daného objektu.

3. Zavolejte EnableCollectionSynchronization(IEnumerable, Object) a informujte WPF, že používáte jednoduchý zamykací mechanismus.

   • Volání musí proběhnout ve vlákně uživatelského rozhraní.

   • Volání musí proběhnout před použitím kolekce v jiném vlákně nebo před připojením kolekce k ItemsControl, podle toho, co nastane později.

4. Ujistěte se, že změna kolekce a oznámení o této změně (prostřednictvím INotifyCollectionChanged) jsou atomické. Žádný přístup z jiných vláken nemůže zasahovat.  (Obvykle je zdarma. Například to zaručuje za předpokladu ObservableCollection<T> , že všechny změny jsou chráněny synchronizací.)

5. Pokud zavoláte DisableCollectionSynchronization, musí toto volání proběhnout také ve vlákně uživatelského rozhraní.

6. Pokud chcete použít stejnou kolekci na více vláknech uživatelského rozhraní, musíte volat EnableCollectionSynchronization (a DisableCollectionSynchronizationv případě potřeby) samostatně v každém vlákně uživatelského rozhraní.

7. Vyhněte se vzájemnému zablokování.  To už je zodpovědností aplikace, jakmile se rozhodne použít synchronizaci, ale musí také vzít v úvahu účast WPF na synchronizaci. (Další informace najdete níže.)

Na oplátku WPF poskytuje následující chování:

• Objekt CollectionView přistupuje ke kolekci pomocí zamykacího mechanismu.

• Objekt CollectionView udržuje "stínovou kopii" kolekce pro použití ve vlákně uživatelského rozhraní.

• CollectionChanged události se zadají do fronty při přijetí (v libovolném vlákně).

• Čekající události se použijí na stínové kopii asynchronně ve vlákně uživatelského rozhraní, pokud k tomu má možnost.

• Nebude CollectionView přímo používat žádný jiný synchronizační mechanismus viditelný pro aplikaci. Toto je způsob, jak WPF pomoct vyhnout se vzájemnému zablokování (viz předchozí položka 7).  

Čistý efekt spočívá v tom, že můžete změnit kolekci na libovolném vlákně a tyto změny se nakonec zobrazí v, ItemsControl když má vlákno uživatelského rozhraní čas "dohnat".  Implementace byla vyladěna tak, aby omezila rychlost, která se mění do vlákna uživatelského rozhraní, aby vlákna na pozadí zabránila nasycení vlákna uživatelského rozhraní a vyhladovění odpovědi na normální uživatelský vstup.

public:
 static void EnableCollectionSynchronization(System::Collections::IEnumerable ^ collection, System::Object ^ context, System::Windows::Data::CollectionSynchronizationCallback ^ synchronizationCallback);

public static void EnableCollectionSynchronization (System.Collections.IEnumerable collection, object context, System.Windows.Data.CollectionSynchronizationCallback synchronizationCallback);

static member EnableCollectionSynchronization : System.Collections.IEnumerable * obj * System.Windows.Data.CollectionSynchronizationCallback -> unit

Public Shared Sub EnableCollectionSynchronization (collection As IEnumerable, context As Object, synchronizationCallback As CollectionSynchronizationCallback)

Parametry

Poznámky

Aplikace WPF může zobrazit kolekci dat pomocí ItemsControl některé nebo jedné z jejích podtříd (ListBox, DataGrid, TreeView, ListViewatd.). WPF kanáluje veškerý přístup ke kolekci prostřednictvím podtřídy CollectionView.  ItemsControl Obě a CollectionView mají spřažení s vláknem, na kterém ItemsControl byl vytvořen, což znamená, že jejich použití v jiném vlákně je zakázáno a vyvolá výjimku. Toto omezení se v podstatě vztahuje i na kolekci.

Kolekci můžete chtít použít na více vláknech.   Například chcete aktualizovat kolekci (přidat nebo odebrat položky) ve vlákně "shromažďování dat" a současně zobrazit výsledky ve vlákně "uživatelského rozhraní", aby uživatelské rozhraní zůstalo responzivní, zatímco probíhá shromažďování dat. V takové situaci zodpovídáte za zajištění synchronizovaného přístupu ke kolekci ("bezpečný pro přístup z více vláken") a za zaručení, že přístup z WPF (konkrétně z CollectionView) bude součástí stejného synchronizačního mechanismu. EnableCollectionSynchronization(IEnumerable, Object, CollectionSynchronizationCallback) Voláním metody to můžete provést pomocí synchronizačního mechanismu, jako jsou semafory, událost resetování atd.

Chcete-li použít kolekci ve více vláknech, z nichž jedno je vlákno uživatelského rozhraní, které vlastní ItemsControl, musíte provést následující kroky:

1. Zvolte mechanismus synchronizace.

2. Synchronizujte veškerý přístup z aplikace do kolekce pomocí daného mechanismu.

3. EnableCollectionSynchronization(IEnumerable, Object, CollectionSynchronizationCallback) Volání přetížení informovat WPF, že používáte jiný mechanismus než jednoduché uzamčení.

   • Volání musí proběhnout ve vlákně uživatelského rozhraní.

   • Volání musí proběhnout před použitím kolekce v jiném vlákně nebo před připojením kolekce k ItemsControl, podle toho, co nastane později.

4. Ujistěte se, že změna kolekce a oznámení o této změně (prostřednictvím INotifyCollectionChanged) jsou atomické. Žádný přístup z jiných vláken nemůže zasahovat.  (Obvykle je zdarma. Například to zaručuje za předpokladu ObservableCollection<T> , že všechny změny jsou chráněny synchronizací.)

5. Pokud zavoláte DisableCollectionSynchronization, musí toto volání proběhnout také ve vlákně uživatelského rozhraní.

6. Pokud chcete použít stejnou kolekci na více vláknech uživatelského rozhraní, musíte volat EnableCollectionSynchronization (a DisableCollectionSynchronizationv případě potřeby) samostatně v každém vlákně uživatelského rozhraní.

7. Vyhněte se vzájemnému zablokování.  To už je zodpovědností aplikace, jakmile se rozhodne použít synchronizaci, ale musí také vzít v úvahu účast WPF na synchronizaci. (Další informace najdete níže.)

Na oplátku WPF poskytuje následující chování:

• Objekt CollectionView přistupuje ke kolekci voláním registrovaného CollectionSynchronizationCallback s následujícími argumenty:

  • collection: kolekce zájmu.
  • context: zaregistrovaný objekt kontextu.
  • accessMethod: delegát, který provádí skutečný přístup.
  • writeAccess: true pokud delegát změní kolekci, false jinak.

  Měli byste CollectionSynchronizationCallback navázat synchronizaci kolekce (pomocí objektu context a writeAccess hodnoty podle potřeby), volat accessMethoda pak uvolnit synchronizaci.

• Objekt CollectionView udržuje "stínovou kopii" kolekce pro použití ve vlákně uživatelského rozhraní.

• CollectionChanged události se zadají do fronty při přijetí (v libovolném vlákně).

• Čekající události se použijí na stínové kopii asynchronně ve vlákně uživatelského rozhraní, pokud k tomu má možnost.

• Nebude CollectionView přímo používat žádný jiný synchronizační mechanismus viditelný pro aplikaci. Toto je způsob, jak WPF pomoct vyhnout se vzájemnému zablokování (viz předchozí položka 7).  

Čistý efekt spočívá v tom, že můžete změnit kolekci na libovolném vlákně a tyto změny se nakonec zobrazí v, ItemsControl když má vlákno uživatelského rozhraní čas "dohnat".  Implementace byla vyladěna tak, aby omezila rychlost, která se mění do vlákna uživatelského rozhraní, aby vlákna na pozadí zabránila nasycení vlákna uživatelského rozhraní a vyhladovění odpovědi na normální uživatelský vstup.

Parametr context je libovolný objekt, který se předává do objektu callback. Můžete ho použít k určení mechanismu synchronizace používaného k řízení přístupu k collection. Context může být null.