Megosztás a következőn keresztül:

XAML-betöltési és függőségi tulajdonságok

A Windows Presentation Foundation (WPF) extensible Application Markup Language (XAML) processzor implementációja eredendően függőségi tulajdonságérzékeny. Ezért az XAML feldolgozó a WPF tulajdonságrendszer metódusait használja az XAML betöltéséhez és a függőségi tulajdonságok feldolgozásához, és teljes mértékben megkerüli a függőségi tulajdonság-burkolókat a WPF tulajdonságrendszer metódusokkal, például GetValue és SetValue. Ha tehát egyéni logikát ad hozzá az egyéni függőségi tulajdonság tulajdonságburkolójához, akkor az XAML-processzor nem fogja meghívni, ha egy tulajdonság értéke XAML-ben van beállítva.

Előfeltételek

A cikk feltételezi a függőségi tulajdonságok alapszintű ismeretét, és hogy elolvasta függőségi tulajdonságok áttekintését. A cikkben szereplő példák követéséhez segít, ha ismeri az Extensible Application Markup Language (XAML) nyelvet, és ismeri a WPF-alkalmazások írásának módját.

WPF XAML rakodó teljesítménye

A WPF XAML-processzor számítási szempontból kevésbé költséges, ha közvetlenül meghívja a SetValue egy függőségi tulajdonság értékének beállításához a függőségi tulajdonság tulajdonságburkolójának használata helyett.

Ha az XAML-processzor a tulajdonságburkolót használja, akkor a háttérkód teljes objektummodelljének következtetésére lenne szükség csak a korrektúra által jelzett típus és tagkapcsolatok alapján. Bár a típus xmlns és szerelvényattribútumok kombinációjával azonosítható, a tagok azonosítása, az attribútumként beállítható tagok meghatározása és a támogatott tulajdonságérték-típusok feloldása széles körű tükrözést igényelne PropertyInfohasználatával.

A WPF tulajdonságrendszer egy adott DependencyObject származtatott típuson implementált függőségi tulajdonságokat tartalmazó tárolótáblát tart fenn. Az XAML-processzor ezzel a táblával következtet egy függőségi tulajdonság függőségi tulajdonságának azonosítójára. Konvenció szerint például egy ABC nevű függőségi tulajdonság függőségi tulajdonságának azonosítója ABCProperty. Az XAML-processzor hatékonyan állíthatja be a függőségi tulajdonságok értékét úgy, hogy meghívja a SetValue metódust a benne található típusra a függőségi tulajdonság azonosítójával.

A függőségi tulajdonságburkolókról további információkért lásd az egyéni függőségi tulajdonságokat .

Az egyéni függőségi tulajdonságok következményei

A WPF XAML-processzor kikerüli a tulajdonságburkolókat, és közvetlenül meghívja a SetValue metódust egy függőségi tulajdonság értékének beállításához. Ezért ne helyezzen el további logikát az egyéni függőségi tulajdonság set tartozékában, mert ez a logika nem fog futni, ha egy tulajdonság értéke XAML-ben van beállítva. A set tartozék csak SetValue hívást tartalmazhat.

Hasonlóképpen, a WPF XAML-feldolgozó azon részei, amelyek tulajdonságértékeket kérnek le, megkerülik a tulajdonságburkolót, és közvetlenül meghívják GetValue. Ezért ne helyezzen el további logikát az egyéni függőségi tulajdonság get tartozékában, mert ez a logika nem fog futni, ha egy tulajdonságértéket beolvas az XAML-ben. A get tartozék csak GetValue hívást tartalmazhat.

Függőség tulajdonság burkoló példával

Az alábbi példa egy ajánlott függőségi tulajdonságdefiníciót mutat be a tulajdonságburkolókkal. A függőségi tulajdonság azonosítója egy public static readonly mezőként van tárolva, és a get és set tartozékai nem tartalmaznak olyan kódot, amely a függőségi tulajdonság értékét visszaadó WPF tulajdonságrendszer-metódusokon túli kódot tartalmaz. Ha olyan kóddal rendelkezik, amelyet a függőségi tulajdonság értéke megváltozásakor kell futtatnia, érdemes lehet a kódot a függőségi tulajdonság PropertyChangedCallback elhelyezni. További információkért lásd: Tulajdonságváltozás visszahívásai.

// Register a dependency property with the specified property name,
// property type, owner type, and property metadata. Store the dependency
// property identifier as a public static readonly member of the class.
public static readonly DependencyProperty AquariumGraphicProperty =
    DependencyProperty.Register(
      name: "AquariumGraphic",
      propertyType: typeof(Uri),
      ownerType: typeof(Aquarium),
      typeMetadata: new FrameworkPropertyMetadata(
          defaultValue: new Uri("http://www.contoso.com/aquarium-graphic.jpg"),
          flags: FrameworkPropertyMetadataOptions.AffectsRender,
          propertyChangedCallback: new PropertyChangedCallback(OnUriChanged))
    );

// Property wrapper with get & set accessors.
public Uri AquariumGraphic
{
    get => (Uri)GetValue(AquariumGraphicProperty);
    set => SetValue(AquariumGraphicProperty, value);
}

// Property-changed callback.
private static void OnUriChanged(DependencyObject dependencyObject, 
    DependencyPropertyChangedEventArgs e)
{
    // Some custom logic that runs on effective property value change.
    Uri newValue = (Uri)dependencyObject.GetValue(AquariumGraphicProperty);
    Debug.WriteLine($"OnUriChanged: {newValue}");
}

' Register a dependency property with the specified property name,
' property type, owner type, and property metadata. Store the dependency
' property identifier as a public static readonly member of the class.
Public Shared ReadOnly AquariumGraphicProperty As DependencyProperty =
    DependencyProperty.Register(
        name:="AquariumGraphic",
        propertyType:=GetType(Uri),
        ownerType:=GetType(Aquarium),
        typeMetadata:=New FrameworkPropertyMetadata(
            defaultValue:=New Uri("http://www.contoso.com/aquarium-graphic.jpg"),
            flags:=FrameworkPropertyMetadataOptions.AffectsRender,
            propertyChangedCallback:=New PropertyChangedCallback(AddressOf OnUriChanged)))

' Property wrapper with get & set accessors.
Public Property AquariumGraphic As Uri
    Get
        Return CType(GetValue(AquariumGraphicProperty), Uri)
    End Get
    Set
        SetValue(AquariumGraphicProperty, Value)
    End Set
End Property

' Property-changed callback.
Private Shared Sub OnUriChanged(dependencyObject As DependencyObject,
                                e As DependencyPropertyChangedEventArgs)
    ' Some custom logic that runs on effective property value change.
    Dim newValue As Uri = CType(dependencyObject.GetValue(AquariumGraphicProperty), Uri)
    Debug.WriteLine($"OnUriChanged: {newValue}")
End Sub

Lásd még

  • Last updated on