將使用者控制項加入至 [開始] 頁面

發行項
03/24/2017

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

本逐步解說示範如何加入自訂的起始頁 DLL 的參考。範例會新增至方案中，使用者控制項建置使用者控制項，並再建置的組件參考起始頁.xaml 檔案。新的索引標籤裝載使用者控制項，其做為基本的 Web 瀏覽器功能。

您可以使用相同的程序加入任何可以從.xaml 檔案中呼叫的組件。

將 WPF 使用者控制項加入至方案

首先，Windows Presentation Foundation (WPF) 使用者控制項加入起始頁方案。

建立起始頁面使用我們建立在建立自訂起始頁。
在方案總管] 中，以滑鼠右鍵按一下方案，按一下新增，然後按一下 [新的專案。
在左窗格中新的專案對話方塊方塊中，展開 [ Visual Basic或Visual C#節點，然後按一下 [ Windows。在中間窗格中，選取WPF 使用者控制項程式庫。
將控制項WebUserControl然後按一下 [確定。

實作使用者控制項

若要實作 WPF 使用者控制項，建置在 XAML 中的使用者介面 (UI)，然後以 C# 或其他.NET 語言撰寫的程式碼後置事件。

撰寫使用者控制項的 XAML

開啟使用者控制項的 XAML 檔案。在<>>項目，將下列的資料列定義加入至控制項。

<Grid.RowDefinitions>  
    <RowDefinition Height="Auto"/>  
    <RowDefinition Height="*" />  
</Grid.RowDefinitions>

在 mainGrid項目，新增下列新Grid元素，其中包含文字方塊中輸入網站位址和設定新的地址] 按鈕。

<Grid Grid.Row="0">  
    <Grid.ColumnDefinitions>  
        <ColumnDefinition Width="*" />  
        <ColumnDefinition Width="Auto" />  
    </Grid.ColumnDefinitions>  
    <TextBox x:Name="UserSource" Grid.Column="0" />  
    <Button Grid.Column="1" x:Name="SetButton" Content="Set Address" Click="SetButton_Click" />  
</Grid>

將下列的畫面格加入至最上層Grid元素後方Grid包含按鈕和文字方塊項目。

<Frame Grid.Row="1" x:Name="WebFrame" Source="https://www.bing.com" Navigated="WebFrame_Navigated" />

下列範例顯示完整的 XAML 使用者控制項。

<UserControl x:Class="WebUserControl.UserControl1"  
             xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"  
             xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"  
             xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006"   
             xmlns:d="https://schemas.microsoft.com/expression/blend/2008"   
             mc:Ignorable="d"   
             d:DesignHeight="300" d:DesignWidth="300">  
    <Grid>  
        <Grid.RowDefinitions>  
            <RowDefinition Height="Auto"/>  
            <RowDefinition Height="*" />  
        </Grid.RowDefinitions>  
        <Grid Grid.Row="0">  
            <Grid.ColumnDefinitions>  
                <ColumnDefinition Width="*" />  
                <ColumnDefinition Width="Auto" />  
            </Grid.ColumnDefinitions>  
            <TextBox x:Name="UserSource" Grid.Column="0" />  
            <Button Grid.Column="1" x:Name="SetButton" Content="Set Address" Click="SetButton_Click" />  
        </Grid>  
        <Frame Grid.Row="1" x:Name="WebFrame" Source="https://www.bing.com" Navigated="WebFrame_Navigated" />  
    </Grid>  
</UserControl>

撰寫使用者控制項的程式碼後置事件。

在 XAML 設計工具中，按兩下設定位址按鈕加入至控制項。

UserControl1.cs 檔案會在程式碼編輯器中開啟。

填入 SetButton_Click 事件處理常式，如下所示。

private void SetButton_Click(object sender, RoutedEventArgs e)  
{  
    try  
    {  
        this.WebFrame.Source = new Uri(this.UserSource.Text, UriKind.Absolute);  
    }  
    catch (Exception error)  
    {  
        MessageBox.Show(error.Message);  
    }  
}

此程式碼會設定在文字方塊中輸入做為目標的 Web 瀏覽器的網址。如果位址不正確，程式碼擲回錯誤。

您也必須處理 WebFrame_Navigated 事件︰

private void WebFrame_Navigated(object sender, EventArgs e)  
{ }

建置方案。