BoundField 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表在資料繫結控制項中顯示為文字的欄位。
public ref class BoundField : System::Web::UI::WebControls::DataControlFieldpublic class BoundField : System.Web.UI.WebControls.DataControlFieldtype BoundField = class
inherit DataControlFieldPublic Class BoundField
Inherits DataControlField- 繼承
- 衍生
範例
下列程式碼範例示範如何使用 BoundField 物件來顯示 控制項中 GridView 欄位的值。
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>BoundField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:boundfield datafield="CustomerID"
readonly="true"
headertext="Customer ID"/>
<asp:boundfield datafield="CompanyName"
convertemptystringtonull="true"
headertext="Customer Name"/>
<asp:boundfield datafield="Address"
convertemptystringtonull="true"
headertext="Address"/>
<asp:boundfield datafield="City"
convertemptystringtonull="true"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
convertemptystringtonull="true"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
convertemptystringtonull="true"
headertext="Country"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>BoundField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundField Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
autogenerateeditbutton="true"
allowpaging="true"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:boundfield datafield="CustomerID"
readonly="true"
headertext="Customer ID"/>
<asp:boundfield datafield="CompanyName"
convertemptystringtonull="true"
headertext="Customer Name"/>
<asp:boundfield datafield="Address"
convertemptystringtonull="true"
headertext="Address"/>
<asp:boundfield datafield="City"
convertemptystringtonull="true"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
convertemptystringtonull="true"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
convertemptystringtonull="true"
headertext="Country"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
備註
資料 BoundField 繫結控制項會使用 類別 (例如 GridView 和 DetailsView) ，以文字顯示欄位的值。 根據所使用的資料繫結控制項，物件 BoundField 會以不同的方式顯示。 例如， GridView 控制項會將物件顯示為 BoundField 資料行，而 DetailsView 控制項則會將其顯示為數據列。
若要指定要顯示在 物件中的 BoundField 欄位，請將 DataField 屬性設定為功能變數名稱。 將 屬性 true 設定 HtmlEncode 為 來顯示欄位的值之前，可以先以 HTML 編碼。 您可以藉由設定 DataFormatString 屬性，將自訂格式字串套用至欄位的值。
HtmlEncode當 屬性為 true 時，欄位的編碼字串值會用於自訂格式字串中。 根據預設，只有在資料繫結控制項處於唯讀模式時，才會將格式化字串套用至域值。 若要將格式化字串套用至資料繫結控制項處於編輯模式時所顯示的值，請將 ApplyFormatInEditMode 屬性設定為 true 。 如果欄位的值是 Null，您可以藉由設定 NullDisplayText 屬性來顯示自訂標題。 物件 BoundField 也可以藉由將 屬性 true 設定 ConvertEmptyStringToNull 為 ，自動將空字串 (「」「) 域值轉換成 Null 值。
您可以將 屬性設定 Visible 為 false ，以隱藏 BoundField 資料繫結控制項中的 物件。 若要防止欄位的值在編輯模式中修改，請將 ReadOnly 屬性設定為 true 。 在支援插入記錄 (的資料繫結控制項中，例如 DetailsView 控制項) ，您可以將 屬性設定 InsertVisible 為 false 來隱藏 BoundField 物件。 當您想要在插入模式中隱藏自動產生的索引鍵欄位時，通常會這麼做。
您可以自訂 物件的頁首和頁尾區段 BoundField 。 若要在頁首或頁尾區段中顯示標題，請分別設定 HeaderText 或 FooterText 屬性。 您可以藉由設定 HeaderImageUrl 屬性來顯示影像，而不是在標頭區段中顯示文字。 您可以將 屬性設定 ShowHeader 為 false ，以隱藏 物件中的 BoundField 標頭區段。
注意
某些資料繫結控制項 (，例如 GridView 控制項) 只能顯示或隱藏控制項的整個標頭區段。 這些資料繫結控制項不支援 ShowHeader 個別綁定欄位的 屬性。 若要顯示或隱藏資料繫結控制項的整個標頭區段，如果) 可用，請使用 控制項的 ShowHeader 屬性 (。
您也可以藉由設定欄位不同部分的 BoundField 樣式屬性，自訂物件的外觀 (字型色彩、背景色彩等等) 。 下表列出不同的樣式屬性。
| Style 屬性 | 描述 |
|---|---|
| ControlStyle | 物件的子 Web 服務器控制項樣式 BoundField 設定。 |
| FooterStyle | 物件的頁尾區段樣式 BoundField 設定。 |
| HeaderStyle | 物件的標頭區段樣式 BoundField 設定。 |
| ItemStyle | 物件中資料項目的 BoundField 樣式設定。 |
建構函式
| BoundField() |
初始化 BoundField 類別的新執行個體。 |
欄位
| ThisExpression |
此 API 支援此產品基礎結構，但無法直接用於程式碼之中。 代表 "this" 運算式。 |
屬性
| AccessibleHeaderText |
取得或設定在部分控制項中呈現為 |
| ApplyFormatInEditMode |
取得或設定值，表示當包含 DataFormatString 物件的資料繫結控制項處於編輯模式時，是否將 BoundField 屬性指定的格式字串套用至欄位值。 |
| Control |
取得與 DataControlField 物件關聯之資料控制項的參考。 (繼承來源 DataControlField) |
| ControlStyle |
取得 DataControlField 物件內含之任何 Web 伺服器控制項的樣式。 (繼承來源 DataControlField) |
| ConvertEmptyStringToNull |
取得或設定值，表示在資料來源中更新資料欄位後，是否將空字串值 ("") 自動轉換為 null 值。 |
| DataField |
取得或設定要繫結至 BoundField 物件之資料欄位的名稱。 |
| DataFormatString |
取得或設定字串，指定欄位值的顯示格式。 |
| DesignMode |
取得值，指示目前是否在設計階段環境中檢視資料控制項欄位。 (繼承來源 DataControlField) |
| FooterStyle |
取得或設定資料控制項欄位的頁尾樣式。 (繼承來源 DataControlField) |
| FooterText |
取得或設定顯示在資料控制項欄位之頁尾項目中的文字。 (繼承來源 DataControlField) |
| HeaderImageUrl |
取得或設定顯示在資料控制項欄位的標頭項目中之影像的 URL。 (繼承來源 DataControlField) |
| HeaderStyle |
取得或設定資料控制項欄位的標頭樣式。 (繼承來源 DataControlField) |
| HeaderText |
取得或設定顯示在資料控制項標頭中的文字。 |
| HtmlEncode |
取得或設定值，表示在 BoundField 物件中顯示欄位值之前，是否對其進行 HTML 編碼。 |
| HtmlEncodeFormatString |
取得或設定值，這個值表示透過將 DataFormatString 屬性套用至 BoundField 值來建立的文字在顯示時，是否應該經過 HTML 編碼。 |
| InsertVisible |
取得值，指示 DataControlField 物件在其父資料繫結控制項處於插入模式時是否可見。 (繼承來源 DataControlField) |
| IsTrackingViewState |
取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField) |
| ItemStyle |
取得由資料控制項欄位顯示之任何文字基礎內容的樣式。 (繼承來源 DataControlField) |
| NullDisplayText |
取得或設定欄位值為 null 時所顯示的欄位標題。 |
| ReadOnly |
取得或設定值，表示是否可以在編輯模式下修改欄位值。 |
| ShowHeader |
取得或設定值，指示是否呈現資料控制項欄位的標頭項目。 (繼承來源 DataControlField) |
| SortExpression |
取得或設定資料來源控制項用於排序資料的排序運算式。 (繼承來源 DataControlField) |
| SupportsHtmlEncode |
取得值，表示 BoundField 物件是否支援 HTML 編碼。 |
| ValidateRequestMode |
取得或設定值，決定控制項是否驗證用戶端輸入。 |
| ValidateRequestMode |
取得或設定值，這個值會指定控制項是否驗證用戶端輸入。 (繼承來源 DataControlField) |
| ViewState |
取得狀態資訊的字典，允許您在相同頁面的多個要求之間，儲存和還原 DataControlField 物件的檢視狀態。 (繼承來源 DataControlField) |
| Visible |
取得或設定值，指示是否呈現資料控制項欄位。 (繼承來源 DataControlField) |
方法
明確介面實作
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
取得或設定與此 DataControlField 物件相關聯的結構描述。 (繼承來源 DataControlField) |
| IStateManager.IsTrackingViewState |
取得值，指出 DataControlField 物件是否正在將變更儲存到它的檢視狀態。 (繼承來源 DataControlField) |
| IStateManager.LoadViewState(Object) |
將資料控制項欄位還原成先前儲存的檢視狀態。 (繼承來源 DataControlField) |
| IStateManager.SaveViewState() |
儲存自頁面回傳至伺服器以來對 DataControlField 檢視狀態所做的變更。 (繼承來源 DataControlField) |
| IStateManager.TrackViewState() |
會造成 DataControlField 物件追蹤其檢視狀態變更，以將這些變更儲存在控制項的 ViewState 屬性中，並持續存取相同頁面的其他要求。 (繼承來源 DataControlField) |
