Dictionare de resurse combinate – WPF .NET

• 30.03.2021
• 5 minute de citit

• • A

In acest articol

Resursele Windows Presentation Foundation (WPF) accepta o caracteristica de dictionar de resurse combinata. Aceasta caracteristica ofera o modalitate de a defini portiunea de resurse a unei aplicatii WPF in afara aplicatiei XAML compilate. Resursele pot fi apoi partajate intre aplicatii si sunt, de asemenea, mai convenabil izolate pentru localizare.

Creati un dictionar combinat

In marcare, utilizati urmatoarea sintaxa pentru a introduce un dictionar de resurse combinate intr-o pagina:

<Page.Resources> <ResourceDictionary> <ResourceDictionary.MergedDictionaries> <ResourceDictionary Source = “myresourcedictionary.xaml” /> <ResourceDictionary Source = “myresourcedictionary2.xaml” /> </ResourceDictionary.MergedDictionaries> </ResourceDictionary> </Page.Resources >

Elementul ResourceDictionary nu are o directiva x: Key, care este in general necesara pentru toate articolele dintr-o colectie de resurse. Dar o alta referinta ResourceDictionary din colectia MergedDictionaries este un caz special, rezervat acestui scenariu de dictionar de resurse combinat. In plus, ResourceDictionary care introduce un dictionar de resurse combinat nu poate avea o directiva x: Key.

De obicei, fiecare ResourceDictionary din colectia MergedDictionaries specifica un atribut Source. Valoarea sursei ar trebui sa fie un identificator de resurse uniform (URI) care se rezolva la locatia fisierului de resurse care trebuie fuzionat. Destinatia acelui URI trebuie sa fie un alt fisier XAML, cu ResourceDictionary ca element radacina.

Comportament de dictionar combinat

Resursele dintr-un dictionar fuzionat ocupa o locatie in sfera de cautare a resurselor care este imediat dupa sfera dictionarului principal de resurse in care sunt fuzionate. Desi o cheie de resursa trebuie sa fie unica in cadrul oricarui dictionar individual, o cheie poate exista de mai multe ori intr-un set de dictionare combinate. In acest caz, resursa returnata va proveni din ultimul dictionar gasit secvential in colectia MergedDictionaries. Daca colectia MergedDictionaries a fost definita in XAML, atunci ordinea dictionarelor combinate din colectie este ordinea elementelor prevazute in marcaj. Daca o cheie este definita in dictionarul principal si, de asemenea, intr-un dictionar care a fost fuzionat, atunci resursa returnata va proveni din dictionarul principal.

Fuzionat dictionare si cod

Dictionarele combinate pot fi adaugate la un dictionar Resurse prin cod. ResourceDictionary implicit, initial gol, care exista pentru orice proprietate Resurse are si o proprietate de colectie MergedDictionaries initial goala. Pentru a adauga un dictionar fuzionat prin cod, obtineti o referinta la ResourceDictionary primar dorit, obtineti valoarea proprietatii MergedDictionaries si apelati Add pe colectia generica continuta in MergedDictionaries. Obiectul pe care il adaugati trebuie sa fie un ResourceDictionary nou.

In cod, nu setati proprietatea sursa. In schimb, trebuie sa obtineti un obiect ResourceDictionary fie creand unul, fie incarcandu-l. O modalitate de a incarca un ResourceDictionary existent pentru a apela XamlReader.Load pe un flux de fisiere XAML existent care are o radacina ResourceDictionary, apoi aruncand valoarea returnata in ResourceDictionary.

URI-uri de dictionar combinate

Exista mai multe tehnici pentru a include un dictionar de resurse combinate, care sunt indicate de formatul identificatorului de resurse uniform (URI) pe care il utilizati. In linii mari, aceste tehnici pot fi impartite in doua categorii: resurse care sunt compilate ca parte a proiectului si resurse care nu sunt compilate ca parte a proiectului.

Pentru resursele care sunt compilate ca parte a proiectului, puteti utiliza o cale relativa care se refera la locatia resursei. Calea relativa este evaluata in timpul compilarii. Resursa dvs. trebuie definita ca parte a proiectului ca o actiune de construire a resurselor . Daca includeti un fisier .xaml resursa in proiect ca Resursa , nu este necesar sa copiati fisierul resursa in directorul de iesire, resursa fiind deja inclusa in aplicatia compilata. De asemenea, puteti utiliza actiunea de compilare a continutului , dar trebuie apoi sa copiati fisierele in directorul de iesire si, de asemenea, sa implementati fisierele de resurse in aceeasi relatie de cale catre executabil.

O tehnica asociata este utilizarea unui URI de pachet la un fisier XAML si denumirea acestuia ca sursa . Pack URI permite referinte la componentele ansamblurilor la care se face referinta si alte tehnici. Pentru mai multe informatii despre URI-uri de pachete , consultati Resurse aplicatii WPF, continut si fisiere de date.

Pentru resursele care nu sunt compilate ca parte a proiectului, URI-ul este evaluat in timpul rularii. Puteti utiliza un transport URI comun, cum ar fi fisier: sau http: pentru a face referire la fisierul resursa. Dezavantajul utilizarii abordarii resurselor necompilate este ca fisierul: accesul necesita pasi de implementare suplimentari, iar accesul http: implica zona de securitate a Internetului.

Reutilizarea dictionarelor combinate

Puteti reutiliza sau partaja dictionare de resurse imbinate intre aplicatii, deoarece dictionarul de resurse de imbinat poate fi referit prin orice identificator de resurse uniform (URI) valid. Exact modul in care faceti acest lucru depinde de strategia de implementare a aplicatiei si de modelul de aplicatie pe care il urmati. Strategia Pack URI mentionata anterior ofera o modalitate de a obtine in mod obisnuit o resursa combinata in mai multe proiecte in timpul dezvoltarii prin partajarea unei referinte de asamblare. In acest scenariu, resursele sunt distribuite in continuare de catre client si cel putin una dintre aplicatii trebuie sa implementeze ansamblul de referinta. De asemenea, este posibil sa faceti referire la resursele combinate printr-un URI distribuit care utilizeaza protocolul http:

Scrierea dictionarelor imbinate ca fisiere de aplicatii locale sau in spatiul de stocare local partajat este un alt scenariu posibil de implementare a dictionarului si a aplicatiei.

Localizare

Daca resursele care trebuie localizate sunt izolate de dictionarele care sunt imbinate in dictionare primare si sunt pastrate ca XAML libere, aceste fisiere pot fi localizate separat. Aceasta tehnica este o alternativa usoara la localizarea ansamblurilor de resurse satelit. Pentru detalii, consultati Prezentare globala si localizare WPF.

Vezi si

• ResourceDictionary
• Prezentare generala a resurselor XAML
• Resurse in cod
• Resurse aplicatii WPF, continut si fisiere de date
• Prezentare globala si localizare WPF