DataRepeater.AllowUserToAddItems プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

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

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

構文

'宣言
Public Property AllowUserToAddItems As Boolean
'使用
Dim instance As DataRepeater
Dim value As Boolean

value = instance.AllowUserToAddItems

instance.AllowUserToAddItems = value

public bool AllowUserToAddItems { get; set; }

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

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

プロパティ値

型 : System.Boolean

ユーザーが行を追加できる場合は true。それ以外の場合は false。既定は、true です。

解説

AllowUserToAddItems プロパティが True に設定されている場合、BindingNavigator コントロール上の BindingNavigatorAddNewItemToolStripButton をクリックすることによって、または、DataRepeaterItem にフォーカスがある場合は Ctrl + N キーを押すことによって、新しい行を追加できます。

AllowUserToAddItems プロパティが False に設定されている場合は、Ctrl + N キーは無効です。しかし、BindingNavigatorAddNewItemToolStripButton は有効です。ユーザーが行を追加できないようにする場合、BindingNavigator コントロール上の BindingNavigatorAddNewItemToolStripButton を無効にするか削除する必要もあります。

例

AllowUserToAddItems プロパティが False に設定されている場合に [追加] ボタンを無効にする方法を次のコード例に示します。この例は、DataRepeater1 という名前の DataRepeater コントロールおよび ProductsBindingSource という名前の BindingNavigator コントロールがフォームに配置されていることを前提としています。

Private Sub DataRepeater1_AllowUserToAddItemsChanged(ByVal sender _
 As Object, ByVal e As System.EventArgs) 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;
    }
}