FrameworkElement.Unloaded イベント

2013/12/12

このオブジェクトがメイン オブジェクト ツリーに接続されていない状態になると発生します。

Namespace:  System.Windows
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

'宣言
Public Event Unloaded As RoutedEventHandler
<frameworkElement Unloaded="eventhandler"/>

RoutedEventHandler に基づくハンドラーを使用して、このイベントを処理します。

オブジェクトがメイン オブジェクト ツリーから削除されると、Windows Phone UI には表示されなくなります。これは、オブジェクトによる他のリソースへの参照を削除するのに適切な時期である可能性があります。たとえば、オブジェクトからの Web サービスへの接続が現在、切断されている可能性があります。

Unloaded は、オブジェクト ツリーの変更に対して非同期に発生します。

非同期に発生するものの、オブジェクトの連続するサブツリー内での Unloaded イベントの発生順序には一貫性があります。Unloaded イベントは、ランタイム オブジェクト ツリー内のピア オブジェクトの配置の順序で、上から下へ発生します。サブツリーの最上位またはルートによって、最初の Unloaded イベントが発生します。ルートの最初の子要素が次の Unloaded イベントを発生させ、その子が存在する場合は、その子がイベントを発生させ、子に子が存在する限り、それが続きます。まだイベントが発生していないピアがあるオブジェクト ツリーのレベルに戻ると、その分岐のサブルートは Unloaded を発生させ、走査されたりします。

イベント データは RoutedEventArgs を使用しますが、Unloaded は、Windows Phone でのルーティング イベントではありません。

何らかの理由で Windows Phone アプリケーションがシャットダウンした場合は、どのオブジェクトに対しても Unloaded は発生しません。

オブジェクトが表示されているが、まだ最終表示のメイン オブジェクト ツリーに残っている場合は、Unloaded が発生し、その後に Loaded が発生します。これは、サブツリーで親が再設定される場合の、サブツリー内のすべてのオブジェクトに該当します。

VisibilityVisibility.Collapsed に設定することは、オブジェクト ツリーからアンロードされることと同等ではなく、オブジェクトで Unloaded を発生させることもありません。同様に、Popup の開いている状態を変更しても、Popup およびその子要素のどちらでも、Unloaded は発生しません。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft