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

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

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

DetailsView.CurrentMode プロパティ

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

DetailsView コントロールの現在の日付入力モードを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 CurrentMode As DetailsViewMode

Visual Basic (使用法)

Dim instance As DetailsView
Dim value As DetailsViewMode

value = instance.CurrentMode

public DetailsViewMode CurrentMode { get; }

C++

public:
property DetailsViewMode CurrentMode {
    DetailsViewMode get ();
}

/** @property */
public DetailsViewMode get_CurrentMode ()

JScript

public function get CurrentMode
 () : DetailsViewMode

プロパティ値
DetailsViewMode 値の 1 つ。

解説

CurrentMode プロパティを使用して、DetailsView コントロールが編集、挿入、または読み取り専用のいずれのモードであるかを確認します。さまざまなモード値の一覧を次の表に示します。

モード	説明
DetailsViewMode.Edit	DetailsView コントロールは編集モードになっています。この場合、ユーザーは、レコードの値を更新できます。
DetailsViewMode.Insert	DetailsView コントロールは挿入モードになっています。この場合、ユーザーは、データソースに新しいレコードを追加できます。
DetailsView.ReadOnly	DetailsView コントロールは、標準の表示モードである読み取り専用モードになっています。

この値は通常、New、Delete、または Cancel の各コマンドボタンがクリックされたときに、DetailsView コントロールによって自動的に設定されます。ChangeMode メソッドを使用して、モードをプログラムによって変更することもできます。

DetailsView コントロールがモードを変更すると、次の表に示すイベントが発生します。これにより、イベントが発生したときにルーチンを実行するカスタムイベントハンドラを作成できます。

イベント	説明
ModeChanged	DetailsView コントロールのモードを変更するコマンドボタンがクリックされた場合に、モードが変更された後で発生します。
ModeChanging	DetailsView コントロールのモードを変更するコマンドボタンがクリックされた場合に、モードが変更される前に発生します。

使用例

CurrentMode プロパティを使用して、DetailsView コントロールが編集、挿入、または読み取り専用のいずれのモードであるかを確認する方法のコード例を次に示します。DetailsView コントロールが編集モードの場合にユーザーが別のレコードに移動しようとすると、ページング操作はキャンセルされます。

Visual Basic

<%@ Page Language="VB" %>

<script runat="server">


    Sub CustomerDetailView_ItemCommand(ByVal
 sender As Object, _
      ByVal e As DetailsViewCommandEventArgs)
        ' Clear the error message if the user cancels the edit 
        ' operation.
        If e.CommandName = "Cancel"
 Then
            ErrorMessageLabel.Text = ""
        End If
    End Sub

    Protected Sub CustomerDetailView_PageIndexChanging(
 _
    ByVal sender As Object,
 ByVal e As DetailsViewPageEventArgs)
        ' Cancel the paging operation if the user tries to navigate
 
        ' to another record while in edit mode.
        If CustomerDetailView.CurrentMode = DetailsViewMode.Edit
 Then
            e.Cancel = True
            ' Display an error message.
            ErrorMessageLabel.Text = _
                "You cannot navigate to another record while in
 edit mode."
        End If
    End Sub
</script>

<html>
<body>
    <form id="Form1" runat="server">
        <h3>
            DetailsView CurrentMode Example</h3>
        <asp:DetailsView ID="CustomerDetailView"
 
          DataSourceID="DetailsViewSource" 
          AutoGenerateRows="true"
          AutoGenerateEditButton="true" 
          DataKeyNames="CustomerID" 
          GridLines="Both" 
          AllowPaging="true"
          OnItemCommand="CustomerDetailView_ItemCommand"
 
          runat="server" 
          OnPageIndexChanging="CustomerDetailView_PageIndexChanging">
          
          <HeaderStyle BackColor="Navy" ForeColor="White"
 />
        </asp:DetailsView>
        
        <br />
        
        <asp:Label ID="ErrorMessageLabel" 
          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"
 runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
</body>
</html>

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

<script runat="server">


    void CustomerDetailView_ItemCommand(Object sender, 
      DetailsViewCommandEventArgs e)
    {
        // Clear the error message if the user cancels the edit 
        // operation.
        if (e.CommandName == "Cancel")
        {
            ErrorMessageLabel.Text = "";
        }
    }

    protected void CustomerDetailView_PageIndexChanging(
      object sender, DetailsViewPageEventArgs e)
    {
        // Cancel the paging operation if the user tries to 
        // navigate to another record while in edit mode.
        if (CustomerDetailView.CurrentMode == DetailsViewMode.Edit)
        {
            e.Cancel = true;
            // Display an error message.
            ErrorMessageLabel.Text = 
              "You cannot navigate to another record while
 in edit mode.";
        }

    }
</script>

<html>
<body>
    <form id="Form1" runat="server">
        <h3>
            DetailsView CurrentMode Example</h3>
        <asp:DetailsView ID="CustomerDetailView" 
          DataSourceID="DetailsViewSource" 
          AutoGenerateRows="true"
          AutoGenerateEditButton="true" 
          DataKeyNames="CustomerID" 
          GridLines="Both" 
          AllowPaging="true"
          OnItemCommand="CustomerDetailView_ItemCommand" 
          runat="server" 
          OnPageIndexChanging="CustomerDetailView_PageIndexChanging">
          
          <HeaderStyle BackColor="Navy" ForeColor="White"
 />
        </asp:DetailsView>
        
        <br />
        
        <asp:Label ID="ErrorMessageLabel" 
          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" runat="server"
 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"
          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
</body>
</html>