次の例では、UserControl をルート要素とし、TextBlock オブジェクトと Canvas オブジェクトを子として持つマークアップ階層が作成されます。 この例はマネージ API 用であり、XAP パッケージからの指定されたエントリ ポイント クラスおよび Silverlight ベースのアプリケーションのアプリケーション マニフェストを表します。

<UserControl x:Class="SilverlightApplication1.Page"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
>
  <StackPanel>
    <Rectangle
      Width="200" Height="35"
      Fill="PowderBlue" />
    <TextBlock
      Foreground="Teal" FontFamily="Verdana" FontSize="18" FontWeight="Bold"
      Text="Sample Output" />
  </StackPanel>
</UserControl>

マネージ API の場合は、XAML が解析される前に、開発者のコンピューターでマークアップ コンパイラによってコンパイルされます。 この概念の詳細については、「分離コードと部分クラス」を参照してください。

クライアントで実行時に XAML が読み込まれて解析されると、パーサーでこのマークアップからオブジェクト ツリーが作成されます。 オブジェクト ツリーのルートは、UserControl オブジェクトになります。 実際、オブジェクト ツリーには、特定の UserControl サブクラスのインスタンス、つまり、ルート要素の x:Class 属性で参照された Page クラスが格納されます。

実行時に Silverlight ベースのアプリケーションを操作する場合は、Silverlight のマネージ API を使用して、Page クラスにアクセスします。 作成されたオブジェクト ツリーの Page ルートを越えて、Application オブジェクトにアクセスすることもできます。 Silverlight のコンテンツ領域に表示される UI のページ全体を XAML 形式での表現に置き換えたとしても、Silverlight ベースのアプリケーションが持つさまざまな側面には、Application からそのままアクセスできます。Application には、アプリケーション レベルのリソースや、HTML DOM に関連付けられているオブジェクトが存在するほか、アプリケーションのパーツを含んだパッケージにアクセスすることもできます。 詳細については、「アプリケーション モデル」を参照してください。

Loose XAML

次の例では、ルート Canvas オブジェクトを持つマークアップ階層が作成されます。 この例は JavaScript API 用であり、Silverlight をホストする HTML ページと同じサーバーによってサービスが提供される個々の XAML ファイルを表します。 この場合、XAML ファイルはパッケージ化されていません。また、マークアップ コンパイラによるコンパイルも行われていません。

<StackPanel
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
>
  <Rectangle
    Width="200" Height="35"
    Fill="PowderBlue" />
  <TextBlock
    Foreground="Teal" FontFamily="Verdana" FontSize="18"
    FontWeight="Bold"
    Text="Sample Output" />
</StackPanel>

また、この XAML は、基本的な UI も定義します。 実際、この XAML は、外見上は前の例と同じです。 パーサーでこの XAML を解析すると、マークアップからオブジェクト ツリーが作成されます。 このオブジェクト ツリーのルート要素は、StackPanel になります。

実行時に Silverlight ベースのアプリケーションを操作する場合は、オブジェクト ツリー全体にすぐにアクセスできるわけではありません。 DOM 内の Silverlight プラグインを参照するために作成した変数にアクセスすることはできますが、それ以外の場合、通常はイベント ハンドラーの sender を介してプログラミング モデルにアクセスします。 この sender は、オブジェクト ツリー内のオブジェクトで、任意の Silverlight API から利用できます。 ただし、sender は、通常は HTML DOM から利用できません。DOM は、ホスト object タグのレベルで停止します。

すべての Name / x:Name 参照は、実行時に JavaScript API によって使用されますが、初期の唯一の使用法は FindName 呼び出しのターゲットとしての役割です。 FindName 呼び出しを行って初めて、オブジェクト ツリーに実際のオブジェクトが含められます。これよりも前の時点では、オブジェクトの名前は単なる文字列であり、オブジェクトではありません。 通常は、Name に使用されている文字列と同じ変数名を使用します。この慣例は、同じ XAML を使用して JavaScript の分離コードをマネージ コードの分離コードに移行する場合に非常に有用です。