二 Downloader的使用(属性)

---

二 Downloader的使用(属性)

---

属性:

(1)DownloadProgress(Downloader)

---

得到一个下载内容进程相对值.

返回值是个Double型,是0到1之间的数来描述下载内容总合,按百分之几来增加.

调用Downloader的send方法,DownloadProgress性质能检测下载内容的百分数.返回0到1.0之间的数,并为double类型,0表示没有内容被下载,1.0表示所有内容被下载完成.

下载面是DownloadProgress property 在DownloadProgressChanged中的使用.

// 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;
}

---

(2)ResponseText

---

成功的下载请求并得到下载的数据.

返回值是String类型,下载数据.如在HTML中,

你通常只使用这个属性的就是Downloader对象的Completed事件.在这个之外就不能保证ResponseText的值是有效值.

当Downloader对象请求已经完成并成功,ResponseText属性包含一个下载内容的字符串描述.这个字符串能描述XAML的内容,JavaScript内容,或media,如图象.

---

(3)Status

---

得到Downloader对象请求的当前HTTP状态.
value = downloaderObject.Status

返回值为integer,得到HTTP的状态值来描述Downloader对象请求状态.这个属性是read-only,默认值为0;

HTTP状态反应当前Downloader对象的求情状态.详细就用一个Open方法中的一个verb参数来说明.列如,如果这个verb参数是"GET"和结果下载成功,Status的值是200,否则StatusText是"OK";

下面是详细的HTTP status code

Status code	Status text	Description
200	OK	The request completed successfully.
204	No content	The server has not found anything matching the request URI.

因为Downloader下载内容是异步,事件会指出完成或错误要比使用HTTP状态值的在Downloader场景中使用的多.

---

(4)StatusText

---

得到Downloader对象请求的当前HTTP状态.

返回值是一个String类型,这个String符合相应的Status属性的值,这个属性是read-only,默认值是空的字符串.

---

(6)URI

---

得到下在请求的URI.

返回值类型为String,是Downloader对象的Uniform Resource Identifier (URI) 相应值.

当你调用Send方法时,你指定一个URI参数,用来数据从那下载.这个URI属性就是哪个Send方法相应的URI参数.如果你是多个Downloader下载,URI属性是用来区分不同的DownloadProgressChanged或Completed事件.