Apriamo la pagina HTML, nel <body>
troviamo il markup necessario per la visualizzazione del contenuto Silverlight.
<object data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="100%" height="100%"> <param name="source" value="ClientBin/HelloWorlldSilverlight.xap" /> <param name="onerror" value="onSilverlightError" /> <param name="background" value="white" /> <param name="minRuntimeVersion" value="2.0.31005.0" /> <param name="autoUpgrade" value="true" /> <!-- Aspetto alternativo --> <a href="http://go.microsoft.com/fwlink/?LinkID=124807" style="text-decoration: none;"> <img src="http://go.microsoft.com/fwlink/?LinkId=108181" alt="Get Microsoft Silverlight" style="border-style: none" /> </a> </object>
Tutto ciò che occorre per inserire Silverlight in una pagina è l'elemento <object>
con i necessari attributi, come il MIME type e i parametri, rappresentati dal tag <param>
: il percorso del file XAP (source
), la funzione JavaScript da richiamare in caso di errore non gestito dall'applicazione e il colore di sfondo. Quando il plugin di Silverlight non è installato il comportamento predefinito prevede la visualizzazione della seguente immagine per effettuarne il download e l'installazione.
Nelle pagina ASP.NET, possiamo usufruire anche dell'apposito WebControl: System.Web.UI.SilverlightControls.Silverlight
, che si occuperà di generare il markup (il tag <object>
), tutto ciò che dobbiamo fare è impostare gli attributi del controllo. Vediamo la definizione di questo controllo nella pagina HelloWorlldSilverlightTestPage.aspx
.
<asp:Silverlight ID="Xaml1" runat="server"
Source="~/ClientBin/HelloWorlldSilverlight.xap"
MinimumVersion="2.0.31005.0" Width="100%" Height="100%" />
A parte i tipici attributi dei controlli ASP.NET, vediamo che quelli principali sono Source
, con il quale indichiamo il percorso del file XAP e MinimumVersion
, che indica la versione minima, di Silverlight, richiesta dalla nostra applicazione.
Il markup personalizzato da mostrare in caso di plugin assente va impostato nell'elemento PluginNotInstalledTemplate
del controllo Silverlight
.
<asp:Silverlight ... >
<PluginNotInstalledTemplate>
<a href="http://go.microsoft.com/fwlink/?LinkID=124807" style="text-decoration: none;">
<img src="http://go.microsoft.com/fwlink/?LinkId=108181"
alt="Get Microsoft Silverlight"
style="border-style: none" />
</a>
</PluginNotInstalledTemplate>
</asp:Silverlight>