FrameworkElement.BaseUri Eigenschaft

Referenz

Definition

Namespace:: Microsoft.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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.

Gilt für:

Freigeben über