Partilhar via

Como - Usar um Dicionário de Recursos Application-Scope

  • Artigo

Este exemplo mostra como definir e usar um dicionário de recursos personalizado de escopo de aplicativo.

Exemplo

Application expõe um repositório no âmbito da aplicação para recursos partilhados: Resources. Por padrão, a propriedade Resources é inicializada com uma instância do tipo ResourceDictionary. Você usa essa instância quando obtém e define propriedades de escopo do aplicativo usando Resources. Para obter mais informações, consulte Como obter e definir um recurso Application-Scope.

Se tiveres vários recursos definidos usando Resources, podes usar um dicionário de recursos personalizado para armazenar esses recursos e definir Resources com isso. A seguir mostra como você declara um dicionário de recursos personalizado usando XAML.

<ResourceDictionary 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
    <SolidColorBrush x:Key="StandardSolidColorBrush" Color="Blue" />
    <LinearGradientBrush x:Key="StandardLinearGradientBrush" StartPoint="0.0,0.0" EndPoint="1.0,1.0">
        <LinearGradientBrush.GradientStops>
            <GradientStop Color="White" Offset="0" />
            <GradientStop Color="Black" Offset="1" />
        </LinearGradientBrush.GradientStops>
    </LinearGradientBrush>
</ResourceDictionary>

Trocar dicionários de recursos inteiros usando Resources permite que você ofereça suporte a temas de escopo de aplicativo, onde cada tema é encapsulado por um único dicionário de recursos. O exemplo a seguir mostra como definir o ResourceDictionary.

<!--Set the Application ResourceDictionary-->
<Application.Resources>
    <ResourceDictionary Source="MyResourceDictionary.xaml" />
</Application.Resources>

A seguir é demonstrado como pode obter recursos com âmbito de aplicação a partir do dicionário de recursos exposto por Resources no XAML.

<!--Set the brush as a StaticResource from the ResourceDictionary-->
<Rectangle Name="Rect" Height="200" Width="100" Fill="{StaticResource ResourceKey=StandardSolidColorBrush}" />

A seguir mostra como você também pode obter os recursos no código.

//Get a resource from the ResourceDictionary in code
Brush gradientBrush = (Brush)Application.Current.FindResource("StandardLinearGradientBrush");

'Get a resource from the ResourceDictionary in code
Dim GradientBrush As Brush = Application.Current.FindResource("StandardLinearGradientBrush")

Há duas considerações a fazer ao usar Resources. Primeiro, o dicionário chave é um objeto, portanto, você deve usar exatamente a mesma instância de objeto ao definir e obter um valor de propriedade. (Observe que a chave diferencia maiúsculas de minúsculas ao usar uma cadeia de caracteres.) Em segundo lugar, o dicionário valor é um objeto, então você terá que converter o valor para o tipo desejado ao obter um valor de propriedade.

Alguns tipos de recursos podem usar automaticamente uma propriedade definida pelo tipo como uma chave explícita, como os tipos Style e DataTemplate. Isso pode substituir o valor x:Key. Para garantir que a sua chave de x:Key seja respeitada, declare-a antes da propriedade de chave explícita. Para obter mais informações, consulte Styles, DataTemplates e chaves implícitas.

Ver também