Parameter.DefaultValue プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Parameter.DefaultValue プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property DefaultValue As
 String

Visual Basic (使用法)

Dim instance As Parameter
Dim value As String

value = instance.DefaultValue

instance.DefaultValue = value

public string DefaultValue { get;
 set; }

C++

public:
property String^ DefaultValue {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DefaultValue ()

/** @property */
public void set_DefaultValue (String value)

JScript

public function get DefaultValue
 () : String

public function set DefaultValue
 (value : String)

プロパティ値
バインド先の値を解決できない場合や、初期化前の状態に戻す場合に、Parameter の既定値として使用する文字列。

解説

DefaultValue プロパティは、パラメータを値にバインドするシナリオで使用されますが、Parameter オブジェクトが評価されるときには、値は null 参照 (Visual Basic では Nothing) であるか、解決できません。

パラメータの DefaultValue プロパティが変更されると、OnParameterChanged メソッドが呼び出されます。

使用例

ObjectDataSource コントロールを使用して単一のデータレコードを取得し、DetailsView コントロールに表示する方法を次のコード例に示します。ObjectDataSource コントロールは、EmployeeLogic クラスの GetEmployee メソッドを呼び出して、特定の従業員レコードを取得します。GetEmployee メソッドには、従業員 ID パラメータが必要です。この例では、ObjectDataSource コントロールは、SelectParameters コレクション内の QueryStringParameter オブジェクトを使用して、GetEmployee メソッドに ID を渡します。

EmployeeLogic クラスおよび GetEmployee メソッドの実装の例を確認する場合は、ObjectDataSource クラスの概要を参照してください。

Visual Basic

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB"
 Assembly="Samples.AspNet.VB"
 %>
<%@ Page language="vb" %>
<html>
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post"
 runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of
 input from the client.
     Security Note: To validate the value of
 the QueryStringParameter, handle the Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.VB.EmployeeLogic"
 >
          <selectparameters>
            <asp:querystringparameter name="anID"
 querystringfield="empid" defaultvalue="-1"
 />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS"
 Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<html>
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the
 Selecting event. -->

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="anID" querystringfield="empid"
 defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.jsl"
 Assembly="Samples.AspNet.jsl" %>
<%@ Page Language="VJ#" %>
<html>
  <head>
    <title>ObjectDataSource - VJ# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.jsl.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="anID" querystringfield="empid"
 defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>