Carregando XAML em tempo de execução em Xamarin.Forms

O Xamarin.Forms.Xaml namespace inclui dois LoadFromXaml métodos de extensão que podem ser usados para carregar e analisar XAML em runtime.

Tela de fundo

Quando uma Xamarin.Forms classe XAML é construída, o LoadFromXaml método é chamado indiretamente. Isso ocorre porque o arquivo code-behind de uma classe XAML chama o método InitializeComponent de seu construtor:

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
}

Quando o Visual Studio cria um projeto que contém um arquivo XAML, ele analisa o arquivo XAML para gerar um arquivo de código C# (por exemplo, MainPage.xaml.g.cs) que contém a definição do InitializeComponent método:

private void InitializeComponent()
{
    global::Xamarin.Forms.Xaml.Extensions.LoadFromXaml(this, typeof(MainPage));
    ...
}

O InitializeComponent método chama o LoadFromXaml método para extrair o arquivo XAML (ou seu binário compilado) da biblioteca do .NET Standard. Após a extração, ele inicializa todos os objetos definidos no arquivo XAML, conecta-os todos juntos em relações pai-filho, anexa manipuladores de eventos definidos no código a eventos definidos no arquivo XAML e define a árvore de objetos resultante como o conteúdo da página.

Carregando XAML em tempo de execução

Os LoadFromXaml métodos são public, e, portanto, podem ser chamados de Xamarin.Forms aplicativos para carregar e analisar XAML em runtime. Isso permite cenários como um aplicativo baixando XAML de um serviço Web, criando a exibição necessária do XAML e exibindo-a no aplicativo.

Aviso

O carregamento do XAML em runtime tem um custo de desempenho significativo e geralmente deve ser evitado.

O exemplo de código a seguir mostra um uso simples:

using Xamarin.Forms.Xaml;
...

string navigationButtonXAML = "<Button Text=\"Navigate\" />";
Button navigationButton = new Button().LoadFromXaml(navigationButtonXAML);
...
_stackLayout.Children.Add(navigationButton);

Neste exemplo, uma instância Button é criada, com seu valor de propriedade Text sendo definido com base no XAML definido no string. Em seguida, o Button é adicionado a um StackLayout que foi definido no XAML para a página.

Observação

Os métodos de extensão LoadFromXaml permitem que um argumento de tipo genérico seja especificado. No entanto, raramente é necessário especificar o argumento de tipo, pois ele será inferido do tipo da instância em que está operando.

O método LoadFromXaml pode ser usado para inflar qualquer XAML, com o exemplo a seguir inflando um ContentPage e navegando até ele:

using Xamarin.Forms.Xaml;
...

// See the sample for the full XAML string
string pageXAML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<ContentPage xmlns=\"http://xamarin.com/schemas/2014/forms\"\nxmlns:x=\"http://schemas.microsoft.com/winfx/2009/xaml\"\nx:Class=\"LoadRuntimeXAML.CatalogItemsPage\"\nTitle=\"Catalog Items\">\n</ContentPage>";

ContentPage page = new ContentPage().LoadFromXaml(pageXAML);
await Navigation.PushAsync(page);

Acessando elementos

Carregar XAML em tempo de execução com o LoadFromXaml método não permite acesso fortemente tipado aos elementos XAML que especificaram nomes de objeto de tempo de execução (usando x:Name). No entanto, esses elementos XAML podem ser recuperados usando o método FindByName e, em seguida, acessados conforme necessário:

// See the sample for the full XAML string
string pageXAML = "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<ContentPage xmlns=\"http://xamarin.com/schemas/2014/forms\"\nxmlns:x=\"http://schemas.microsoft.com/winfx/2009/xaml\"\nx:Class=\"LoadRuntimeXAML.CatalogItemsPage\"\nTitle=\"Catalog Items\">\n<StackLayout>\n<Label x:Name=\"monkeyName\"\n />\n</StackLayout>\n</ContentPage>";
ContentPage page = new ContentPage().LoadFromXaml(pageXAML);

Label monkeyLabel = page.FindByName<Label>("monkeyName");
monkeyLabel.Text = "Seated Monkey";
...

Neste exemplo, o XAML para um ContentPage é inflado. Esse XAML inclui um Label chamado monkeyName, que é recuperado usando o método FindByName, antes que a propriedade Text seja definida.