DataRepeater.AllowUserToAddItems プロパティ

ユーザーは実行時に DataRepeater に新しい行を追加できるかどうかを示す値を取得または設定します。

名前空間:  Microsoft.VisualBasic.PowerPacks
アセンブリ:  Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
Public Property AllowUserToAddItems As Boolean

public bool AllowUserToAddItems { get; set; }

public:
property bool AllowUserToAddItems {
    bool get ();
    void set (bool value);
}

member AllowUserToAddItems : bool with get, set

function get AllowUserToAddItems () : boolean
function set AllowUserToAddItems (value : boolean)

プロパティ値

型 : System.Boolean
ユーザーが行を追加できます true ; それ false。既定値は、true です。

解説

AllowUserToAddItems のプロパティが True に設定すると、ユーザーは BindingNavigator コントロールの *** BindingNavigatorAddNewItem ***ToolStripButton をクリックするか、Ctrl キーを押しながら N キーを押すと、DataRepeaterItem にフォーカスがあるときに新しい行を追加できます。

AllowUserToAddItemsFalse のプロパティがに設定されている場合、Ctrl + N のキーボードの関数は無効になりますが、*** BindingNavigatorAddNewItem ***ToolStripButton が有効になります。ユーザーは、行を追加するようにするには、BindingNavigator コントロールの *** BindingNavigatorAddNewItem ***ToolStripButton を無効化または削除する必要があります。

例

次のコード例に AllowUserToAddItems のプロパティが False に設定すると、追加のボタンを無効にする方法を示します。DataRepeater1 という名前の DataRepeater のコントロールと ProductsBindingSource という名前の BindingNavigator のコントロールが含まれているフォームがあると仮定しています。

Private Sub DataRepeater1_AllowUserToAddItemsChanged(
    ) Handles DataRepeater1.AllowUserToAddItemsChanged

    ' If this event occurs during form initialization, exit.
    If Me.IsHandleCreated = False Then Exit Sub
    ' If AllowUserToAddItems is False.
    If DataRepeater1.AllowUserToAddItems = False Then
        ' Disable the Add button.
        BindingNavigatorAddNewItem.Enabled = False
        ' Disable the BindingSource property.
        ProductsBindingSource.AllowNew = False
    Else
        ' Otherwise, enable the Add button.
        BindingNavigatorAddNewItem.Enabled = True
    End If
End Sub

private void dataRepeater1_AllowUserToAddItemsChanged(object sender, System.EventArgs e)
{
    // If this event occurs during form initialization, exit.
    if (this.IsHandleCreated == false) { return; }
    // If AllowUserToAddItems is False.
    if (dataRepeater1.AllowUserToAddItems == false)
    // Disable the Add button.
    {
        bindingNavigatorAddNewItem.Enabled = false;
        // Disable the BindingSource property.
        productsBindingSource.AllowNew = false;
    }
    else
    {
        // Otherwise, enable the Add button.
        bindingNavigatorAddNewItem.Enabled = true;
    }
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

DataRepeater クラス

Microsoft.VisualBasic.PowerPacks 名前空間

その他の技術情報

DataRepeater コントロールの概要 (Visual Studio)

方法 : DataRepeater の項目の追加と削除を無効にする (Visual Studio)