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

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

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

GridViewRow.RowState プロパティ

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

GridViewRow オブジェクトの状態を取得します。

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

Visual Basic (宣言)

Public Overridable Property
 RowState As DataControlRowState

Visual Basic (使用法)

Dim instance As GridViewRow
Dim value As DataControlRowState

value = instance.RowState

instance.RowState = value

public virtual DataControlRowState RowState { get;
 set; }

C++

public:
virtual property DataControlRowState RowState {
    DataControlRowState get ();
    void set (DataControlRowState value);
}

/** @property */
public DataControlRowState get_RowState ()

/** @property */
public void set_RowState (DataControlRowState
 value)

JScript

public function get RowState
 () : DataControlRowState

public function set RowState
 (value : DataControlRowState)

プロパティ値
DataControlRowState 値のビットごとの組み合わせ。

解説

RowType プロパティを使用して、GridViewRow オブジェクトの状態を確認します。状態は、次の表に示す値のビットごとの組み合わせになります。

状態の値	説明
DataControlRowState.Alternate	GridViewRow オブジェクトは、GridView コントロールの交互の行です。
DataControlRowState.Edit	GridViewRow オブジェクトは編集モードです。
DataControlRowState.Normal	GridViewRow オブジェクトは標準 (既定) の状態です。
DataControlRowState.Selected	GridViewRow オブジェクトが選択されています。

このプロパティは、通常、操作の実行前に行の状態を確認するために使用されます。

使用例

RowState プロパティを使用して、行が編集モードであるかどうか、または選択されているかどうかを確認する方法を次の例に示します。GridView コントロールが編集モードのときにユーザーが別の行を選択すると、GridView コントロールは編集モードを終了します。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">
  
  Sub AuthorsGridView_SelectedIndexChanged(ByVal
 sender As Object, ByVal
 e As EventArgs)
  
    ' Get the selected row.
    Dim row As GridViewRow = AuthorsGridView.SelectedRow
    
    ' Check the row state. If the row is not in edit mode and is selected
,
    ' exit edit mode. This ensures that the GridView control exits edit
 mode
    ' when a user selects a different row while the GridView control
 is in 
    ' edit mode. Notice that the DataControlRowState enumeration is
 a flag
    ' enumeration, which means that you can combine values using bitwise
    ' operations.
    If row.RowState <> (DataControlRowState.Edit Or
 DataControlRowState.Selected) Then

      AuthorsGridView.EditIndex = -1
    
    End If
          
  End Sub
  
  Sub AuthorsGridView_RowEditing(ByVal sender
 As Object, ByVal e As
 GridViewEditEventArgs)
    
    ' Get the row being edited.
    Dim row As GridViewRow = AuthorsGridView.Rows(e.NewEditIndex)
    
    ' Check the row state. If the row is not in edit mode and is selected
,
    ' select the current row. This ensures that the GridView control
 selects
    ' the current row when the user clicks the Edit button.
    If row.RowState <> (DataControlRowState.Edit Or
 DataControlRowState.Selected) Then
    
      AuthorsGridView.SelectedIndex = e.NewEditIndex
    
    End If
    
  End Sub

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewRow RowState Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames attribute as
 read-only    -->
      <!-- No input controls are rendered for these columns
 in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        autogenerateselectbutton="true" 
        datakeynames="au_id"
        cellpadding="10"
        onselectedindexchanged="AuthorsGridView_SelectedIndexChanged"
        onrowediting="AuthorsGridView_RowEditing"
       
        runat="server">
        
        <selectedrowstyle backcolor="Yellow"/>
               
        <columns>
        
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
          <asp:boundfield datafield="au_fname"
            headertext="First Name"/> 
        
        </columns>
             
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects
 -->
      <!-- to the Pubs sample database.                   
     -->
      <asp:sqldatasource id="AuthorsSqlDataSource"
  
        selectcommand="SELECT [au_id], [au_lname], [au_fname]
 FROM [authors]"             
        updatecommand="UPDATE authors SET au_lname=@au_lname,
 au_fname=@au_fname WHERE (authors.au_id = @au_id)" 
        connectionstring="server=localhost;database=pubs;integrated
 security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

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

<script runat="server">
  
  void AuthorsGridView_SelectedIndexChanged(Object sender, EventArgs
 e)
  {
  
    // Get the selected row.
    GridViewRow row = AuthorsGridView.SelectedRow;
    
    // Check the row state. If the row is not in edit mode and is selected
,
    // exit edit mode. This ensures that the GridView control exits
 edit mode
    // when a user selects a different row while the GridView control
 is in 
    // edit mode. Notice that the DataControlRowState enumeration is
 a flag
    // enumeration, which means that you can combine values using bitwise
    // operations.
    if(row.RowState != (DataControlRowState.Edit|DataControlRowState.Selected))
    {
      AuthorsGridView.EditIndex = -1;
    } 
          
  }
  
  void AuthorsGridView_RowEditing(Object sender, GridViewEditEventArgs
 e)
  {
    
    // Get the row being edited.
    GridViewRow row = AuthorsGridView.Rows[e.NewEditIndex];
    
    // Check the row state. If the row is not in edit mode and is selected
,
    // select the current row. This ensures that the GridView control
 selects
    // the current row when the user clicks the Edit button.
    if(row.RowState != (DataControlRowState.Edit|DataControlRowState.Selected))
    {
      AuthorsGridView.SelectedIndex = e.NewEditIndex;
    }
    
  } 

</script>

<html>
  <body>
    <form runat="server">
        
      <h3>GridViewRow RowState Example</h3>

      <!-- The GridView control automatically sets the columns     -->
      <!-- specified in the datakeynames attribute as read-only
    -->
      <!-- No input controls are rendered for these columns
 in     -->
      <!-- edit mode.                                              -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        autogenerateselectbutton="true" 
        datakeynames="au_id"
        cellpadding="10"
        onselectedindexchanged="AuthorsGridView_SelectedIndexChanged"
        onrowediting="AuthorsGridView_RowEditing"       
        runat="server">
        
        <selectedrowstyle backcolor="Yellow"/>
               
        <columns>
        
          <asp:boundfield datafield="au_lname"
            headertext="Last Name"/>
          <asp:boundfield datafield="au_fname"
            headertext="First Name"/> 
        
        </columns>
             
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_id], [au_lname], [au_fname] FROM [authors]"
             
        updatecommand="UPDATE authors SET au_lname=@au_lname, au_fname=@au_fname
 WHERE (authors.au_id = @au_id)" 
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>