AddingNewEventArgs Klasa

Definicja

Udostępnia dane dla zdarzenia AddingNew.Provides data for the AddingNew event.

public ref class AddingNewEventArgs : EventArgs
public class AddingNewEventArgs : EventArgs
type AddingNewEventArgs = class
    inherit EventArgs
Public Class AddingNewEventArgs
Inherits EventArgs
Dziedziczenie
AddingNewEventArgs

Przykłady

Poniższy przykład kodu demonstruje, jak używać AddingNewEventArgs klasy do obsługi BindingSource.AddingNew zdarzenia.The following code example demonstrates how to use the AddingNewEventArgs class to handle the BindingSource.AddingNew event. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie How to: Dostosowywanie dodawania elementów za pomocą źródła danych Windows Forms.This code example is part of a larger example provided in How to: Customize Item Addition with the Windows Forms BindingSource.

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}
// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}
' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew( _
 ByVal sender As Object, _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

Uwagi

AddingNewEventArgsKlasa zawiera dane dla BindingSource.AddingNew zdarzenia, które sygnalizują, że element zostanie dodany do kolekcji.The AddingNewEventArgs class provides data for the BindingSource.AddingNew event, which signals that an item is about to be added to a collection. Zdarzenie zawiera programistę w ramach procedury obsługi zdarzeń AddingNewEventHandler , która umożliwia dostarczenie nowego obiektu przez ustawienie NewObject właściwości na ten nowy element.The event gives the programmer, within the event handler AddingNewEventHandler, the option of supplying the new object by setting the NewObject property to this new item. Jeśli ta właściwość nie jest ustawiona, kolekcja będzie zazwyczaj używać konstruktora bez parametrów odpowiedniego typu do konstruowania nowego elementu.If this property is not set, the collection will typically use the parameterless constructor of the appropriate type to construct a new item. W obu przypadkach nowy element zostanie dodany do kolekcji.In either case, the new item will be added to the collection.

Jeśli kolekcja implementuje również ICancelAddNew interfejs, element zostanie dodany do programu, co pozwoli na kolejne zatwierdzenie lub wycofanie.If the collection also implements the ICancelAddNew interface, the item will be provisionally added, waiting a subsequent commit or rollback.

To zdarzenie jest często używane w scenariuszach powiązań danych w ramach klas takich jak System.Windows.Forms.BindingSource i System.ComponentModel.BindingList<T> .This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Aby uzyskać więcej informacji o sposobie obsługi zdarzeń, zobacz Obsługa iwywoływanie zdarzeń.For more information about how to handle events, see Handling and Raising Events.

Konstruktory

AddingNewEventArgs()

Inicjuje nowe wystąpienie AddingNewEventArgs klasy bez parametrów.Initializes a new instance of the AddingNewEventArgs class using no parameters.

AddingNewEventArgs(Object)

Inicjuje nowe wystąpienie AddingNewEventArgs klasy, używając określonego obiektu jako nowego elementu.Initializes a new instance of the AddingNewEventArgs class using the specified object as the new item.

Właściwości

NewObject

Pobiera lub ustawia obiekt, który ma zostać dodany do listy powiązań.Gets or sets the object to be added to the binding list.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też