Command クラスとは何？わかりやすく解説 Weblio辞書

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

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

Command クラス

ユーザーが ASP.NET イベントハンドラを呼び出すことができるようにするユーザーインターフェイス要素を作成します。これにより、ユーザー入力を UI 要素からサーバーにポストバックできるようになります。

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

Visual Basic (宣言)

Public Class Command
    Inherits TextControl
    Implements IPostBackEventHandler, IPostBackDataHandler

Visual Basic (使用法)

Dim instance As Command

public class Command : TextControl, IPostBackEventHandler,
 IPostBackDataHandler

C++

public ref class Command : public
 TextControl, IPostBackEventHandler, IPostBackDataHandler

public class Command extends TextControl implements
 IPostBackEventHandler, IPostBackDataHandler

JScript

public class Command extends
 TextControl implements IPostBackEventHandler, IPostBackDataHandler

解説

Command コントロールは、要求側デバイス上に対話型 UI 要素として表示されます。UI 要素のラベルは、Text プロパティから得られます。このプロパティは、TextControl 基本クラスから継承されたものです。

注意
ASP.NET モバイル Web ページの URL には特殊文字を使用しないでください。Command イベントをサーバーにポストバックするために生成される HREF タグは、厳密に検証されません。たとえば、URL に空白が含まれていると、一部の WML ブラウザで処理できない WML が生成される場合があります。

Topic	Location
チュートリアル : モバイルデバイス用 Web ページの作成	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

コマンドイベントを追加する方法を次のコード例に示します。Command ボタンのいずれかをクリックすると、OnItemCommand イベントが発生します。ユーザー定義関数は、CommandEventArgs 引数を使用して、クリックされた Command ボタンを確認します。

メモ
次のコード例はシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード例は、拡張子が .aspx の空のテキストファイルにコピーする必要があります。詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

メモ

次のコード例はシングルファイルコードモデルを使用しており、分離コードファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード例は、拡張子が .aspx の空のテキストファイルにコピーする必要があります。詳細については、「ASP.NET Web ページのコードモデル」を参照してください。

Visual Basic

<%@ Page Language="VB" 
    Inherits="System.Web.UI.MobileControls.MobilePage"
 %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls"
 
    Assembly="System.Web.Mobile"
 %>
<%@ Import Namespace="System.Web.Mobile"
 %>

<script runat="server">
    Public Sub Page_Load(ByVal
 sender As Object, _
        ByVal e As EventArgs)

        Dim caps As System.Web.Mobile.MobileCapabilities
 _
            = CType(Request.Browser, MobileCapabilities)

        If caps.MaximumSoftkeyLabelLength = 5 Then
            Command1.SoftkeyLabel = "Click"
        ElseIf caps.MaximumSoftkeyLabelLength > 5 Then
            Command1.SoftkeyLabel = "Submit"
        End If
    End Sub

    Private Sub Command_Click(ByVal
 sender As Object, _
        ByVal e As CommandEventArgs)

        Dim txt As String
 = "You clicked Button{0}. ({1} points)"
        If e.CommandName.ToString() = "Command1"
 Then
            Label1.Text = String.Format(txt, 1, e.CommandArgument)
        ElseIf e.CommandName.ToString() = "Command2"
 Then
            Label1.Text = String.Format(txt, 2, e.CommandArgument)
        End If
    End Sub
</script>

<html  >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Label id="Label1" runat="server">
            Click a button
        </mobile:Label>
        <mobile:Label id="Label2" runat="server"
 /> 
        <mobile:Command id="Command1" Format="Button"
            OnItemCommand="Command_Click" 
            CommandName="Command1" runat="server"
 
            Text="Button1" CommandArgument="70"
 />
        <mobile:Command id="Command2" Format="Link"
            OnItemCommand="Command_Click" 
            CommandName="Command2" runat="server"
 
            Text="Button2" CommandArgument="50"
 />
    </mobile:form>
</body>
</html>

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>
<%@ Import Namespace="System.Web.Mobile" %>

<script runat="server">
    public void Page_Load(Object sender, EventArgs
 e)
    {
        MobileCapabilities caps
            = (MobileCapabilities)Request.Browser;
        if (caps.MaximumSoftkeyLabelLength == 5)
        {
            Command1.SoftkeyLabel = "Click";
        }
        else if (caps.MaximumSoftkeyLabelLength
 > 5)
        {
            Command1.SoftkeyLabel = "Submit";
        }
    }

    void Command_Click(object sender, CommandEventArgs e)
    {
        string txt = "You clicked Button{0}. ({1} points)";
        if (e.CommandName.ToString() == "Command1")
        {
            Label1.Text = String.Format(txt, 1, 
                e.CommandArgument);
        }
        else if (e.CommandName.ToString() ==
 "Command2")
        {
            Label1.Text = String.Format(txt, 2, 
                e.CommandArgument);
        }
    }
</script>

<html  >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Label id="Label1" runat="server">
            Click a button
        </mobile:Label>
        <mobile:Label id="Label2" runat="server" /> 
        <mobile:Command id="Command1"  Format="Button"
            OnItemCommand="Command_Click" 
            CommandName="Command1" runat="server" 
            Text="Button1" CommandArgument="70" />
        <mobile:Command id="Command2" Format="Link"
            OnItemCommand="Command_Click" 
            CommandName="Command2" runat="server" 
            Text="Button2" CommandArgument="50" />
    </mobile:form>
</body>
</html>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.MobileControls.MobileControl
       System.Web.UI.MobileControls.TextControl
        System.Web.UI.MobileControls.Command

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。