BindingList<T>.AllowNew プロパティ

定義

名前空間:

System.ComponentModel

アセンブリ:

System.ComponentModel.TypeConverter.dll

ソース:

BindingList.cs

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

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

public bool AllowNew { get; set; }

member this.AllowNew : bool with get, set

Public Property AllowNew As Boolean

プロパティ値

Boolean

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

例

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

    // Declare a new BindingListOfT with the Part business object.
    BindingList<Part> listOfParts; 
    private void InitializeListOfParts()
    {
        // Create the new BindingList of Part type.
        listOfParts = new BindingList<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));
    }

' 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

注釈

プロパティは AllowNew 、通常、新しい項目の作成が許可されているかどうかを判断するために、他のコンポーネントによって使用されます。 AllowNew リストに true 含まれる型にパラメーターなしのコンストラクターがある場合、または イベントが処理される場合、既定値は に AddingNew 設定されます。 イベントが AddingNew 処理されない場合、またはリスト型にパラメーターなしのコンストラクターがない場合 AllowNew 、既定値は になります false。

が明示的に設定されている場合 AllowNew 、set 値は常にバインドされたオブジェクトによって使用され、新しい項目をリストに追加できるかどうかを判断します。 が true または のいずれであってもAllowNew、リスト型にパラメーターなしのコンストラクターがある場合、または イベントが処理される場合は、 を明示的に呼び出AddNewすことによって、新しい項目をAddingNew追加falseできます。 さらに、 を設定 AllowNew すると、 ListChanged 型 Reset のイベントが発生します。

こちらもご覧ください

• AddNew()
• AllowEdit
• AllowRemove