Exporter (0) Imprimer
Développer tout

GetResponseText

Silverlight

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Retrieves a specified part of packaged downloaded data.

retval = downloaderObject.GetResponseText(part)

part

string

The name of the specific part of the downloaded content package. part is not an optional parameter. You must specify at least an empty string; otherwise, a syntax error will result.

Managed programming does not use Downloader. See WebClient.

Type: object

The downloaded data. As in HTML, the return value can be examined and is passed as a string in a packet, but ultimately it is interpreted by the property you set with this value.

Silverlight provides the ability to download content as a package, which is a collection of independent files that contain XAML content, media assets, and other application content. When the package is successfully downloaded, you can use methods such as GetResponseText, SetSource, and CreateFromXamlDownloader to selectively retrieve a specific named part of the package.

The part parameter of the GetResponseText method identifies the specific part to retrieve within the downloaded content.

You generally call this method only from the event handler for a Downloader Completed event. Outside this context, there is no guarantee that a GetResponseText return value is valid.

When a Downloader object request is completed, the GetResponseText method returns a representation of the downloaded content as a string value. The return value from GetResponseText can represent XAML content, JavaScript content, or a media asset, such as an image.

If you are not requesting parts of a package and the Downloader request returns only a single asset, you typically would get the ResponseText property instead of GetResponseText. Calling GetResponseText with an empty string returns the same value as ResponseText.

Note Note:

If you are downloading media assets for use by the Source property of Image and MediaElement objects, you should consider using the SetSource (Image) or SetSource (MediaElement) methods instead of setting an object with GetResponseText or ResponseText, and then setting the Source properties. This is a more efficient way to transfer large media assets. Image also has an equivalent SetSource.

The following JavaScript example shows how to use the GetResponseText method to retrieve a specified part from the downloaded content.

function onDownloadCompleted(sender, eventArgs)
{
    // Retrieve the XAML content from the downloaded package file.
    var jacketBrowserXaml = sender.getResponseText("jacketBrowser.xaml");
    // Create the objects from the XAML content.
    var jacketBrowser = plugin.content.createFromXaml(jacketBrowserXaml);

    // Add downloaded XAML content to the root Canvas of the plug-in.
    sender.findName("root").children.insert(0, jacketBrowser);

    // Retrieve a reference to the Image object representing the jacket.
    var jacketImageSlice = sender.findName("jacketSlice");

    // Set the Source property of the Image object to the specific jacket image
    // within the downloaded .zip package file.
    jacketImageSlice.setSource(sender, "rotation01_green.png");
}

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft