VisualElement.Resources Eigenschaft

Definition

Namespace:

Xamarin.Forms

Assembly:

Xamarin.Forms.Core.dll

Ruft das lokale Ressourcenwörterbuch ab bzw. legt es fest.

public Xamarin.Forms.ResourceDictionary Resources { get; set; }

member this.Resources : Xamarin.Forms.ResourceDictionary with get, set

Eigenschaftswert

ResourceDictionary

Das aktuelle Ressourcenwörterbuch, in dem Ressourcen nach Schlüssel gespeichert werden.

Hinweise

In XAML werden Ressourcenwörterbücher mit Schlüssel-Wert-Paaren gefüllt, die in XML angegeben und folglich zur Laufzeit erstellt werden. Die Schlüssel im Ressourcenwörterbuch werden mit dem x:Key Attribut des XML-Tags für den zu erstellenden Typ angegeben. Ein Objekt dieses Typs wird erstellt und mit den Eigenschafts- und Feldwerten initialisiert, die entweder durch zusätzliche Attribute oder durch geschachtelte Tags angegeben werden, wobei beides, wenn vorhanden, einfach Zeichenfolgendarstellungen der Eigenschaften- oder Feldnamen sind. Das -Objekt wird dann zur Laufzeit in den ResourceDictionary für den einschließenden Typ eingefügt.

Der folgende XAML-Code aus der XAML-Serie für Xamarin.Forms erstellt beispielsweise ein Ressourcenverzeichnis, das Objektkonstanten enthältLayoutOptions, die für alle Layout Objekte verwendet werden können, die der umgebenden ContentPageHinzugefügt werden:

<ContentPage.Resources>
<ResourceDictionary>
<LayoutOptions x:Key="horzOptions"
                     Alignment="Center" />

<LayoutOptions x:Key="vertOptions"
                     Alignment="Center"
                     Expands="True" />
</ResourceDictionary>
</ContentPage.Resources>

Beachten Sie, dass der obige Codeausschnitt nur gültig ist, wenn er in einem <ContentPage>...</ContentPage> Tagpaar geschachtelt ist. Innerhalb dieses Paares kann der App-Entwickler sowohl den horzOptionsvertOptions Schlüssel als auch verwenden, um Werte für Eigenschaften des Typs LayoutOptions mithilfe der "{...}" statischen Ressourcensyntax anzugeben. Das folgende kurze Beispiel, das ebenfalls aus der XAML-Serie für Xamarin.Forms stammt, veranschaulicht diese Syntax:

<Button Text="Do this!"
        HorizontalOptions="{StaticResource horzOptions}"
        VerticalOptions="{StaticResource vertOptions}"
        BorderWidth="3"
        Rotation="-15"
        TextColor="Red"
        Font="Large" />

Ressourcenwörterbücher und die zugehörigen XML-Dateien bieten dem Anwendungsentwickler eine praktische Methode zum Wiederverwenden von Code innerhalb der XAML-Kompilierzeit- und Laufzeit-Engines.