Metodo FrameworkElement.FindResource
Aggiornamento: novembre 2007
Cerca una risorsa con la chiave specificata e genera un'eccezione se la risorsa richiesta non viene trovata.
Assembly: PresentationFramework (in PresentationFramework.dll)
public Object FindResource( Object resourceKey )
public function FindResource( resourceKey : Object ) : Object
Non è possibile utilizzare metodi in XAML.
Parametri
- resourceKey
- Tipo: System.Object
Identificatore della chiave della risorsa richiesta.
Valore restituito
Tipo: System.ObjectRisorsa richiesta. Se non viene trovata una risorsa con la chiave specificata, viene generata un'eccezione. In tal caso potrebbe anche essere restituito un valore UnsetValue.
| Eccezione | Condizione |
|---|---|
| ResourceReferenceKeyNotFoundException | La chiave della risorsa richiesta non è stata trovata. |
| ArgumentNullException | resourceKey è null. |
Nota importante: |
|---|
Se si chiama questo metodo con una chiave che non è possibile trovare, viene generata un'eccezione. Se non si desidera gestire eccezioni restituite dalla chiamata a FindResource, chiamare invece TryFindResource. Quando non è possibile trovare una risorsa richiesta TryFindResource restituisce null e non genera un'eccezione. |
Se la risorsa non viene trovata nell'elemento chiamante, viene cercato l'elemento padre nell'albero logico, quindi nell'applicazione, nei temi e infine nelle risorse di sistema. Questa metodologia di ricerca è identica a quella utilizzata per la ricerca nell'albero quando una risorsa viene richiesta da un riferimento a una risorsa dinamica nel markup. Per ulteriori informazioni sulla ricerca di risorse, vedere Cenni preliminari sulle risorse.
In genere si esegue immediatamente il cast di un valore restituito FindResource nel tipo della proprietà che si sta impostando con il valore della risorsa restituito.
Le chiavi di risorsa non sono necessariamente stringhe. Ad esempio, gli stili per i controlli a livello di tema vengono intenzionalmente associati con chiave alla classe Type del controllo e gli stili dell'applicazione o della pagina per i controlli utilizzano questa stessa convenzione di chiavi. Per informazioni dettagliate, vedere Applicazione di stili e modelli o Cenni preliminari sulle risorse.
Nell'esempio seguente si ottiene una risorsa denominata e viene eseguito il cast di tale risorsa a un tipo appropriato per il riempimento di una proprietà.
void SetBGByResource(object sender, RoutedEventArgs e) { Button b = sender as Button; b.Background = (Brush)this.FindResource("RainbowBrush"); }
Windows Vista
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Nota importante: