Questa documentazione è stata archiviata e non viene gestita.

Metodo FrameworkElement.FindResource

Aggiornamento: novembre 2007

Cerca una risorsa con la chiave specificata e genera un'eccezione se la risorsa richiesta non viene trovata.

Spazio dei nomi:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public Object FindResource(
	Object resourceKey
)
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.Object

Risorsa 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.

EccezioneCondizione
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.

.NET Framework

Supportato in: 3.5, 3.0
Mostra: