BoundField.NullDisplayText プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フィールド値が null の場合にフィールドに表示するキャプションを取得または設定します。
public:
virtual property System::String ^ NullDisplayText { System::String ^ get(); void set(System::String ^ value); };public virtual string NullDisplayText { get; set; }member this.NullDisplayText : string with get, setPublic Overridable Property NullDisplayText As Stringプロパティ値
フィールド値が null の場合にフィールドに表示するキャプション。 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。
例
次のコード例では、プロパティを使用 NullDisplayText して、null フィールド値に対して表示するカスタム キャプションを指定する方法を示します。
<%@ 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 NullDisplayText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundField NullDisplayText Example</h3>
<asp:gridview id="DiscountsGridView"
datasourceid="DiscountsSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="discounttype"
nulldisplaytext="No Data"
headertext="Discount Type"/>
<asp:boundfield datafield="stor_id"
nulldisplaytext="No Data"
headertext="Store ID"/>
<asp:boundfield datafield="lowqty"
nulldisplaytext="No Data"
headertext="Low Quantity"/>
<asp:boundfield datafield="highqty"
nulldisplaytext="No Data"
headertext="High Quantity"/>
<asp:boundfield datafield="discount"
nulldisplaytext="No Data"
dataformatstring="{0:F4}%"
itemstyle-horizontalalign="Right"
headertext="Discount"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="DiscountsSqlDataSource"
selectcommand="SELECT [discounttype], [stor_id], [lowqty], [highqty], [discount] FROM [discounts]"
connectionstring="<%$ ConnectionStrings:PubsConnectionString%>"
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 NullDisplayText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BoundField NullDisplayText Example</h3>
<asp:gridview id="DiscountsGridView"
datasourceid="DiscountsSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="discounttype"
nulldisplaytext="No Data"
headertext="Discount Type"/>
<asp:boundfield datafield="stor_id"
nulldisplaytext="No Data"
headertext="Store ID"/>
<asp:boundfield datafield="lowqty"
nulldisplaytext="No Data"
headertext="Low Quantity"/>
<asp:boundfield datafield="highqty"
nulldisplaytext="No Data"
headertext="High Quantity"/>
<asp:boundfield datafield="discount"
nulldisplaytext="No Data"
dataformatstring="{0:F4}%"
itemstyle-horizontalalign="Right"
headertext="Discount"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="DiscountsSqlDataSource"
selectcommand="SELECT [discounttype], [stor_id], [lowqty], [highqty], [discount] FROM [discounts]"
connectionstring="<%$ ConnectionStrings:PubsConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
注釈
フィールドの値がデータ ソースに null として格納される場合があります。 プロパティを設定することで、null 値を持つフィールドに表示するカスタム キャプションを NullDisplayText 指定できます。 このプロパティが設定されていない場合、null フィールド値は空の文字列 ("") として表示されます。 データ バインド コントロールでレコードが更新または挿入されるときに、ユーザーがデータ バインド コントロール内のフィールドに対してこのプロパティで指定された値 (空の文字列以外) を入力すると、その値はデータ ソースで自動的に null に変換されます。
注意
空の文字列フィールド値を null 値に変換するには、プロパティtrueを ConvertEmptyStringToNull .