IComponentConnector Interface

Definição

Namespace:

Microsoft.UI.Xaml.Markup

Fornece suporte à infraestrutura para a fiação de eventos e ações de build.

public interface class IComponentConnector

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2906658834, 45201, 20944, 185, 21, 45, 104, 44, 210, 175, 16)]
struct IComponentConnector

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(2906658834, 45201, 20944, 185, 21, 45, 104, 44, 210, 175, 16)]
public interface IComponentConnector

Public Interface IComponentConnector

Atributos

ContractVersionAttribute GuidAttribute

Exemplos

O código gerado pelo Microsoft Visual Studio para IComponentConnector que faz o paralelo do cenário "button1" descrito acima pode ser semelhante ao seguinte:

partial class MainPage : Windows.UI.Xaml.Controls.Page, IComponentConnector
    {
        [System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.Windows.UI.Xaml.Build.Tasks"," 4.0.0.0")]
        [System.Diagnostics.DebuggerNonUserCodeAttribute()]

        public void Connect(int connectionId, object target)
        {
            switch(connectionId)
            {
            case 1:
                #line 21 "..\..\MainPage.xaml"
                ((Windows.UI.Xaml.Controls.Primitives.ButtonBase)(target)).Click += this.button1_Click_1;
                 #line default
                 #line hidden
                break;
            }
            this._contentLoaded = true;
        }
    }

Comentários

A menos que você esteja estendendo substancialmente os recursos de uma estrutura XAML ou ferramentas de design XAML, provavelmente não será necessário gerar ou implementar IComponentConnector. O restante dos comentários aqui destina-se a orientá-lo para a finalidade de IComponentConnector no modelo de aplicativo baseado em aplicativo e explicar a função de IComponentConnector no código gerado que a infraestrutura do Microsoft Visual Studio cria como parte de um projeto XAML típico.

Por padrão, quando você adiciona uma página XAML a um projeto de aplicativo UWP no Microsoft Visual Studio, sua BuildAction é Page. Quando você compila o projeto, todos os itens de projeto com essa ação de build são processados e arquivos de código que correspondem à escolha da linguagem de programação do projeto são gerados. Todos os arquivos de código gerados contêm a cadeia de caracteres ".g" em seu nome e podem ser observados na pasta obj do projeto após a compilação. Os arquivos gerados implementam uma parte da definição de classe parcial que o modelo de aplicativo baseado em aplicativo usa para conectar XAML e aspectos de código de uma definição de aplicativo. O processo de geração de classes parciais de XAML às vezes é chamado de compilação de marcação.

Cada elemento em XAML que tem um nome XAML (atributo x:Name ou atributo Name aplicado) ou um manipulador de eventos declarado gera uma chamada para IComponentConnector.Connect dentro do arquivo de código gerado. O código de infraestrutura para ações de build XAML define campos que correspondem aos nomes nos elementos. Se houver uma fiação de evento feita em XAML, as ações de build anexarão os manipuladores de eventos às instâncias criadas por XAML. Os campos fornecem o ponto de acesso que o código do aplicativo e o código de infraestrutura podem usar para referenciar o objeto que é criado como resultado da análise do XAML.

Por exemplo, se houver um elemento XAML para um Button chamado "button1" no arquivo XAML e ele tiver um atributo para o evento Click que faz referência a um método de manipulador nomeado, o Microsoft Visual Studio gerará automaticamente uma implementação do método Connect da interface IComponentConnector. O parâmetro connectionId é um token de identificador para distinguir chamadas e o parâmetro de destino é o destino para conectar eventos e nomes.

Métodos

Connect(Int32, Object)	Anexa eventos e nomes ao conteúdo iniciado por XAML.
GetBindingConnector(Int32, Object)	Recupera o IComponentConnector para essa conexão.

Confira também

• Visão geral do XAML
• Atributo x:Class