FrameworkElement.BaseUri Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft einen Uniform Resource Identifier (URI) ab, der den Basis-URI (Uniform Resource Identifier) für ein XAML-erstelltes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist nützlich für die URI-Auflösung (Uniform Resource Identifier) 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 Uniform Resource Identifier (URI) verweist auf eine Bilddatei, die die App in ihren Ressourcen enthält. Informationen zum Anzeigen dieses Codes im Kontext 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);
}

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

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 Uniform Resource Identifier (URI) abzurufen und dann den URI (Uniform Resource Identifier) mit einem bestimmten Ressourcenverweis abzuschließen.

Hinweise zu früheren Versionen

Windows 8 In Windows 8 kann der von BaseUri aus Stil- oder Vorlagenteilen zurückgegebene URI Werte zurückgeben, die einen Projektstandard darstellen und nicht einen Wert, der für die XAML-Datei spezifisch war, die ein Objekt erstellt hat. Das BaseUri-Verhalten wurde ab Windows 8.1 korrigiert. Wenn Sie sich jedoch auf das vorherige Verhalten von BaseUri verlassen und ihre XAML-Kompositionen oder Ressourcensuche geändert haben, sollten Sie die Bereiche Ihres Codes untersuchen, in denen BaseUri-Aufrufe ausgeführt werden. Vergewissern Sie sich, dass der kombinierte Uniform Resource Identifier (URI), den Sie zum Suchen von Ressourcen oder Lokalisierungsinformationen verwenden, wie erwartet funktioniert, wenn Ihre App für Windows 8.1 neu kompiliert wird. Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.