如何：引用 ASP.NET 母版页的内容 (zz)

原文地址：http://msdn2.microsoft.com/zh-cn/library/xxwa0ff0(VS.80).aspx

ASP.NET 

如何：引用 ASP.NET 母版页的内容 

可以在内容页中编写代码来引用母版页中的属性、方法和控件，但这种引用有一定的限制。对于属性和方法的规则是：如果它们在母版页上被声明为公共成员，则可以引用它们。这包括公共属性和公共方法。在引用母版页上的控件时，没有只能引用公共成员的这种限制。

引用母版页上的公共成员

1. 在内容页中添加 @ MasterType 指令。在该指令中，将 VirtualPath 属性设置为母版页的位置，如下面的示例所示：

   <%@ MasterType virtualpath="~/Masters/Master1.master" %>

   此指令使内容页的 Master 属性被强类型化。

2. 编写代码，将母版页的公共成员用作 Master 属性的一个成员，如本例中，将母版页名为 CompanyName 的公共属性的值赋给内容页上的一个文本框：

引用母版页上的控件

• 使用 FindControl 方法，将 Master 属性的返回值用作命名容器。

  下面的代码示例演示如何使用 FindControl 方法获取对母版页上的两个控件的引用（一个 TextBox 控件和一个 Label 控件）。因为 TextBox 控件处在 ContentPlaceHolder 控件的内部，必须首先获取对 ContentPlaceHolder 的引用，然后使用其 FindControl 方法来定位 TextBox 控件。

  Visual Basic

  复制代码

  Sub Page_Load()
      Dim mpContentPlaceHolder As ContentPlaceHolder
      Dim mpTextBox As TextBox
      mpContentPlaceHolder = _
      CType(Master.FindControl("ContentPlaceHolder1"), _
      ContentPlaceHolder)
      If Not mpContentPlaceHolder Is Nothing Then
      mpTextBox = CType(mpContentPlaceHolder. _
      FindControl("TextBox1"), TextBox)
      If Not mpTextBox Is Nothing Then
      mpTextBox.Text = "TextBox found!"
      End If
      End If
      ' Gets a reference to a Label control not in a 
      ' ContentPlaceHolder
      Dim mpLabel As Label
      mpLabel = CType(Master.FindControl("masterPageLabel"), Label)
      If Not mpLabel Is Nothing Then
      Label1.Text = "Master page label = " + mpLabel.Text
      End If
      End Sub
      

  C#

  复制代码

  void Page_Load()
      {
      // Gets a reference to a TextBox control inside 
      // a ContentPlaceHolder
      ContentPlaceHolder mpContentPlaceHolder;
      TextBox mpTextBox;
      mpContentPlaceHolder =
      (ContentPlaceHolder)Master.FindControl("ContentPlaceHolder1");
      if(mpContentPlaceHolder != null)
      {
      mpTextBox =
      (TextBox) mpContentPlaceHolder.FindControl("TextBox1");
      if(mpTextBox != null)
      {
      mpTextBox.Text = "TextBox found!";
      }
      }
      // Gets a reference to a Label control that not in 
      // a ContentPlaceHolder
      Label mpLabel = (Label) Master.FindControl("masterPageLabel");
      if(mpLabel != null)
      {
      Label1.Text = "Master page label = " + mpLabel.Text;
      }
      }
      

请参见

概念

ASP.NET 母版页概述
以编程方式使用 ASP.NET 母版页

其他资源

以编程方式访问 ASP.NET 控件