BitmapImage.UriSource Property (System.Windows.Media.Imaging)

Switch View

UriSource Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

BitmapImage..::.UriSource Property

Gets or sets the Uri source of the BitmapImage. This is a dependency property.

Namespace: System.Windows.Media.Imaging
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic (Declaration)

Public Property UriSource As Uri

Visual Basic (Usage)

Dim instance As BitmapImage
Dim value As Uri

value = instance.UriSource

instance.UriSource = value

public Uri UriSource { get; set; }

Visual C++

public:
property Uri^ UriSource {
    Uri^ get ();
    void set (Uri^ value);
}

JScript

public function get UriSource () : Uri
public function set UriSource (value : Uri)

XAML Attribute Usage

<object UriSource="Uri" .../>

Property Value

Type: System..::.Uri
The Uri source of the BitmapImage. The default is nullNothingnullptra null reference (Nothing in Visual Basic).

Dependency Property Information

Identifier field	UriSourceProperty
Metadata properties set to true	None

Remarks

If StreamSource and UriSource are both set, the StreamSource value is ignored.

Examples

The following example demonstrates the use the UriSource property in Extensible Application Markup Language (XAML) and code.

XAML

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>

XAML

<!-- Property Tag XAML Syntax -->
<Image Width="200"  Margin="5" Grid.Column="1" Grid.Row="1" >
   <Image.Source>
      <BitmapImage UriSource="sampleImages/bananas.jpg" />
   </Image.Source>
</Image>

Visual Basic

' Create the image element.
Dim simpleImage As New Image()
simpleImage.Width = 200
simpleImage.Margin = New Thickness(5)

' Create source.
Dim bi As New BitmapImage()
' BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit()
bi.UriSource = New Uri("/sampleImages/cherries_larger.jpg", UriKind.RelativeOrAbsolute)
bi.EndInit()
' Set the image source.
simpleImage.Source = bi

// Create the image element.
Image simpleImage = new Image();    
simpleImage.Width = 200;
simpleImage.Margin = new Thickness(5);

// Create source.
BitmapImage bi = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block.
bi.BeginInit();
bi.UriSource = new Uri(@"/sampleImages/cherries_larger.jpg",UriKind.RelativeOrAbsolute);
bi.EndInit();
// Set the image source.
simpleImage.Source = bi;

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

BitmapImage Class

BitmapImage Members

System.Windows.Media.Imaging Namespace

StreamSource