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

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

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

BindingList.AllowNew プロパティ

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

AddNew メソッドを使用してリストに項目を追加できるかどうかを示す値を取得または設定します。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property AllowNew As
 Boolean

Visual Basic (使用法)

Dim instance As BindingList(Of
 T)
Dim value As Boolean

value = instance.AllowNew

instance.AllowNew = value

public bool AllowNew { get;
 set; }

C++

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

/** @property */
public boolean get_AllowNew ()

/** @property */
public void set_AllowNew (boolean value)

JScript

public function get AllowNew
 () : boolean

public function set AllowNew
 (value : boolean)

プロパティ値
AddNew メソッドを使用してリストに項目を追加できる場合は true。それ以外の場合は false。既定値は、リストに含まれている、基になる型によって異なります。

解説

AllowNew プロパティは、通常、他のコンポーネントによって、新しい項目を作成できるかどうかを確認するために使用されます。リストに含まれる型に既定のコンストラクタがあるか、AddingNew イベントが処理される場合、AllowNew は既定で true になります。AddingNew イベントが処理されないか、リストの型に既定のコンストラクタがない場合、AllowNew は既定で false になります。AllowNew が明示的に設定される場合は、設定された値が常に使用されます。さらに、AllowNew を設定すると、種類が Reset の ListChanged イベントが発生します。

使用例

AllowNew プロパティを設定する方法を次のコード例に示します。詳細については、BindingList クラスの概要のトピックを参照してください。

Visual Basic

' Declare a new BindingListOfT with the Part business object.
Private WithEvents listOfParts As
 BindingList(Of Part)

Private Sub InitializeListOfParts()

    ' Create the new BindingList of Part type.
    listOfParts = New BindingList(Of Part)

    ' Allow new parts to be added, but not removed once committed. 
       
    listOfParts.AllowNew = True
    listOfParts.AllowRemove = False

    ' Raise ListChanged events when new parts are added.
    listOfParts.RaiseListChangedEvents = True

    ' Do not allow parts to be edited.
    listOfParts.AllowEdit = False

    ' Add a couple of parts to the list.
    listOfParts.Add(New Part("Widget",
 1234))
    listOfParts.Add(New Part("Gadget",
 5647))

End Sub