FrameworkElement.BaseUri Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient un URI (Uniform Resource Identifier) qui représente l’URI (Uniform Resource Identifier) de base pour un objet construit en XAML au moment du chargement XAML. Cette propriété est utile pour la résolution d’URI (Uniform Resource Identifier) au moment de l’exécution.

public:
 property Uri ^ BaseUri { Uri ^ get(); };

Uri BaseUri();

public System.Uri BaseUri { get; }

var uri = frameworkElement.baseUri;

Public ReadOnly Property BaseUri As Uri

Valeur de propriété

Uri Uri

URI (Uniform Resource Identifier) de base pour un objet au moment du chargement XAML.

Exemples

Cet exemple utilise BaseUri dans un gestionnaire d’événements qui réinitialise une source d’image à une sauvegarde/par défaut. BaseUri est utilisé pour la partie « chemin » d’un nouvel URI (Uniform Resource Identifier) utilisé pour un appel de constructeur BitmapImage . Le reste de l’URI pointe vers un fichier image que l’application a dans ses ressources. Pour voir ce code en contexte, consultez l’exemple CameraCaptureUI.

void SDKSample::Page::Reset_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
    rootPage->NotifyUser("The photo will be shown here.", NotifyType::StatusMessage); 
    ResetButton->Visibility = Windows::UI::Xaml::Visibility::Collapsed; 
    CapturedPhoto->Source = ref new BitmapImage(ref new Windows::Foundation::Uri(BaseUri->AbsoluteUri, "Assets/placeholder-sdk.png")); 
     // Remove file from Application Data 
    appSettings->Remove("capturedPhoto"); 
}

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

Private Sub Reset_Click(sender As Object, e As RoutedEventArgs)
    ResetButton.Visibility = Visibility.Collapsed
    CapturedPhoto.Source = New BitmapImage(New Uri(Me.BaseUri, "Assets/placeholder-sdk.png"))
    ' Clear file path in Application Data 
    appSettings.Remove(photoKey)
End Sub

Remarques

L’analyseur XAML peut évaluer les références aux ressources en fonction du contexte de l’objet dans une page, et peut ainsi évaluer ce qui semble être des chemins d’accès partiels dans une propriété URI (Uniform Resource Identifier). Pour le code d’exécution, les règles de définition pour les types URI (Uniform Resource Identifier) n’autorisent pas les chemins d’accès partiels. Au moment de l’exécution, vous pouvez utiliser BaseUri à partir de l’étendue d’un objet créé en analysant une page XAML afin d’obtenir la partie « chemin » d’un URI (Uniform Resource Identifier), puis compléter l’URI (Uniform Resource Identifier) avec une référence de ressource particulière.

Remarques pour les versions précédentes

Windows 8 Dans Windows 8, l’URI retourné par BaseUri à partir de parties de style ou de modèle peut retourner des valeurs qui représentent une valeur par défaut de projet plutôt qu’une valeur spécifique pour le fichier XAML qui a créé un objet. Le comportement de BaseUri a été corrigé à partir de Windows 8.1. Toutefois, si vous vous êtes basé sur le comportement précédent de BaseUri et que vous avez modifié vos compositions XAML ou vos recherches de ressources en raison de cela, vous pouvez examiner les zones de votre code qui effectuent des appels BaseUri. Vérifiez que l’URI (Uniform Resource Identifier) combiné que vous utilisez pour rechercher des ressources ou des informations de localisation fonctionne comme prévu lorsque votre application est recompilée pour Windows 8.1. Les applications qui ont été compilées pour Windows 8, mais qui sont exécutées dans Windows 8.1, continuent d’appliquer le comportement Windows 8.