x:Load 属性

[アーティクル]
07/13/2023

スタートアップ、ビジュアルツリーの作成、XAML アプリのメモリ使用量を最適化するには、x:Load を使用します。 x:Load の使用には、Visibility と同様の効果があります。ただし、要素が読み込まれていない場合はメモリが解放され、内部的に小さなプレースホルダーを使ってビジュアルツリー内の場所がマークされます。

x:Load 属性が指定された UI 要素の読み込み/アンロードには、コードを使用することも、x:Bind 式を使用することもできます。これは、表示頻度の低い要素や条件付きで表示される要素のコストを削減するのに役立ちます。 Grid や StackPanel などのコンテナーに x:Load を使用した場合は、コンテナーおよびすべての子がグループとして読み込まれ、アンロードされます。

XAML フレームワークによる遅延要素の追跡では、x:Load 属性が指定された要素ごとに、プレースホルダー分として約 600 バイトがメモリ使用量に追加されます。したがって、この属性を過剰に使うと実際のパフォーマンスが低下する可能性があります。この属性は、非表示にする必要がある要素のみに対して使用することをお勧めします。コンテナーに対して x:Load を使用した場合、その効果があるのは x:Load 属性を指定した要素のみです。

重要

x:Load 属性は、Windows 10 Version 1703 (Creators Update) 以降で使用できます。 x:Load を使用するには、Visual Studio プロジェクトの対象とする最小バージョンを Windows 10 Creators Update (10.0、ビルド 15063) にする必要があります。

XAML 属性の使用方法

<object x:Load="True" .../>
<object x:Load="False" .../>
<object x:Load="{x:Bind Path.to.a.boolean, Mode=OneWay}" .../>

要素の読み込み

要素を読み込むには、いくつかの方法があります。

x:Bind 式を使用して読み込み状態を指定します。この式は、要素を読み込む場合は true、アンロードする場合は false を返す必要があります。
要素に対して定義した名前を指定して FindName を呼び出します。
要素に対して定義した名前を指定して GetTemplateChild を呼び出します。
VisualState で、x:Load をターゲットに設定している Setter または Storyboard アニメーションを使います。
任意の Storyboard のアンロード済み要素をターゲットに設定します。

注: 要素のインスタンス化が開始されると、インスタンスは UI スレッド上で作成されます。そのため、一度に作成されるインスタンスが多すぎると、UI で引っかかりが起きることがあります。

上に示したいずれかの方法で遅延要素が作成されると、以下の動作が発生します。

要素の Loaded イベントが生成されます。
x:Name のフィールドが設定されます。
要素の x:Bind バインドが適用されます。
遅延要素を含むプロパティに関するプロパティ変更通知を受信するように登録した場合は、通知が生成されます。

要素のアンロード

要素をアンロードするには:

x:Bind 式を使用して読み込み状態を指定します。この式は、要素を読み込む場合は true、アンロードする場合は false を返す必要があります。
Page または UserControl で UnloadObject を呼び出し、オブジェクト参照を渡します。
Windows.UI.Xaml.Markup.XamlMarkupHelper.UnloadObject オブジェクト参照を渡します。

オブジェクトが読み込まれると、ツリー内でプレースホルダーに置き換えられます。オブジェクトのインスタンスは、すべての参照が解放されるまでメモリ内に残ります。 Page/UserControl に対する UnloadObject API は、codegen で確保されている参照が x:Name および x:Bind 用に解放されるように設計されています。アプリコードで追加の参照を確保している場合は、これらも解放する必要があります。

要素が読み込まれると、要素関連の状態がすべて破棄されるため、x:Load を Visibility の最適化バージョンとして使用する場合は、すべての状態をバインド経由で適用するか、コードによって Loaded イベントの発生時に再適用する必要があります。

制限

x:Load を使う際の制限事項は次のとおりです。

要素を後で検索する手段として、要素の x:Name を定義する必要があります。
x:Load は、UIElement または FlyoutBase から派生した型に対してのみ使用できます。
Page、UserControl、または DataTemplate のルート要素に x:Load を使用することはできません。
ResourceDictionary 内の要素に x:Load を使用することはできません。
XamlReader.Load で読み込まれた Loose XAML に x:Load を使用することはできません。
親要素を移動すると、読み込まれていない要素はすべて消去されます。

