IComponentConnector Interface

Définition

Espace de noms:

Windows.UI.Xaml.Markup

Fournit une prise en charge de l’infrastructure pour le câblage d’événements et les actions de génération.

public interface class IComponentConnector

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(4135127431, 59109, 18418, 146, 198, 236, 204, 228, 186, 21, 154)]
struct IComponentConnector

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(4135127431, 59109, 18418, 146, 198, 236, 204, 228, 186, 21, 154)]
public interface IComponentConnector

Public Interface IComponentConnector

Attributs

ContractVersionAttribute GuidAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Le code généré par Microsoft Visual Studio pour IComponentConnector qui est parallèle au scénario « button1 » décrit ci-dessus peut ressembler à ce qui suit :

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;
        }
    }

Remarques

Windows 10 Apps compilées par le compilateur XAML pour Windows 10 implémenter IComponentConnector2. Les applications reviennent à IComponentConnector pour la compatibilité si nécessaire.

Sauf si vous étendez considérablement les fonctionnalités d’une infrastructure XAML ou d’outils de conception XAML, vous n’aurez probablement pas besoin de générer ou d’implémenter IComponentConnector. Le reste des remarques ici sont destinées à vous orienter vers l’objectif d’IComponentConnector dans le modèle d’application basé sur l’application et à expliquer le rôle d’IComponentConnector dans le code généré que l’infrastructure Microsoft Visual Studio crée dans le cadre d’un projet XAML classique.

Par défaut, lorsque vous ajoutez une page XAML à un projet d’application UWP dans Microsoft Visual Studio, son BuildAction est Page. Lorsque vous générez le projet, tous les éléments de projet avec cette action de génération sont traités et les fichiers de code qui correspondent au choix du langage de programmation du projet sont générés. Les fichiers de code générés contiennent tous la chaîne .g » dans leur nom et peuvent être observés dans le dossier obj du projet après la compilation. Les fichiers générés implémentent une partie de la définition de classe partielle que le modèle d’application basé sur l’application utilise pour connecter les aspects XAML et code d’une définition d’application. Le processus de génération de classes partielles à partir de XAML est parfois appelé compilation de balisage.

Chaque élément XAML qui a un nom XAML (attribut x:Name ou attribut Name appliqué) ou un gestionnaire d’événements déclaré génère un appel à IComponentConnector.Connect dans le fichier de code généré. Le code d’infrastructure pour les actions de génération XAML définit ensuite les champs qui correspondent aux noms des éléments. Si le câblage d’événements est effectué en XAML, les actions de build attachent les gestionnaires d’événements aux instances créées par XAML. Les champs fournissent le point d’accès que le code d’application et le code d’infrastructure peuvent utiliser pour référencer l’objet créé à la suite de l’analyse du XAML.

Par exemple, s’il existe un élément XAML pour un Button nommé « button1 » dans le fichier XAML et qu’il a un attribut pour l’événement Click qui fait référence à une méthode de gestionnaire nommée, Microsoft Visual Studio génère automatiquement une implémentation de la méthode Connect à partir de l’interface IComponentConnector. Le paramètre connectionId est un jeton d’identificateur permettant de distinguer les appels, et le paramètre cible est la cible à laquelle connecter les événements et les noms.

Méthodes

Connect(Int32, Object)

Joint des événements et des noms au contenu initié par XAML.

Voir aussi

• Vue d’ensemble du langage XAML
• Attribut x:Class