この章では、ASP.NET で使用できる基本的なコントロールについて説明します。
ASP.NET は、次の 3 種類のボタン コントロールを提供します。
ボタン: 長方形の領域内にテキストを表示します。
リンクボタン: ハイパーリンクのようにテキストを表示します。
画像ボタン:画像を表示します。
ユーザーがボタンをクリックすると、click と command の 2 つのイベントが発生します。
ボタン コントロールの基本構文:
<asp:Button ID="Button1" runat="server" onclick="Button1_Click" Text="Click" / >
ボタン コントロールの共通プロパティ:
財産 | 説明する |
---|---|
文章 | ボタン上にテキストが表示されます。ボタンとリンク ボタンのみのコントロール。 |
画像URL | 画像ボタン コントロールのみ。この画像はボタンを表示するためのものです。 |
代替テキスト | 画像ボタン コントロールのみ。ブラウザで画像が表示できない場合は、置換テキストが表示されます。 |
原因の検証 | ユーザーがボタンをクリックしたときにページ検証を実行するかどうかを決定します。デフォルトは true です。 |
コマンド名 | ユーザーがボタンをクリックしたときにコマンド イベントに渡される文字列値。 |
コマンド引数 | ユーザーがボタンをクリックしたときにコマンド イベントに渡される文字列値。 |
ポストバック URL | ユーザーがボタンをクリックすると、必要なページ アドレスが表示されます。 |
テキスト ボックス コントロールは、ユーザー入力を受け入れるように特別に設計されています。テキスト ボックス コントロールは、テキスト モード プロパティに基づいて 1 つ以上のテキスト入力を受け入れることができます。
ラベル コントロールを使用すると、あるページから次のページにテキストを表示する簡単な方法が提供されます。一定のテキストを表示したい場合は、リテラル テキストを使用できます。
テキスト コントロールの基本構文:
<asp:TextBox ID="txtstate" runat="server" ></asp:TextBox>
テキスト ボックスとラベルの共通プロパティ:
財産 | 説明する |
---|---|
テキストモード | テキストボックスの種類を指定します。単一行モードでは標準テキストが作成され、複数行モードでは複数のテキストを受け入れる機能が作成され、パスワードによって文字が入力されるようにマークされます。デフォルトは標準テキストです。 |
文章 | テキストボックスのテキスト内容。 |
最大長さ | テキストボックスにテキスト文字の最大値を入力します。 |
包む | 複数行のテキスト ボックス内のテキストを自動的に折り返すかどうかを決定します。デフォルト値は True です。 |
読み取り専用 | ユーザーがボックス内のテキストを変更できるかどうかを決定します。デフォルトは false で、ユーザーがテキストを変更できることを意味します。 |
コラム | テキストボックスの幅(文字数)。実際の幅は、テキスト入力に使用されるフォントに基づいて決定されます。 |
行 | 複数行のテキスト ボックスの高さ。デフォルト値は 0 で、単一行のテキスト ボックスを表します。 |
ラベル コントロールで最も一般的に使用されるプロパティは、ラベルに表示されるテキストを表す「Text」です。
チェックボックスには、ユーザーがチェックまたは選択解除できるオプションが表示されます。ラジオ ボタンは、ユーザーがオプションを 1 つだけ選択できるオプションのグループを表示します。
ラジオ ボタンのグループを作成している場合は、各ラジオ ボタン グループの GroupName プロパティに同じ名前を指定できます。 1 つのフォームに複数のグループを表示する必要がある場合は、グループごとに異なるグループ名を指定します。
チェックボックスまたはラジオボタンを最初に表示されたときにオンにしたい場合は、その selected プロパティを true に設定します。グループ内の複数のラジオ ボタンのプロパティが true に設定されている場合、最後のラジオ ボタンのみが true とみなされます。
チェックボックスの基本構文:
<asp:CheckBox ID= "chkoption" runat= "Server"> </asp:CheckBox>
ラジオ ボタンの基本構文:
<asp:RadioButton ID= "rdboption" runat= "Server"> </asp: RadioButton>
チェックボックスとラジオボタンの共通プロパティ:
財産 | 説明する |
---|---|
文章 | チェックボックスまたはラジオボタンの横に表示されるテキスト。 |
チェック済み | 選択するかどうかを指定します。デフォルトは選択されていません。 |
グループ名 | コントロールが属するグループの名前。 |
ASP.NET は次のコントロールを提供します。
ドロップダウン リスト、
リストボックス、
ラジオボタンリスト、
チェックボックスリスト、
箇条書きリスト。
これらのコントロールを使用すると、ユーザーは 1 つ以上の項目のリストから選択できます。リスト ボックスとドロップダウン リストには 1 つ以上のリスト項目が含まれます。これらのリストは、コードを通じて、または ListItemCollection エディターによってロードできます。
リスト ボックス コントロールの基本構文:
<asp:ListBox ID="ListBox1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="ListBox1_SelectedIndexChanged"></asp:ListBox>
ドロップダウン リスト コントロールの基本構文:
<asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged"></asp:DropDownList>
リスト ボックスとドロップダウン リストの共通プロパティ:
財産 | 説明する |
---|---|
アイテム | コントロール内の項目を表す ListItem オブジェクトのコレクション。このプロパティは、ListItemCollection 型のオブジェクトを返します。 |
行 | ボックスに表示する項目の数を指定します。実際のリストに表示されているリストよりも多くの行が含まれている場合は、スクロール バーが追加されます。 |
選択されたインデックス | 現在選択されている項目のインデックス。複数の項目が選択されている場合は、最初のインデックスによって項目が選択されます。項目が選択されていない場合、このプロパティの値は -1 です。 |
選択された値 | 現在選択されている項目の値。複数の項目が選択されている場合は、最初の項目の値が選択されます。項目が選択されていない場合、このプロパティの値は空の文字列 ("") になります。 |
選択モード | リスト ボックスで単一選択が可能か複数選択が可能かを示します。 |
各リスト項目オブジェクトの共通プロパティ:
財産 | 説明する |
---|---|
文章 | アイテムに表示されるテキスト。 |
選択済み | 項目が選択されているかどうかを示します。 |
価値 | プロジェクトに関連付けられた文字列。 |
注目すべき点は次のとおりです。
ドロップダウン リストまたはリスト ボックス内の項目を操作する場合は、コントロールの Items プロパティを使用する必要があります。このプロパティは、リストのすべての項目を含む ListItemCollection オブジェクトを返します。
SelectedIndexChanged イベントは、ユーザーがドロップダウン リストまたはリスト ボックスから別の項目を選択すると発生します。
ListItemCollection オブジェクトは、ListItem オブジェクトのコレクションです。各 ListItem オブジェクトはリスト内の項目を表します。 ListItemCollection 内の項目番号は 0 から始まります。
リスト ボックス内の項目の読み込みプロセスで使用される文字列が、たとえば lstcolor.Items.Add ("Blue") の場合、テキストとリスト項目の値のプロパティ設定は、指定した文字列値になります。別の方法で設定するには、リスト項目のオブジェクトを作成し、その項目をコレクションに追加する必要があります。
ListItemCollection エディタは、ドロップダウン リストまたはリスト ボックスに項目を追加するために使用されます。項目の静的なリストを作成するために使用されます。コレクション エディターを表示するには、スマート タグ メニューから [項目の編集] を選択するか、コントロールを選択して、[プロパティ] ウィンドウの [項目のプロパティ] にある省略記号ボタンをクリックします。
ListItemCollection の共通プロパティ:
財産 | 説明する |
---|---|
項目(整数) | 指定されたインデックスにある項目を表す ListItem オブジェクト。 |
カウント | コレクション内のアイテムの数。 |
ListItemCollection の基本メソッド:
方法 | 説明する |
---|---|
追加(文字列) | 新しい項目をコレクションの最後に追加し、文字列パラメータを項目のテキスト プロパティに割り当てます。 |
追加(リスト項目) | 新しい項目をコレクションの最後に追加します。 |
挿入(整数, 文字列) | コレクションの指定されたインデックス位置に項目を挿入し、文字列引数を項目のテキスト プロパティに割り当てます。 |
挿入(整数, ListItem) | コレクションの指定されたインデックスに項目を挿入します。 |
削除(文字列) | テキスト値と同じ文字列を持つ項目を削除します。 |
削除(ListItem) | 指定された項目を削除します。 |
RemoveAt(整数) | 指定されたインデックスにある項目を整数として削除します。 |
クリア | コレクションからすべてのアイテムを削除します。 |
FindByValue(文字列) | 文字列値と同じ項目を返します。 |
値による検索(テキスト) | 文字列リテラルと同じ項目を返します。 |
ラジオ ボタン リストには、相互に排他的なオプションのリストが表示されます。チェックボックス リストの列には、独立したオプションのリストが表示されます。これらのコントロールには ListItem オブジェクトのコレクションが含まれており、コントロールの Items プロパティを通じて参照できます。
ラジオ ボタン リストの基本構文:
<asp:RadioButtonList ID="RadioButtonList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="RadioButtonList1_SelectedIndexChanged"></asp:RadioButtonList>
チェックボックス リストの基本構文:
<asp:CheckBoxList ID="CheckBoxList1" runat="server" AutoPostBack="True" OnSelectedIndexChanged="CheckBoxList1_SelectedIndexChanged"></asp:CheckBoxList>
チェックボックスとラジオボタンのリストの共通プロパティ:
財産 | 説明する |
---|---|
リピートレイアウト | このプロパティは、フォーマットされたリストのレンダリングにタグとプレーン HTML フローのどちらを使用するかを指定します。デフォルトはテーブルです。 |
繰り返し方向 | コントロールを繰り返す方向を指定します。利用可能な値は水平と垂直です。デフォルトは垂直です。 |
繰り返し列 | コントロールが繰り返されると、列の番号が指定され、デフォルトは 0 になります。 |
箇条書きリスト コントロールは、箇条書きリストまたは番号付きリストを作成します。これらのコントロールには ListItem オブジェクトのコレクションが含まれており、コントロールの Items プロパティを通じて参照できます。
箇条書きリストの基本構文:
<asp:BulletedList ID="BulletedList1" runat="server"></asp:BulletedList>
箇条書きリストの共通のプロパティ:
財産 | 説明する |
---|---|
ブレットスタイル | このプロパティは、項目番号または数値のスタイルと外観を指定します。 |
繰り返し方向 | コントロールを繰り返す方向を指定します。利用可能な値は水平と垂直です。デフォルトは垂直です。 |
繰り返し列 | コントロールが繰り返されると、列の番号が指定され、デフォルトは 0 になります。 |
ハイパーリンク コントロールは、 HTML <a>
要素に似ています。
ハイパーリンク コントロールの基本構文:
<asp:HyperLink ID="HyperLink1" runat="server"> HyperLink</asp:HyperLink>
次のような特性があります。
財産 | 説明する |
---|---|
画像URL | コントロールによって表示される画像へのパス。 |
ナビゲートURL | ターゲットリンクアドレス。 |
文章 | リンクとして表示されるテキスト。 |
ターゲット | リンクされたページをロードするウィンドウまたはフレーム。 |
画像を表示できない場合、画像コントロールは Web ページ上に画像または代替テキストを表示します。
画像コントロールの基本構文:
<asp:Image ID="Image1" runat="server">
これには次の重要な特性があります。
財産 | 説明する |
---|---|
代替テキスト | 画像が存在しない場合に代替テキストを表示します。 |
画像整列 | 配置オプションの制御。 |
画像URL | コントロールによって表示される画像へのパス。 |