注釈

入れ子になった要素に x:Load を使用することはできますが、最も外側の要素から実体化する必要があります。親が実体化される前に子要素を実体化しようとすると、例外が生成されます。

通常は、最初のフレームに表示できないものを遅延させることをお勧めします。遅延対象の候補を見つけるための指針の 1 つは、Visibility が折りたたまれた状態で作成されている要素を探すことです。また、ユーザーの操作によってトリガーされる UI は、遅延できる要素がないか探す対象として適しています。

ListView の遅延要素に注意してください。この場合、遅延要素により起動時間が短縮しますが、作成する内容によっては、パンのパフォーマンスも低下することがあります。パンのパフォーマンスを向上させる方法については、{x:Bind} マークアップ拡張および x:Phase 属性に関するドキュメントをご覧ください。

x:Load と同時に x:Phase 属性を使った場合、要素または要素ツリーが実体化されると、バインディングが現在のフェーズまで (現在のフェーズを含めて) 適用されます。 x:Phase に指定されたフェーズが、要素の読み込み状態に影響を与えたり、制御したりすることはありません。パンの一部としてリスト項目がリサイクルされると、実現した要素は、アクティブな他の要素と同じように機能し、コンパイル済みバインド ({x:Bind} バインディング) は同じルール (フェージングを含む) を使って処理されます。

一般的なガイドラインでは、必要なパフォーマンスが得られていることを確認するために、作業の前と後にアプリのパフォーマンスを測定します。

x:Load を要素に追加する場合の動作の変化を最小限に抑えるために、x:Bind バインドは、x:Load を使用する要素がないかのように、通常のタイミングで計算されます。たとえば、OneTime x:Bind バインドは、ルート要素が読み込まれるときに計算されます。 x:Bind バインドの計算時に要素が認識されない場合は、計算された値が保存され、読み込まれるときに要素に適用されます。この動作は、 x:Bind バインドが要素の実現時に計算されることが予想される場合に、驚くことがあります。

例

<StackPanel>
    <Grid x:Name="DeferredGrid" x:Load="False">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto" />
            <RowDefinition Height="Auto" />
        </Grid.RowDefinitions>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="Auto" />
            <ColumnDefinition Width="Auto" />
        </Grid.ColumnDefinitions>

        <Rectangle Height="100" Width="100" Fill="Orange" Margin="0,0,4,4"/>
        <Rectangle Height="100" Width="100" Fill="Green" Grid.Column="1" Margin="4,0,0,4"/>
        <Rectangle Height="100" Width="100" Fill="Blue" Grid.Row="1" Margin="0,4,4,0"/>
        <Rectangle Height="100" Width="100" Fill="Gold" Grid.Row="1" Grid.Column="1" Margin="4,4,0,0"
                   x:Name="one" x:Load="{x:Bind (x:Boolean)CheckBox1.IsChecked, Mode=OneWay}"/>
        <Rectangle Height="100" Width="100" Fill="Silver" Grid.Row="1" Grid.Column="1" Margin="4,4,0,0"
                   x:Name="two" x:Load="{x:Bind Not(CheckBox1.IsChecked), Mode=OneWay}"/>
    </Grid>

    <Button Content="Load elements" Click="LoadElements_Click"/>
    <Button Content="Unload elements" Click="UnloadElements_Click"/>
    <CheckBox x:Name="CheckBox1" Content="Swap Elements" />
</StackPanel>

// This is used by the bindings between the rectangles and check box.
private bool Not(bool? value) { return !(value==true); }

private void LoadElements_Click(object sender, RoutedEventArgs e)
{
    // This will load the deferred grid, but not the nested
    // rectangles that have x:Load attributes.
    this.FindName("DeferredGrid"); 
}

private void UnloadElements_Click(object sender, RoutedEventArgs e)
{
     // This will unload the grid and all its child elements.
     this.UnloadObject(DeferredGrid);
}

次の方法で共有

x:Load 属性

XAML 属性の使用方法

要素の読み込み

要素のアンロード

制限

注釈

例

フィードバック

その他のリソース