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

すべての辞書から再検索する

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

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

DetailsViewInsertEventArgs.Values プロパティ

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

挿入するレコードのフィールドの名前/値ペアを格納しているディクショナリを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 Values As IOrderedDictionary

Visual Basic (使用法)

Dim instance As DetailsViewInsertEventArgs
Dim value As IOrderedDictionary

value = instance.Values

public IOrderedDictionary Values { get; }

C++

public:
property IOrderedDictionary^ Values {
    IOrderedDictionary^ get ();
}

/** @property */
public IOrderedDictionary get_Values ()

JScript

public function get Values
 () : IOrderedDictionary

プロパティ値
挿入するレコードのキーフィールドの名前/値ペアのディクショナリを格納している IOrderedDictionary。

解説

Values プロパティを使用して、挿入するレコードのフィールドの値にアクセスします。たとえば、レコードの値をデータソースに挿入する前に HTML コード化できます。

Values プロパティは、IOrderedDictionary インターフェイスを実装するオブジェクトを返します。このオブジェクトは、レコードのフィールドを表す DictionaryEntry オブジェクトを格納します。

メモ
より簡単な方法として、IOrderedDictionary オブジェクトのインデクサを使用してフィールド値に直接アクセスすることもできます。

使用例

Values プロパティを使用して、挿入中のレコードのフィールド値にアクセスする方法のコード例を次に示します。

Visual Basic

<%@ Page language="VB" autoeventwireup="false"
 %>

<script runat="server">

  Sub CustomerDetailsView_ItemInserting(ByVal
 sender As Object, _
    ByVal e As DetailsViewInsertEventArgs)
 _
    Handles CustomerDetailsView.ItemInserting
  
    ' Use the Values property to retrieve the key field value.
    Dim keyValue As String
 = e.Values("CustomerID").ToString()

    ' 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 Sub

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>DetailsViewInsertEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          oniteminserting="CustomerDetailsView_ItemInserting"
 
          runat="server">
               
          <fieldheaderstyle backcolor="Navy"
            forecolor="White"/>
                    
        </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();

    // 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 runat="server">
        
      <h3>DetailsViewInsertEventArgs Example</h3>
                
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateinsertbutton="true"  
          autogeneraterows="true"
          allowpaging="true"
          oniteminserting="CustomerDetailsView_ItemInserting" 
          runat="server">
               
          <fieldheaderstyle backcolor="Navy"
            forecolor="White"/>
                    
        </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
IOrderedDictionary
DictionaryEntry
DetailsViewInsertEventArgs.CommandArgument プロパティ
DetailsView.ItemInserting イベント

このページでは「.NET Framework クラスライブラリリファレンス」からDetailsViewInsertEventArgs.Values プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からDetailsViewInsertEventArgs.Values プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からDetailsViewInsertEventArgs.Values プロパティを検索

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

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

DetailsViewInsertEventArgs.Values プロパティ

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


	© 2025 Microsoft.All rights reserved.

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

DetailsViewInsertEventArgs.Values プロパティ

急上昇のことば

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

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