Parameter クラス
アセンブリ: System.Web (system.web.dll 内)
構文
解説
Parameter クラスは、ASP.NET データ ソース コントロールがデータの選択、フィルタ処理、変更に使用するパラメータ化された SQL クエリ、フィルタ式、またはビジネス オブジェクト メソッド呼び出しのパラメータを表します。Parameter オブジェクトは、ParameterCollection オブジェクトに格納されます。Parameter オブジェクトは実行時に評価され、それらのオブジェクトが表す変数の値をデータ ソース コントロールで使用するメソッドにバインドしてデータとやり取りします。
ControlParameter、CookieParameter、SessionParameter、ProfileParameter、QueryStringParameter など、ASP.NET に提供されるパラメータ クラスは、Web ベースのデータ アプリケーションをビルドするデータ ソース コントロールおよびデータ バインド コントロールで使用します。これらのクラスはデータ ソース コントロールで使用され、Web アプリケーション内の特定の種類の値を、SQL クエリ文字列やビジネス オブジェクト メソッドのパラメータなどに含まれるプレースホルダにバインドします。たとえば、ControlParameter クラスは Web サーバー コントロールのパブリック プロパティをバインドするために使用され、SessionParameter クラスはユーザー セッションの値をバインドするために使用されます。また、QueryStringParameter クラスと CookieParameter クラスは、HttpRequest クラスの値にバインドするために使用されます。独自のカスタム パラメータ型を実装する場合は、基本 Parameter クラスを拡張します。
Parameter オブジェクトは非常に簡単なオブジェクトです。このオブジェクトには、Name プロパティと Type プロパティがあります。このオブジェクトは、宣言によって表すことができ、複数の HTTP 要求にわたり状態を追跡できます。パラメータが値にバインドされたときのために、すべてのパラメータは DefaultValue プロパティをサポートしていますが、この値は実行時に null 参照 (Visual Basic では Nothing) と評価されます。
データ ソース コントロールで Parameter オブジェクトのコレクションを使用する場合、コレクション内でのオブジェクトの順序が重要となります。パラメータが使用されるしくみの詳細については、「SqlDataSource コントロールにおけるパラメータの使用」および「ObjectDataSource コントロールにおけるパラメータの使用」を参照してください。
宣言シナリオで、Parameter オブジェクトを使用して、ListBox コントロールに表示されたデータを DropDownList コントロールの選択された値にバインドする方法を次のコード例に示します。ControlParameter オブジェクトは、フォームの SqlDataSource コントロールの SelectParameters コレクションに追加され、SelectCommand プロパティの "@Title" プレースホルダ テキストに対応します。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <body> <form runat="server"> <p><asp:dropdownlist id="DropDownList1" runat="server" autopostback="True"> <asp:listitem selected>Sales Representative</asp:listitem> <asp:listitem>Sales Manager</asp:listitem> <asp:listitem>Vice President, Sales</asp:listitem> </asp:dropdownlist></p> <asp:sqldatasource id="SqlDataSource1" runat="server" connectionstring="<%$ ConnectionStrings:MyNorthwind%>" selectcommand="SELECT LastName FROM Employees WHERE Title = @Title"> <selectparameters> <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/> </selectparameters> </asp:sqldatasource> <p><asp:listbox id="ListBox1" runat="server" datasourceid="SqlDataSource1" datatextfield="LastName"> </asp:listbox></p> </form> </body> </html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <body> <form runat="server"> <p><asp:dropdownlist id="DropDownList1" runat="server" autopostback="True"> <asp:listitem selected>Sales Representative</asp:listitem> <asp:listitem>Sales Manager</asp:listitem> <asp:listitem>Vice President, Sales</asp:listitem> </asp:dropdownlist></p> <asp:sqldatasource id="SqlDataSource1" runat="server" connectionstring="<%$ ConnectionStrings:MyNorthwind%>" selectcommand="SELECT LastName FROM Employees WHERE Title = @Title"> <selectparameters> <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/> </selectparameters> </asp:sqldatasource> <p><asp:listbox id="ListBox1" runat="server" datasourceid="SqlDataSource1" datatextfield="LastName"> </asp:listbox></p> </form> </body> </html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <HTML> <BODY> <FORM runat="server"> <p><asp:DropDownList id="DropDownList1" runat="server" AutoPostBack="True"> <asp:ListItem Selected>Sales Representative</asp:ListItem> <asp:ListItem>Sales Manager</asp:ListItem> <asp:ListItem>Vice President, Sales</asp:ListItem> </asp:DropDownList></p> <asp:SqlDataSource id="SqlDataSource1" runat="server" ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;" SelectCommand="SELECT LastName FROM Employees WHERE Title = @Title"> <SelectParameters> <asp:ControlParameter Name="Title" ControlId="DropDownList1" PropertyName="SelectedValue"/> </SelectParameters> </asp:SqlDataSource> <p><asp:ListBox id="ListBox1" runat="server" DataSourceID="SqlDataSource1" DataTextField="LastName"> </asp:ListBox></p> </FORM> </BODY> </HTML>
プログラム シナリオで、Parameter オブジェクトを使用して、DataGrid コントロールに表示されたデータを DropDownList コントロールの選択された値にバインドするコード例を次に示します。ページが最初に読み込まれたときには、DropDownList コントロールの値は選択されていないため、Parameter オブジェクトの DefaultValue プロパティが使用されます。
<%@ Page Language="VB" AutoEventWireup="false" CodeFile="param1avb.aspx.vb" Inherits="param1avb_aspx" %> <html > <body> <form id="form1" runat="server"> <div> <asp:DropDownList runat="server" AutoPostBack="True" id="DropDownList1"> <asp:ListItem Value="USA">USA</asp:ListItem> <asp:ListItem Value="UK">UK</asp:ListItem> </asp:DropDownList> <asp:DataGrid runat="server" id="DataGrid1" /> </div> </form> </body> </html>
<%@ Page Language="C#" CodeFile="param1acs.aspx.cs" Inherits="param1acs_aspx" %> <html > <body> <form id="form1" runat="server"> <div> <asp:DropDownList runat="server" AutoPostBack="True" id="DropDownList1"> <asp:ListItem Value="USA">USA</asp:ListItem> <asp:ListItem Value="UK">UK</asp:ListItem> </asp:DropDownList> <asp:DataGrid runat="server" id="DataGrid1" /> </div> </form> </body> </html>
<%@ Page Language="VJ#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> private void Page_Load(Object sender, System.EventArgs e) { SqlDataSource sqlSource = new SqlDataSource("Data Source=localhost;" + "Integrated Security=SSPI;Initial Catalog=Northwind;", "SELECT FirstName, LastName FROM Employees WHERE Country = @country;"); ControlParameter country = new ControlParameter(); country.set_Name("country"); country.set_Type(System.TypeCode.String); country.set_ControlID("DropDownList1"); country.set_PropertyName("SelectedValue"); // If the DefaultValue is not set, the DataGrid does not // display anything on the first page load. This is because // on the first page load, the DropDownList has no // selected item, and the ControlParameter evaluates to // String.Empty. country.set_DefaultValue("USA"); sqlSource.get_SelectParameters().Add(country); // Add the SqlDataSource to the page controls collection. get_Page().get_Controls().Add(sqlSource); DataGrid1.set_DataSource(sqlSource); DataGrid1.DataBind(); } //Page_Load </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:DropDownList runat="server" AutoPostBack="True" id="DropDownList1"> <asp:ListItem Value="USA">USA</asp:ListItem> <asp:ListItem Value="UK">UK</asp:ListItem> </asp:DropDownList> <asp:DataGrid runat="server" id="DataGrid1" /> </FORM> </BODY> </HTML>
次の分離コード モジュールは、前の Web フォーム ページで使用されます。
Partial Class param1avb_aspx Inherits System.Web.UI.Page Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Dim sqlSource As SqlDataSource sqlSource = New SqlDataSource(ConfigurationManager.ConnectionStrings("MyNorthwind").ConnectionString, "SELECT FirstName, LastName FROM Employees WHERE Country = @country;") Dim country As New ControlParameter() country.Name = "country" country.Type = TypeCode.String country.ControlID = "DropDownList1" country.PropertyName = "SelectedValue" ' If the DefaultValue is not set, the DataGrid does not ' display anything on the first page load. This is because ' on the first page load, the DropDownList has no ' selected item, and the ControlParameter evaluates to ' String.Empty. country.DefaultValue = "USA" sqlSource.SelectParameters.Add(country) ' Add the SqlDataSource to the page controls collection. Page.Controls.Add(sqlSource) DataGrid1.DataSource = sqlSource DataGrid1.DataBind() End Sub 'Page_Load End Class
public partial class param1acs_aspx : System.Web.UI.Page { private void Page_Load(object sender, System.EventArgs e) { SqlDataSource sqlSource = new SqlDataSource( ConfigurationManager.ConnectionStrings["MyNorthwind"].ConnectionString , "SELECT FirstName, LastName FROM Employees WHERE Country = @country;"); ControlParameter country = new ControlParameter(); country.Name = "country"; country.Type = TypeCode.String; country.ControlID = "DropDownList1"; country.PropertyName = "SelectedValue"; // If the DefaultValue is not set, the DataGrid does not // display anything on the first page load. This is because // on the first page load, the DropDownList has no // selected item, and the ControlParameter evaluates to // String.Empty. country.DefaultValue = "USA"; sqlSource.SelectParameters.Add(country); // Add the SqlDataSource to the page controls collection. Page.Controls.Add(sqlSource); DataGrid1.DataSource = sqlSource; DataGrid1.DataBind(); } }
Parameter クラスを拡張して、データ バインディング シナリオでデータ ソース コントロールと他のコントロールで使用できる新しいパラメータ型を作成する方法を次のコード例に示します。データ ソース コントロールは、StaticParameter パラメータを使用して、Web フォーム ページ上で宣言されたオブジェクトの値 (通常は文字列) にバインドできます。
Imports System Imports System.ComponentModel Imports System.Security.Permissions Imports System.Web Imports System.Web.UI Imports System.Web.UI.WebControls Namespace Samples.AspNet <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _ Public Class StaticParameter Inherits Parameter Public Sub New() End Sub ' The StaticParameter(string, object) constructor ' initializes the DataValue property and calls the ' Parameter(string) constructor to initialize the Name property. Public Sub New(name As String, value As Object) MyBase.New(name) DataValue = value End Sub ' The StaticParameter(string, TypeCode, object) constructor ' initializes the DataValue property and calls the ' Parameter(string, TypeCode) constructor to initialize the Name and ' Type properties. Public Sub New(name As String, type As TypeCode, value As Object) MyBase.New(name, type) DataValue = value End Sub ' The StaticParameter copy constructor is provided to ensure that ' the state contained in the DataValue property is copied to new ' instances of the class. Protected Sub New(original As StaticParameter) MyBase.New(original) DataValue = original.DataValue End Sub ' The Clone method is overridden to call the ' StaticParameter copy constructor, so that the data in ' the DataValue property is correctly transferred to the ' new instance of the StaticParameter. Protected Overrides Function Clone() As Parameter Return New StaticParameter(Me) End Function ' The DataValue can be any arbitrary object and is stored in ViewState. Public Property DataValue() As Object Get Return ViewState("Value") End Get Set ViewState("Value") = value End Set End Property ' The Value property is a type safe convenience property ' used when the StaticParameter represents string data. ' It gets the string value of the DataValue property, and ' sets the DataValue property directly. Public Property Value() As String Get Dim o As Object = DataValue If o Is Nothing OrElse Not TypeOf o Is String Then Return String.Empty End If Return CStr(o) End Get Set DataValue = value OnParameterChanged() End Set End Property ' The Evaluate method is overridden to return the ' DataValue property instead of the DefaultValue. Protected Overrides Function Evaluate(context As HttpContext, control As Control) As Object If context Is Nothing Then Return Nothing Else Return DataValue End If End Function End Class ' StaticParameter End Namespace ' Samples.AspNet
namespace Samples.AspNet { using System; using System.ComponentModel; using System.Security.Permissions; using System.Web; using System.Web.UI; using System.Web.UI.WebControls; [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)] public class StaticParameter : Parameter { public StaticParameter() { } // The StaticParameter(string, object) constructor // initializes the DataValue property and calls the // Parameter(string) constructor to initialize the Name property. public StaticParameter(string name, object value) : base(name) { DataValue = value; } // The StaticParameter(string, TypeCode, object) constructor // initializes the DataValue property and calls the // Parameter(string, TypeCode) constructor to initialize the Name and // Type properties. public StaticParameter(string name, TypeCode type, object value) : base(name, type) { DataValue = value; } // The StaticParameter copy constructor is provided to ensure that // the state contained in the DataValue property is copied to new // instances of the class. protected StaticParameter(StaticParameter original) : base(original) { DataValue = original.DataValue; } // The Clone method is overridden to call the // StaticParameter copy constructor, so that the data in // the DataValue property is correctly transferred to the // new instance of the StaticParameter. protected override Parameter Clone() { return new StaticParameter(this); } // The DataValue can be any arbitrary object and is stored in ViewState. public object DataValue { get { return ViewState["Value"]; } set { ViewState["Value"] = value; } } // The Value property is a type safe convenience property // used when the StaticParameter represents string data. // It gets the string value of the DataValue property, and // sets the DataValue property directly. public string Value { get { object o = DataValue; if (o == null || !(o is string)) return String.Empty; return (string)o; } set { DataValue = value; OnParameterChanged(); } } // The Evaluate method is overridden to return the // DataValue property instead of the DefaultValue. protected override object Evaluate(HttpContext context, Control control) { if (context.Request == null) return null; return DataValue; } } }
package Samples.AspNet ; import System.* ; import System.ComponentModel.* ; import System.Web.UI.* ; import System.Web.UI.WebControls.* ; public class StaticParameter extends Parameter { public StaticParameter() { } //StaticParameter // The StaticParameter(string, object) constructor // initializes the DataValue property and calls the // Parameter(string) constructor to initialize the Name property. public StaticParameter(String name, Object value) { super(name); set_DataValue(value); } //StaticParameter // The StaticParameter(string, TypeCode, object) constructor // initializes the DataValue property and calls the // Parameter(string, TypeCode) constructor to initialize the Name and // Type properties. public StaticParameter(String name, TypeCode type, Object value) { super(name, type); set_DataValue(value); } //StaticParameter // The StaticParameter copy constructor is provided to ensure that // the state contained in the DataValue property is copied to new // instances of the class. protected StaticParameter(StaticParameter original) { super(original); set_DataValue(original.get_DataValue()); } //StaticParameter // The Clone method is overridden to call the // StaticParameter copy constructor, so that the data in // the DataValue property is correctly transferred to the // new instance of the StaticParameter. protected Parameter Clone() { return new StaticParameter(this); } //Clone // The DataValue can be any arbitrary object and is stored in ViewState. /** @property */ public Object get_DataValue() { return get_ViewState().get_Item("Value"); } //get_DataValue /** @property */ public void set_DataValue(Object value) { get_ViewState().set_Item("Value", value); } //set_DataValue // The Value property is a type safe convenience property // used when the StaticParameter represents string data. // It gets the string value of the DataValue property, and // sets the DataValue property directly. /** @property */ public String get_Value() { Object o = get_DataValue(); if (o == null || !(o instanceof String)) { return String.Empty; } return (String)(o); } //get_Value /** @property */ public void set_Value(String value) { set_DataValue(value); OnParameterChanged(); } //set_Value // The Evaluate method is overridden to return the // DataValue property instead of the DefaultValue. protected Object Evaluate(Control control) { return get_DataValue(); } //Evaluate } //StaticParameter
スレッド セーフ
プラットフォーム
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Parameter コンストラクタ ()
アセンブリ: System.Web (system.web.dll 内)
構文
解説
Parameter コンストラクタで作成された Parameter オブジェクトは、すべてのプロパティの既定値を使用して初期化されます。Name プロパティは String.Empty に、Type プロパティは TypeCode.Object に、Direction プロパティは Input に、DefaultValue プロパティは null 参照 (Visual Basic では Nothing) にそれぞれ初期化されます。
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Parameter コンストラクタ (Parameter)
アセンブリ: System.Web (system.web.dll 内)
構文
解説
Parameter(Parameter) コンストラクタは、Parameter インスタンスのクローンを作成するための protected コピー コンストラクタです。Name、Type、DefaultValue、Direction、ConvertEmptyStringToNull の各プロパティの値は、すべて新しいインスタンスに転送されます。
Parameter クラスを拡張したクラスから Parameter(Parameter) コンストラクタを呼び出して、クラスにオブジェクトの適切なクローン動作を実装する方法を次のコード例に示します。このコード例は Parameter クラスの概要で取り上げているコード例の一部分です。
' The StaticParameter copy constructor is provided to ensure that ' the state contained in the DataValue property is copied to new ' instances of the class. Protected Sub New(original As StaticParameter) MyBase.New(original) DataValue = original.DataValue End Sub ' The Clone method is overridden to call the ' StaticParameter copy constructor, so that the data in ' the DataValue property is correctly transferred to the ' new instance of the StaticParameter. Protected Overrides Function Clone() As Parameter Return New StaticParameter(Me) End Function
// The StaticParameter copy constructor is provided to ensure that // the state contained in the DataValue property is copied to new // instances of the class. protected StaticParameter(StaticParameter original) : base(original) { DataValue = original.DataValue; } // The Clone method is overridden to call the // StaticParameter copy constructor, so that the data in // the DataValue property is correctly transferred to the // new instance of the StaticParameter. protected override Parameter Clone() { return new StaticParameter(this); }
// The StaticParameter copy constructor is provided to ensure that // the state contained in the DataValue property is copied to new // instances of the class. protected StaticParameter(StaticParameter original) { super(original); set_DataValue(original.get_DataValue()); } //StaticParameter // The Clone method is overridden to call the // StaticParameter copy constructor, so that the data in // the DataValue property is correctly transferred to the // new instance of the StaticParameter. protected Parameter Clone() { return new StaticParameter(this); } //Clone
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Parameter コンストラクタ (String, TypeCode, String)
アセンブリ: System.Web (system.web.dll 内)
構文
Dim name As String Dim type As TypeCode Dim defaultValue As String Dim instance As New Parameter(name, type, defaultValue)
Parameter(String,TypeCode,String) コンストラクタで作成された Parameter オブジェクトは、指定した name パラメータと type パラメータを使用して初期化され、DefaultValue プロパティ値が割り当てられます。Direction プロパティは Input に初期化されます。
Parameter(String,TypeCode,String) コンストラクタを使用して、Update メソッドを呼び出す前に、AccessDataSource コントロールの UpdateParameters コレクションに更新パラメータ オブジェクトを追加する方法を次のコード例に示します。
<SCRIPT runat="server"> Private Sub UpdateRecords(source As Object, e As EventArgs) ' This method is an example of batch updating using a ' data source control. The method iterates through the rows ' of the GridView, extracts each CheckBox from the row and, if ' the CheckBox is checked, updates data by calling the Update ' method of the data source control, adding required parameters ' to the UpdateParameters collection. Dim cb As CheckBox Dim row As GridViewRow For Each row In GridView1.Rows cb = CType(row.Cells(0).Controls(1), CheckBox) If cb.Checked Then Dim oid As String oid = CType(row.Cells(1).Text, String) Dim param1 As New Parameter("date", TypeCode.DateTime, DateTime.Now.ToString()) MyAccessDataSource.UpdateParameters.Add(param1) Dim param2 As New Parameter("orderid", TypeCode.String, oid) MyAccessDataSource.UpdateParameters.Add(param2) MyAccessDataSource.Update() MyAccessDataSource.UpdateParameters.Clear() End If Next End Sub ' UpdateRecords </SCRIPT>
<SCRIPT runat="server"> private void UpdateRecords(Object source, EventArgs e) { // This method is an example of batch updating using a // data source control. The method iterates through the rows // of the GridView, extracts each CheckBox from the row and, if // the CheckBox is checked, updates data by calling the Update // method of the data source control, adding required parameters // to the UpdateParameters collection. CheckBox cb; foreach(GridViewRow row in this.GridView1.Rows) { cb = (CheckBox) row.Cells[0].Controls[1]; if(cb.Checked) { string oid = (string) row.Cells[1].Text; MyAccessDataSource.UpdateParameters.Add(new Parameter("date" ,TypeCode.DateTime,DateTime.Now.ToString())); MyAccessDataSource.UpdateParameters.Add(new Parameter("orderid" ,TypeCode.String,oid)); MyAccessDataSource.Update(); MyAccessDataSource.UpdateParameters.Clear(); } } } </SCRIPT>
<SCRIPT runat="server"> private void UpdateRecords(Object source, System.EventArgs e) { // This method is an example of batch updating using a // data source control. The method iterates through the rows // of the GridView, extracts each CheckBox from the row and, if // the CheckBox is checked, updates data by calling the Update // method of the data source control, adding required parameters // to the UpdateParameters collection. CheckBox cb; for (int iCtr = 0; iCtr < this.GridView1.get_Rows().get_Count(); iCtr++) { GridViewRow row = this.GridView1.get_Rows().get_Item(iCtr); cb = (CheckBox)row.get_Cells().get_Item(0).get_Controls().get_Item(1); if (cb.get_Checked()) { String oid = (String)(row.get_Cells().get_Item(1).get_Text()); MyAccessDataSource.get_UpdateParameters().Add(new Parameter( "date", System.TypeCode.DateTime, System.DateTime.get_Now().ToString())); MyAccessDataSource.get_UpdateParameters().Add(new Parameter( "orderid", System.TypeCode.String, oid)); MyAccessDataSource.Update(); MyAccessDataSource.get_UpdateParameters().Clear(); } } } //UpdateRecords </SCRIPT>
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Parameter コンストラクタ (String, TypeCode)
アセンブリ: System.Web (system.web.dll 内)
構文
解説
Parameter(String,TypeCode) コンストラクタで作成された Parameter オブジェクトは、指定した name パラメータ、type パラメータ、および他のプロパティの既定値を使用して初期化されます。Direction プロパティは Input に初期化され、DefaultValue プロパティは null 参照 (Visual Basic では Nothing) に初期化されます。
Parameter クラスを拡張したクラスから Parameter(String,TypeCode) コンストラクタを呼び出して、インスタンスの Name プロパティと Type プロパティを初期化する方法を次のコード例に示します。このコード例は、Parameter クラスの概要で取り上げているコード例の一部分です。
' The StaticParameter(string, TypeCode, object) constructor ' initializes the DataValue property and calls the ' Parameter(string, TypeCode) constructor to initialize the Name and ' Type properties. Public Sub New(name As String, type As TypeCode, value As Object) MyBase.New(name, type) DataValue = value End Sub
// The StaticParameter(string, TypeCode, object) constructor // initializes the DataValue property and calls the // Parameter(string, TypeCode) constructor to initialize the Name and // Type properties. public StaticParameter(string name, TypeCode type, object value) : base(name, type) { DataValue = value; }
// The StaticParameter(string, TypeCode, object) constructor // initializes the DataValue property and calls the // Parameter(string, TypeCode) constructor to initialize the Name and // Type properties. public StaticParameter(String name, TypeCode type, Object value) { super(name, type); set_DataValue(value); } //StaticParameter
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Parameter コンストラクタ
オーバーロードの一覧
名前 | 説明 |
---|---|
Parameter () | Parameter クラスの新しい既定のインスタンスを初期化します。 |
Parameter (Parameter) | 指定した元のインスタンスの値を使用して、Parameter クラスの新しいインスタンスを初期化します。 |
Parameter (String) | 名前を指定して、Parameter クラスの新しいインスタンスを初期化します。 |
Parameter (String, TypeCode) | 名前と型を指定して、Parameter クラスの新しいインスタンスを初期化します。 |
Parameter (String, TypeCode, String) | DefaultValue プロパティに指定した名前、型、文字列を使用して、Parameter クラスの新しいインスタンスを初期化します。 |
Parameter コンストラクタ (String)
アセンブリ: System.Web (system.web.dll 内)
構文
解説
Parameter(String) コンストラクタで作成された Parameter オブジェクトは、指定した name と他のプロパティの既定値を使用して初期化されます。Type プロパティは TypeCode.Object に、Direction プロパティは Input に、DefaultValue プロパティは null 参照 (Visual Basic では Nothing) にそれぞれ初期化されます。
Parameter クラスを拡張したクラスから Parameter(String) コンストラクタを呼び出して、インスタンスの Name プロパティを初期化する方法を次のコード例に示します。このコード例は Parameter クラスの概要で取り上げているコード例の一部分です。
' The StaticParameter(string, object) constructor ' initializes the DataValue property and calls the ' Parameter(string) constructor to initialize the Name property. Public Sub New(name As String, value As Object) MyBase.New(name) DataValue = value End Sub
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
参照
Parameter プロパティ
パブリック プロパティ
名前 | 説明 | |
---|---|---|
ConvertEmptyStringToNull | Parameter オブジェクトのバインド先の値が String.Empty の場合に、その値を null 参照 (Visual Basic では Nothing) に変換する必要があるかどうかを示す値を取得または設定します。 | |
DefaultValue | パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。 | |
Direction | Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。 | |
Name | パラメータの名前を取得または設定します。 | |
Size | パラメータのサイズを取得または設定します。 | |
Type | パラメータの型を取得または設定します。 |
名前 | 説明 | |
---|---|---|
IsTrackingViewState | Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 | |
ViewState | 同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 |
名前 | 説明 | |
---|---|---|
System.Web.UI.IStateManager.IsTrackingViewState | Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 |
関連項目
Parameter クラスSystem.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
FormParameter クラス
QueryStringParameter
SessionParameter
ParameterCollection
DataSourceControl
その他の技術情報
データ ソース コントロールとパラメータの使用Parameter メソッド
パブリック メソッド
名前 | 説明 | |
---|---|---|
Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) | |
GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) | |
GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) | |
ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) | |
ToString | オーバーライドされます。 このインスタンスの値を、それと等価の文字列形式に変換します。 |
名前 | 説明 | |
---|---|---|
Clone | 現在の Parameter インスタンスの複製を返します。 | |
Evaluate | Parameter オブジェクトの値を更新して返します。 | |
Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) | |
LoadViewState | データ ソース ビューの、以前保存したビューステートを復元します。 | |
MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) | |
OnParameterChanged | Parameter オブジェクトを格納する ParameterCollection コレクションの OnParametersChanged メソッドを呼び出します。 | |
SaveViewState | ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 | |
SetDirty | Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 | |
TrackViewState | Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 |
名前 | 説明 | |
---|---|---|
System.ICloneable.Clone | 現在の Parameter インスタンスの複製を返します。 | |
System.Web.UI.IStateManager.LoadViewState | データ ソース ビューの、以前保存したビューステートを復元します。 | |
System.Web.UI.IStateManager.SaveViewState | ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 | |
System.Web.UI.IStateManager.TrackViewState | Parameter オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 |
関連項目
Parameter クラスSystem.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
FormParameter クラス
QueryStringParameter
SessionParameter
ParameterCollection
DataSourceControl
その他の技術情報
データ ソース コントロールとパラメータの使用Parameter メンバ
アプリケーション変数、ユーザー ID とユーザー選択、および他のデータにバインドするためにデータ ソース コントロールで使用する機構を提供します。ASP.NET のすべてのパラメータ型の基本クラスとして機能します。
Parameter データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタ
プロテクト コンストラクタ
パブリック プロパティ
名前 | 説明 | |
---|---|---|
ConvertEmptyStringToNull | Parameter オブジェクトのバインド先の値が String.Empty の場合に、その値を null 参照 (Visual Basic では Nothing) に変換する必要があるかどうかを示す値を取得または設定します。 | |
DefaultValue | パラメータの既定値を指定します。Evaluate メソッドの呼び出し時に、パラメータはこの値にバインドされ、初期化前の状態に戻されます。 | |
Direction | Parameter オブジェクトを使用して値をコントロールにバインドするかどうか、またはそのコントロールを使用して値を変更できるかどうかを示します。 | |
Name | パラメータの名前を取得または設定します。 | |
Size | パラメータのサイズを取得または設定します。 | |
Type | パラメータの型を取得または設定します。 |
名前 | 説明 | |
---|---|---|
IsTrackingViewState | Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 | |
ViewState | 同一のページに対する複数の要求にわたって、Parameter オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 |
名前 | 説明 | |
---|---|---|
Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) | |
GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) | |
GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) | |
ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) | |
ToString | オーバーライドされます。 このインスタンスの値を、それと等価の文字列形式に変換します。 |
名前 | 説明 | |
---|---|---|
Clone | 現在の Parameter インスタンスの複製を返します。 | |
Evaluate | Parameter オブジェクトの値を更新して返します。 | |
Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) | |
LoadViewState | データ ソース ビューの、以前保存したビューステートを復元します。 | |
MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) | |
OnParameterChanged | Parameter オブジェクトを格納する ParameterCollection コレクションの OnParametersChanged メソッドを呼び出します。 | |
SaveViewState | ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 | |
SetDirty | Parameter オブジェクトの状態がビューステートで記録されるように、このオブジェクトをマークします。 | |
TrackViewState | Parameter オブジェクトがビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 |
名前 | 説明 | |
---|---|---|
System.ICloneable.Clone | 現在の Parameter インスタンスの複製を返します。 | |
System.Web.UI.IStateManager.LoadViewState | データ ソース ビューの、以前保存したビューステートを復元します。 | |
System.Web.UI.IStateManager.SaveViewState | ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。 | |
System.Web.UI.IStateManager.TrackViewState | Parameter オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState オブジェクトに格納して、同じページに対する複数の要求にわたって永続化できます。 | |
System.Web.UI.IStateManager.IsTrackingViewState | Parameter オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 |
関連項目
Parameter クラスSystem.Web.UI.WebControls 名前空間
ControlParameter クラス
CookieParameter クラス
FormParameter クラス
QueryStringParameter
SessionParameter
ParameterCollection
DataSourceControl
その他の技術情報
データ ソース コントロールとパラメータの使用Weblioに収録されているすべての辞書からparameterを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からparameterを検索
- parameterのページへのリンク