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

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

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

DetailsViewInsertEventArgs.CommandArgument プロパティ

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

DetailsView コントロールに渡される、挿入処理のコマンド引数を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 CommandArgument As Object

Visual Basic (使用法)

Dim instance As DetailsViewInsertEventArgs
Dim value As Object

value = instance.CommandArgument

public Object CommandArgument { get; }

C++

public:
property Object^ CommandArgument {
    Object^ get ();
}

/** @property */
public Object get_CommandArgument ()

JScript

public function get CommandArgument
 () : Object

プロパティ値
DetailsView コントロールに渡される、挿入処理のコマンド引数。

解説

CommandArgument プロパティを使用して、DetailsView コントロールに渡されるコマンド引数の値を確認します。CommandArgument プロパティは、挿入に関する補足情報を格納する場合に使用されます。

使用例

Button コントロールの CommandArgument プロパティを設定し、ItemInserting イベント中に値を取得して使用する方法のコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>

<script runat="server">
    Sub CustomerDetailsView_ItemInserting(ByVal
 sender As Object, ByVal
 e As DetailsViewInsertEventArgs)
  
        ' Use the Values property to retrieve the key field value.
        Dim keyValue As String
 = e.Values("CustomerID").ToString()

        If CStr(e.CommandArgument) = "CheckID"
 Then
            ' Insert the record only if the key field is four characters
            ' long; otherwise, cancel the insert operation.
            If keyValue.Length = 4 Then
                ' Change the key field value to upper case before inserting
 
                ' the record in the data source.
                e.Values("CustomerID") = keyValue.ToUpper()

                MessageLabel.Text = ""
            Else
                MessageLabel.Text = "The key field must have four
 digits."
                e.Cancel = True
            End If
        End If
    End Sub


</script>

<html>
  <body>
    <form id="Form1" runat="server">
        
      <h3>DetailsViewInsertEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true" AutoGenerateInsertButton=true
          oniteminserting="CustomerDetailsView_ItemInserting"
 
          runat="server">

            <Fields>
                <asp:TemplateField >
                  <InsertItemTemplate>
                    <asp:Button ID="Button1" CommandName="Insert"
 CommandArgument="CheckID" 
                      runat="server" Text="Insert
 with ID Check" BackColor=green />
                  </InsertItemTemplate>
                </asp:TemplateField>
            </Fields>               
        </asp:detailsview>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects
  -->
        <!-- to the Northwind sample database. Use an ASP.NET
     -->
        <!-- expression to retrieve the connection string
 value   -->
        <!-- from the web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address],
 [City], [PostalCode], [Country] From [Customers]"
          insertcommand="INSERT INTO [Customers]([CustomerID],
 [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID,
 @CompanyName, @Address, @City, @PostalCode, @Country)"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
          runat="server"/>
            
      </form>
  </body>
</html>

<%@ Page language="C#" %>

<script runat="server">

  void CustomerDetailsView_ItemInserting(Object sender, DetailsViewInsertEventArgs
 e)
  {
    // Use the Values property to retrieve the key field value.
    String keyValue = e.Values["CustomerID"].ToString();

    if (((string)(e.CommandArgument)) == "CheckID")
    {
        // Insert the record only if the key field is four characters
        // long; otherwise, cancel the insert operation.
        if (keyValue.Length == 4)
        {
            // Change the key field value to upper case before inserting
 
            // the record in the data source.
            e.Values["CustomerID"] = keyValue.ToUpper();

            MessageLabel.Text = "";
        }
        else
        {
            MessageLabel.Text = "The key field must have four digits.";
            e.Cancel = true;
        }
    }
  }

</script>

<html>
  <body>
    <form id="Form1" runat="server">
        
      <h3>DetailsViewInsertEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          allowpaging="true" AutoGenerateInsertButton=true
          oniteminserting="CustomerDetailsView_ItemInserting" 
          runat="server">

            <Fields>
                <asp:TemplateField >
                  <InsertItemTemplate>
                    <asp:Button CommandName="Insert" CommandArgument="CheckID"
 
                      runat="server" Text="Insert with ID Check"
 BackColor=green />
                  </InsertItemTemplate>
                </asp:TemplateField>
            </Fields>               
        </asp:detailsview>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value
   -->
        <!-- from the web.config file.                            -->
        <asp:sqldatasource id="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City],
 [PostalCode], [Country] From [Customers]"
          insertcommand="INSERT INTO [Customers]([CustomerID], [CompanyName],
 [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName,
 @Address, @City, @PostalCode, @Country)"
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
          runat="server"/>
            
      </form>
  </body>
</html>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DetailsViewInsertEventArgs クラス
DetailsViewInsertEventArgs メンバ
System.Web.UI.WebControls 名前空間
DetailsView クラス
DetailsViewInsertEventHandler
DetailsView.ItemInserting イベント
Values

>> 「DetailsViewInsertEventArgs.CommandArgument プロパティ」を含む用語の索引
DetailsViewInsertEventArgs.CommandArgument プロパティのページへのリンク

DetailsViewInsertEventArgs.CommandArgument プロパティとは？わかりやすく解説

DetailsViewInsertEventArgs.CommandArgument プロパティ

「DetailsViewInsertEventArgs.CommandArgument プロパティ」の関連用語


	© 2024 Microsoft.All rights reserved.

DetailsViewInsertEventArgs.CommandArgument プロパティとは？ わかりやすく解説

DetailsViewInsertEventArgs.CommandArgument プロパティ

急上昇のことば

「DetailsViewInsertEventArgs.CommandArgument プロパティ」の関連用語

DetailsViewInsertEventArgs.CommandArgument プロパティとは？わかりやすく解説