FrameworkElement.BaseUri property

Gets a Uniform Resource Identifier (URI) that represents the base URI for an XAML-constructed object at XAML load time. This property is useful for URI resolution at run time.

Syntax

public Uri BaseUri { get; }

Property value

Type: System.Uri [.NET] | Windows::Foundation::Uri [C++]

The base URI for an object at XAML load time.

Remarks

The XAML parser can evaluate references to resources based on the context of the object in a page, and can thus evaluate what appear to be partial paths in a URI property. For run-time code, the definition rules for the URI types don't permit partial paths. At run time, you can use BaseUri from the scope of an object that was created by parsing a XAML page in order to get the "path" part of a URI, and then complete the URI with a particular resource reference.

Examples

This example uses BaseUri in an event handler that resets an image source to a backup/default. BaseUri is used for the "path" part of a new URI that is used for a BitmapImage constructor call, the rest of the URI points to an image file that the app has in its resources. To see this code in context, see the CameraCaptureUI sample.

private void Reset_Click(object sender, RoutedEventArgs e)
{
    ResetButton.Visibility = Visibility.Collapsed;
    CapturedPhoto.Source = new BitmapImage(new Uri(this.BaseUri, "Assets/placeholder-sdk.png"));

    // Clear file path in Application Data 
    appSettings.Remove(photoKey);
}

Requirements

See also

FrameworkElement

Build date: 1/31/2013