导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

Image.Source 属性

2013/12/13

获取或设置图像的源。

Namespace:  System.Windows.Controls
程序集:  System.Windows(位于 System.Windows.dll 中)
XMLNS for XAML: 未映射到 xmlns。

public ImageSource Source { get; set; }
<Image Source="uri"/>

XAML 值

uri

Source 属性提供的字符串被解释为统一资源标识符 (URI)。这与国际资源标识符 (IRI) 有很大区别。此区别意味着需要对 US-ASCII 以外的用于标识 Source 的字符进行编码。

可以使用相对引用。相对引用是指相对于应用程序的 XAP 文件。

允许跨域 URI,而且允许指定方案,但不允许混合 URI 方案。

格式特定的文件扩展名不需要出现在 URI 命名中,但如果检索的文件未确定是有效的图像格式,将引发运行时异常。

属性值

类型: System.Windows.Media.ImageSource
已绘制图像的源对象。

依赖项属性标识符字段: SourceProperty

说明注意:

Windows Phone 并不支持所有图像格式。有关可以用于 Image 的图像源和格式的类型的信息,请参见 BitmapImage

可以通过指定绝对 URL(例如,http://contoso.com/myPicture.jpg)来设置 Source,也可以指定相对于应用程序的 XAP 文件的 URL。

在 JavaScript API 中,等效的 Source 属性是由一个作为 URI 计算的字符串设置的。在托管 API 中,此属性使用基础 ImageSource 实例(实际上,这通常是一个 BitmapImage,它是一个派生类)。

您可以在 XAML 中设置此属性,但在此情况下,您将属性设置为 URI。XAML 行为取决于基础类型转换,该转换将字符串作为 URI 处理,并调用 BitmapImage(Uri) 构造函数。这样接下来会从该 URI 请求流,并返回图像源对象。

有关可以用于 Image 的图像源和格式的类型的信息,请参见 BitmapImage

如果 XAML 中的初始 Source 属性值未指定有效源,则可能发生 ImageFailed 事件。

下面的示例演示如何创建图像。

<Image Source="myPicture.png" />
Image myImage = new Image();
myImage.Source = new BitmapImage(new Uri("myPicture.jpg", UriKind.RelativeOrAbsolute));
LayoutRoot.Children.Add(myImage);

在本例中,Source 属性用于指定要显示的图像的位置。可以通过指定绝对 URL(例如,http://contoso.com/myPicture.jpg)来设置 Source,也可以指定相对于应用程序的 XAP 文件的 URL。因此,对于前一示例,您需要在 myPicture.png 所在的同一个文件夹中具有 XAP 文件。

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2014 Microsoft