共用方式為

IComponentConnector 介面

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Markup
編輯

提供事件連接和建置動作的基礎結構支援。

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
屬性
ContractVersionAttribute GuidAttribute

範例

Microsoft Visual Studio 針對平行處理上述 「button1」 案例的 IComponentConnector 產生的程式碼可能如下所示：

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

備註

除非您大幅擴充 XAML 架構或 XAML 設計工具的功能，否則您可能不需要產生或實作 IComponentConnector。 此處的其餘備註旨在將您導向 至應用程式型應用程式模型中 IComponentConnector 的目的，以及說明 Microsoft Visual Studio 基礎結構在一般 XAML 專案中所產生程式碼中 IComponentConnector 的角色。

根據預設，當您在 Microsoft Visual Studio 中將 XAML 頁面新增至 UWP 應用程式專案時，其 BuildAction 是 Page。 當您建置專案時，會處理具有該建置動作的所有專案專案，並產生符合專案程式設計語言選擇的程式碼檔案。 產生的程式碼檔案全都包含其名稱中的字串 「.g」，而且可以在編譯後的專案 obj 資料夾中觀察到。 產生的檔案會實作 應用程式型應用程式模型用來連接應用程式定義之 XAML 和程式碼層面的部分類別定義。 從 XAML 產生部分類別的程式有時稱為 標記編譯。

XAML 中的每個專案，其 XAML 名稱 (x：Name 屬性 或) 套用的 Name 屬性，或宣告的事件處理常式會在產生的程式碼檔案內產生 對 IComponentConnector.Connect 的呼叫。 XAML 建置動作的基礎結構程式碼接著會定義符合專案名稱的欄位。 如果在 XAML 中完成事件連接，建置動作會將事件處理常式附加至 XAML 建立的實例。 欄位會提供存取點，讓應用程式程式碼和基礎結構程式碼都可以用來參考在剖析 XAML 時所建立的物件。

例如，如果 XAML 檔案中有一個名為 「button1」 的 Button 元素，而且它具有參考具名處理常式方法的 Click 事件屬性，Microsoft Visual Studio 就會從 IComponentConnector 介面自動產生 Connect 方法的實作。 connectionId參數是用來辨別呼叫的識別碼權杖，而目標參數則是連接事件和名稱的目標。

方法

Connect(Int32, Object)

將事件和名稱附加至 XAML 起始的內容。
GetBindingConnector(Int32, Object)

擷取此連線的 IComponentConnector。

適用於

另請參閱