FrameworkElement.BaseUri Propriedade

Definição

Namespace:

Windows.UI.Xaml

Obtém um URI (Uniform Resource Identifier) que representa o URI (Uniform Resource Identifier) base para um objeto construído em XAML no tempo de carregamento XAML. Essa propriedade é útil para resolução de URI (Uniform Resource Identifier) em tempo de execução.

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

Uri BaseUri();

public System.Uri BaseUri { get; }

var uri = frameworkElement.baseUri;

Public ReadOnly Property BaseUri As Uri

Valor da propriedade

Uri Uri

O URI (Uniform Resource Identifier) base para um objeto no tempo de carregamento XAML.

Exemplos

Este exemplo usa BaseUri em um manipulador de eventos que redefine uma fonte de imagem para um backup/padrão. BaseUri é usado para a parte "path" de um novo URI (Uniform Resource Identifier) que é usado para uma chamada de construtor BitmapImage , o restante do URI (Uniform Resource Identifier) aponta para um arquivo de imagem que o aplicativo tem em seus recursos. Para ver esse código no contexto, consulte o exemplo 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

Comentários

O analisador XAML pode avaliar referências a recursos com base no contexto do objeto em uma página e, portanto, pode avaliar o que parecem ser caminhos parciais em uma propriedade de URI (Uniform Resource Identifier). Para código em tempo de execução, as regras de definição para os tipos de URI (Uniform Resource Identifier) não permitem caminhos parciais. Em tempo de execução, você pode usar BaseUri do escopo de um objeto que foi criado analisando uma página XAML para obter a parte "path" de um URI (Uniform Resource Identifier) e, em seguida, concluir o URI (Uniform Resource Identifier) com uma referência de recurso específica.

Observações para versões anteriores

Windows 8 Em Windows 8, o URI retornado por BaseUri de partes de estilo ou modelo poderia retornar valores que representavam um padrão de projeto em vez de um valor específico para o arquivo XAML que criou um objeto. O comportamento de BaseUri foi corrigido começando com Windows 8.1. Mas se você se baseou no comportamento anterior do BaseUri e alterou suas composições XAML ou pesquisas de recursos por causa disso, talvez você queira examinar as áreas do código que fazem chamadas BaseUri. Verifique se o URI (Uniform Resource Identifier) combinado usado para localizar recursos ou informações de localização funciona conforme o esperado quando seu aplicativo é recompilado para Windows 8.1. Os aplicativos que foram compilados para Windows 8, mas estão sendo executados no Windows 8.1, continuam a adotar o comportamento do Windows 8.