(1)Downloader的使用
首先我们看什么是Downloader,就是一个为描述Silverlight plug-in下载功能的集合.Downloader能异步的通过HTTP GET Request下载内容.他是一个能帮助Silverlight下载内容的一个对象,这些下载内容包括(XMAL content,JavaScript content,ZIP packages,Media,images).当Silverlight plug-in安装时候,并不能完全提供所有应用程序的内容,但在一经请求这些内容就会响应应用程序的需要.更重要的是,你能在呈现内容后它仍然能被使用,而且不需要刷新业面.Downloader对象提供了初始数据传输的功能,通过事件和状态性质监控数据传输过程,并重新找到数据过程. 这个Downloader 对象的属性和方法模仿XMLHttpRequest(XHR)的一系列的APIs.XHR提供 JavaScript和其他Web浏览器脚本语言来传输和操作通过HTTP来于web Server端的XML数据. 通常你不详细指定Downloader 的URI;但你能指定URIs,并使用URI的配置是最初在安装Silverlight plug-in所指定主机器的HTML页面的地址.Downloader不能被用来跨域下载文件(内容不是来于最初始主机也面的地址). 下面给出一个事列显示怎样create, initialize, and execute 一个下载请求.为一个 被操作者挂上两个事件是(Completed, DownloadProgressChanged),但被操作者没有被指定,还有DownloadFailed也没有被定义.所以你要自己写一个.
// Event handler for initializing and executing a download request. function onMouseLeftButtonUp(sender, eventArgs)
{ 
// Retrieve a reference to the plug-in. var slPlugin = sender.getHost(); // Create a Downloader object. var downloader = slPlugin.createObject("downloader"); // Add DownloadProgressChanged and Completed events. downloader.addEventListener("downloadProgressChanged", onDownloadProgressChanged); downloader.addEventListener("completed", onCompleted); // Initialize the Downloader request. // NOTE: downloader APIs disallow file:\\ scheme // you must run this sample over localhost: or off a server or the following call will fail downloader.open("GET", "promo.png"); // Execute the Downloader request. downloader.send();
} (2):DownloadFailed
当下载请求完成时没有下载内容时触发.
参数:
| 参数名 | 描述 | 类型 |
| downloaderObject | 一个Downloader对象. | Object |
| token | 是一个函数的返回值,能随意的保留如变量.如你想要调用RemoveEventLister去删除这个被操作者,你将需要这个参数 | integer |
| eventhandlerFunction | 在脚本中被定义的你的事件函数名,当使用AddEventListener pararmeter,就不需要提供函数名. | Object |
| sender | 识别调用事件的对象 | Object |
| eventArgs | 参数始终为 null | Object |
DownloadFailed 当下载请求完成时没有下载内容时触发.异步的调用Downloader的Send方法.主要由Status和StatusText的属性来反应HTTP的状态值来确定错误的下载请求.
你还能在脚本中添加一个事件名来添加操作者:
downloaderObject.AddEventListener( " DownloadFailed " , " eventhandlerFunction " ) (3)DownloadProgressChanged
在求情下载期间被出发. 参数:
| 参数名 | 描述 | 类型 |
| downloaderObject | 一个Downloader对象. | Object |
| token | 是一个函数的返回值,能随意的保留如变量.如你想要调用RemoveEventLister去删除这个被操作者,你将需要这个参数 | integer |
| eventhandlerFunction | 在脚本中被定义的你的事件函数名,当使用AddEventListener pararmeter,就不需要提供函数名. | Object |
| sender | 识别调用事件的对象 | Object |
| eventArgs | 参数始终为 null | Object |
DownloadProgressChanged 事件能被使用监控下载进程.DownloadProgressChanged是按照被下载内容总长度的0.05显示,最高可达到1.0.当下载状态改变时都将出发Completed 或DownloadFailed. 你还能在脚本中添加一个事件名来添加操作者:
downloaderObject.AddEventListener( " DownloadProgressChanged " , " eventhandlerFunction " ) // Event handler for updating visual progress indicator function onDownloadProgressChanged(sender, eventArgs) { // Calculate the downloaded percentage. var percentage = Math.floor(sender.downloadProgress * 100); // Update the Rectangle and TextBlock objects of the visual progress indicator. progressText.text = percentage + "%"; progressRectangle.width = percentage * 2;} (4)Completed
在请求下载内容完成时触发. Completed在请求下载内容完成时触发.异步的调用Downloader的Send方法.主要由Status和StatusText的性质来反应HTTP的状态值来确定错误的下载请求. 你还能在脚本中添加一个事件名来添加操作者:
downloaderObject.AddEventListener( " Completed " , " eventhandlerFunction " ) // Event handler for the Completed event. function onCompleted(sender, eventArgs) { // Retrieve downloaded XAML content. var xamlFragment = sender.ResponseText; // Create the objects from the XAML content. var plugin = sender.getHost(); var button = plugin.content.createFromXaml(xamlFragment); // Add downloaded XAML content to the root Canvas of the plug-in. var rootCanvas = sender.findName("rootCanvas"); rootCanvas.children.add(button);}