FrameworkElement.BaseUri Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

Ruft einen Uniform Resource Identifier (URI) ab, der den Basis-URI für ein XAML-erstelltes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist nützlich für die URI-Auflösung zur Laufzeit.

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

Uri BaseUri();

public System.Uri BaseUri { get; }

var uri = frameworkElement.baseUri;

Public ReadOnly Property BaseUri As Uri

Eigenschaftswert

Uri Uri

Der Basis-URI (Uniform Resource Identifier) für ein Objekt zur XAML-Ladezeit.

Beispiele

In diesem Beispiel wird BaseUri in einem Ereignishandler verwendet, der eine Bildquelle auf eine Sicherung/Standard zurücksetzt. BaseUri wird für den "Pfad"-Teil eines neuen URI (Uniform Resource Identifier) verwendet, der für einen BitmapImage-Konstruktoraufruf verwendet wird. Der Rest des URI verweist auf eine Bilddatei, die die App in ihren Ressourcen enthält. Diesen Code im Kontext einer UWP-App finden Sie im CameraCaptureUI-Beispiel.

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

Hinweise

Der XAML-Parser kann Verweise auf Ressourcen basierend auf dem Kontext des Objekts auf einer Seite auswerten und so die scheinbaren partiellen Pfade in einer URI-Eigenschaft (Uniform Resource Identifier) auswerten. Bei Laufzeitcode lassen die Definitionsregeln für die URI-Typen (Uniform Resource Identifier) keine partiellen Pfade zu. Zur Laufzeit können Sie BaseUri aus dem Bereich eines Objekts verwenden, das durch Analysieren einer XAML-Seite erstellt wurde, um den "Pfad"-Teil eines URI abzurufen und dann den URI mit einem bestimmten Ressourcenverweis abzuschließen.