BindingSource BindingSource BindingSource BindingSource Class

Definizione

Incapsula l'origine dati per un form.Encapsulates the data source for a form.

public ref class BindingSource : System::ComponentModel::Component, System::Collections::IList, System::ComponentModel::IBindingListView, System::ComponentModel::ICancelAddNew, System::ComponentModel::ISupportInitializeNotification, System::ComponentModel::ITypedList, System::Windows::Forms::ICurrencyManagerProvider
[System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
public class BindingSource : System.ComponentModel.Component, System.Collections.IList, System.ComponentModel.IBindingListView, System.ComponentModel.ICancelAddNew, System.ComponentModel.ISupportInitializeNotification, System.ComponentModel.ITypedList, System.Windows.Forms.ICurrencyManagerProvider
type BindingSource = class
    inherit Component
    interface IBindingListView
    interface IBindingList
    interface IList
    interface ICollection
    interface IEnumerable
    interface ITypedList
    interface ICancelAddNew
    interface ISupportInitializeNotification
    interface ISupportInitialize
    interface ICurrencyManagerProvider
Public Class BindingSource
Inherits Component
Implements IBindingListView, ICancelAddNew, ICurrencyManagerProvider, IList, ISupportInitializeNotification, ITypedList
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio di codice riportato di ListBox seguito viene illustrato BindingSourceun oggetto associato a un oggetto.The following code example demonstrates a ListBox bound to a BindingSource. L' BindingSource oggetto è associato a BindingList<T> un oggetto che contiene un elenco di tipi di carattere.The BindingSource is bound to a BindingList<T> that contains a list of fonts.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Text;
using System.Windows.Forms;

namespace BindingSourceExamples
{
    public class Form1 : Form
    {
        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        public Form1()
        {
            this.Load += new EventHandler(Form1_Load);
        }

        private TextBox textBox1;
        private Button button1;
        private ListBox listBox1;
       
        private BindingSource binding1;
        void Form1_Load(object sender, EventArgs e)
        {
            listBox1 = new ListBox();
            textBox1 = new TextBox();
            binding1 = new BindingSource();
            button1 = new Button();
            listBox1.Location = new Point(140, 25);
            listBox1.Size = new Size(123, 160);
            textBox1.Location = new Point(23, 70);
            textBox1.Size = new Size(100, 20);
            textBox1.Text = "Wingdings";
            button1.Location = new Point(23, 25);
            button1.Size = new Size(75, 23);
            button1.Text = "Search";
            button1.Click += new EventHandler(this.button1_Click);
            this.ClientSize = new Size(292, 266);
            this.Controls.Add(this.button1);
            this.Controls.Add(this.textBox1);
            this.Controls.Add(this.listBox1);

            MyFontList fonts = new MyFontList();
            for (int i = 0; i < FontFamily.Families.Length; i++)
            {
                if (FontFamily.Families[i].IsStyleAvailable(FontStyle.Regular))
                    fonts.Add(new Font(FontFamily.Families[i], 11.0F, FontStyle.Regular));
            }
            binding1.DataSource = fonts;
            listBox1.DataSource = binding1;
            listBox1.DisplayMember = "Name";

        }

  
        private void button1_Click(object sender, EventArgs e)
        {
            if (binding1.SupportsSearching != true)
                MessageBox.Show("Cannot search the list.");
            else
            {
                int foundIndex = binding1.Find("Name", textBox1.Text);
                if (foundIndex > -1)
                    listBox1.SelectedIndex = foundIndex;
                else
                    MessageBox.Show("Font was not found.");
            }
        }
    }
    
    public class MyFontList : BindingList<Font>
    {

        protected override bool SupportsSearchingCore
        {
            get { return true; }
        }
        protected override int FindCore(PropertyDescriptor prop, object key)
        {
            // Ignore the prop value and search by family name.
            for (int i = 0; i < Count; ++i)
            {
                if (Items[i].FontFamily.Name.ToLower() == ((string)key).ToLower())
                    return i;

            }
            return -1;
        }


    }
  
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Drawing
Imports System.Text
Imports System.Windows.Forms
Public Class Form1
    Inherits Form

    <STAThread()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())

    End Sub

    Public Sub New()

    End Sub

    Private textBox1 As TextBox
    Private WithEvents button1 As Button
    Private listBox1 As ListBox
    Private components As IContainer
    Private binding1 As BindingSource

    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        listBox1 = New ListBox()
        textBox1 = New TextBox()
        binding1 = New BindingSource()
        button1 = New Button()
        listBox1.Location = New Point(140, 25)
        listBox1.Size = New Size(123, 160)
        textBox1.Location = New Point(23, 70)
        textBox1.Size = New Size(100, 20)
        textBox1.Text = "Wingdings"
        button1.Location = New Point(23, 25)
        button1.Size = New Size(75, 23)
        button1.Text = "Search"
        Me.ClientSize = New Size(292, 266)
        Me.Controls.Add(Me.button1)
        Me.Controls.Add(Me.textBox1)
        Me.Controls.Add(Me.listBox1)

        Dim fonts As New MyFontList()
        Dim i As Integer
        For i = 0 To FontFamily.Families.Length - 1
            If FontFamily.Families(i).IsStyleAvailable(FontStyle.Regular) Then
                fonts.Add(New Font(FontFamily.Families(i), 11.0F, FontStyle.Regular))
            End If
        Next i
        binding1.DataSource = fonts
        listBox1.DataSource = binding1
        listBox1.DisplayMember = "Name"

    End Sub
    Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles button1.Click

        If binding1.SupportsSearching <> True Then
            MessageBox.Show("Cannot search the list.")
        Else
            Dim foundIndex As Integer = binding1.Find("Name", textBox1.Text)
            If foundIndex > -1 Then
                listBox1.SelectedIndex = foundIndex
            Else
                MessageBox.Show("Font was not found.")
            End If
        End If

    End Sub
End Class

Public Class MyFontList
    Inherits BindingList(Of Font)

    Protected Overrides ReadOnly Property SupportsSearchingCore() As Boolean
        Get
            Return True
        End Get
    End Property
    
    Protected Overrides Function FindCore(ByVal prop As PropertyDescriptor, _
        ByVal key As Object) As Integer
        ' Ignore the prop value and search by family name.
        Dim i As Integer
        While i < Count
            If Items(i).FontFamily.Name.ToLower() = CStr(key).ToLower() Then
                Return i
            End If
            i += 1
        End While

        Return -1
    End Function
End Class

Commenti

Il BindingSource componente viene utilizzato per molti scopi.The BindingSource component serves many purposes. In primo luogo, semplifica l'associazione dei controlli di un modulo ai dati fornendo la gestione della valuta, la notifica delle modifiche e altri servizi tra Windows Forms controlli e le origini dati.First, it simplifies binding controls on a form to data by providing currency management, change notification, and other services between Windows Forms controls and data sources. Questa operazione viene eseguita connettendo il BindingSource componente all'origine dati utilizzando la DataSource proprietà.This is accomplished by attaching the BindingSource component to your data source using the DataSource property. Per scenari di binding complessi è possibile impostare facoltativamente DataMember la proprietà su una colonna o un elenco specifico nell'origine dati.For complex binding scenarios you can optionally set the DataMember property to a specific column or list in the data source. Si associano quindi i BindingSourcecontrolli a.You then bind controls to the BindingSource. Tutte le altre interazioni con i dati vengono eseguite con le chiamate BindingSource al componente.All further interaction with the data is accomplished with calls to the BindingSource component. Per esempi sul modo BindingSource in cui può semplificare il processo di associazione, vedere procedura: Associare Windows Forms controlli ai valori del database DBNull e procedura: Gestire gli errori e le eccezioni che siverificano con l'associazione dati.For examples on how the BindingSource can simplify the binding process, see How to: Bind Windows Forms Controls to DBNull Database Values and How to: Handle Errors and Exceptions that Occur with Databinding. La navigazione e l'aggiornamento dell'origine dati vengono eseguite tramite metodi come MoveNext, MoveLaste Remove.Navigation and updating of the data source is accomplished through methods such as MoveNext, MoveLast, and Remove. Operazioni quali l'ordinamento e il filtro vengono gestite tramite le Sort proprietà Filter e.Operations such as sorting and filtering are handled through the Sort and Filter properties. Per ulteriori informazioni sull'utilizzo dell'ordinamento e del BindingSourcefiltro con, vedere procedura: Ordinare e filtrare i dati di ADO.NET con il componenteWindows Forms BindingSource.For more information on using sorting and filtering with the BindingSource, see How to: Sort and Filter ADO.NET Data with the Windows Forms BindingSource Component.

Inoltre, il BindingSource componente può fungere da origine dati fortemente tipizzata.In addition, the BindingSource component can act as a strongly typed data source. Il tipo dell'origine dati sottostante viene in genere risolto tramite uno dei meccanismi seguenti:Typically the type of the underlying data source is fixed through one of the following mechanisms:

  • Utilizzare il Add metodo per aggiungere un elemento BindingSource al componente.Use the Add method to add an item to the BindingSource component.

  • Impostare la DataSource proprietà su un elenco, un singolo oggetto o un tipo.Set the DataSource property to a list, single object, or type.

Entrambi questi meccanismi creano un elenco fortemente tipizzato.Both of these mechanisms create a strongly-typed list. Per ulteriori informazioni sull'utilizzo di per l' BindingSource associazione a un tipo, vedere procedura: Associare un controllo Windows Forms a un tipo.For more information on how to use the BindingSource to bind to a type, see How to: Bind a Windows Forms Control to a Type. È anche possibile usare BindingSource per associare i controlli a un oggetto Factory.You can also use the BindingSource to bind your controls to a factory object. Per ulteriori informazioni su come eseguire questa operazione, vedere procedura: Associare un controllo Windows Forms a un oggettoFactory.For more information on how to do this, see How to: Bind a Windows Forms Control to a Factory Object.

Nota

Poiché un BindingSource oggetto gestisce sia origini dati semplici che complesse, la terminologia è problematica.Because a BindingSource handles both simple and complex data sources, terminology is problematic. All'interno di questa classe, l' elenco dei termini fa riferimento a una raccolta di dati all'interno dell'origine dati ospitata e l' elemento denota un singolo elemento.Within this class documentation, the term list refers to a data collection within the hosted data source, and item denotes a single element. Quando si discutono le funzionalità associate a origini dati complesse, vengono utilizzate la tabella e la riga dei termini equivalenti.When discussing functionality associated with complex data sources, the equivalent terms table and row are used.

BindingSourcefornisce i membri per accedere ai dati sottostanti.BindingSource provides members for accessing the underlying data. L'elemento corrente può essere recuperato tramite la Current proprietà e l'intero elenco può essere recuperato tramite la List proprietà.The current item can be retrieved through the Current property, and the entire list can be retrieved through the List property. Le operazioni di modifica sono supportate nell'elemento corrente Current tramite i RemoveCurrent AddNew metodi EndEdite CancelEdit , Add e.Editing operations are supported on the current item through Current and the RemoveCurrent, EndEdit, CancelEdit and Add and AddNew methods. Sebbene la gestione della valuta venga gestita automaticamente per tutti i tipi di origine dati sottostanti, questa classe espone una serie CurrentItemChanged di DataSourceChangedeventi, ad esempio e, che consentono la personalizzazione.Although currency management is handled automatically for all underlying data source types, this class exposes a number of events, such as CurrentItemChanged and DataSourceChanged, that allow for customization.

Le origini dati associate a un BindingSource componente possono anche essere spostate e gestite con la BindingNavigator classe, che fornisce un'interfaccia utente simile a un VCR per spostarsi tra gli elementi all'interno di un elenco.Data sources that are bound to a BindingSource component can also be navigated and managed with the BindingNavigator class, which provides a VCR-like user interface (UI) for navigating items within a list. Sebbene BindingNavigator possa essere associato a qualsiasi origine dati, è stato progettato per l'integrazione con BindingSource un componente tramite BindingNavigator.BindingSource la relativa proprietà.Although BindingNavigator can be bound to any data source, it was designed to integrate with a BindingSource component through its BindingNavigator.BindingSource property.

La proprietà predefinita per la BindingSource classe è DataSource.The default property for the BindingSource class is DataSource. L'evento predefinito è CurrentChanged.The default event is CurrentChanged.

Attenzione

Molti dei membri della BindingSource classe operano nell'elenco sottostante rappresentato List dalla proprietà e fanno semplicemente riferimento alla relativa operazione all'elenco sottostante.Many of the members of the BindingSource class operate on the underlying list represented by the List property and simply refer their operation to the underlying list. Pertanto, quando BindingSource è associato a un'implementazione personalizzata di IList, il comportamento esatto di questi membri può variare rispetto al comportamento descritto nella documentazione relativa alla classe.Therefore, when the BindingSource is bound to a custom implementation of IList, the exact behavior of these members may differ from the behavior described in the class documentation. Ad esempio, il RemoveAt metodo chiama IList.RemoveAt.For example, the RemoveAt method calls IList.RemoveAt. La BindingSource documentazione descrive il RemoveAt metodo con la consapevolezza che il RemoveAt metodo per l'oggetto IList sottostante è implementato correttamente.The BindingSource documentation describes the RemoveAt method with the understanding that the RemoveAt method for the underlying IList is correctly implemented.

Costruttori

BindingSource() BindingSource() BindingSource() BindingSource()

Inizializza una nuova istanza della classe BindingSource con i valori predefiniti delle proprietà.Initializes a new instance of the BindingSource class to the default property values.

BindingSource(IContainer) BindingSource(IContainer) BindingSource(IContainer) BindingSource(IContainer)

Inizializza una nuova istanza della classe BindingSource e aggiunge l'oggetto BindingSource al contenitore specificato.Initializes a new instance of the BindingSource class and adds the BindingSource to the specified container.

BindingSource(Object, String) BindingSource(Object, String) BindingSource(Object, String) BindingSource(Object, String)

Inizializza una nuova istanza della classe BindingSource con l'origine dati e il membro dati specificati.Initializes a new instance of the BindingSource class with the specified data source and data member.

Proprietà

AllowEdit AllowEdit AllowEdit AllowEdit

Ottiene un valore che indica se è possibile modificare gli elementi dell'elenco sottostante.Gets a value indicating whether items in the underlying list can be edited.

AllowNew AllowNew AllowNew AllowNew

Ottiene o imposta un valore che indica se il metodo AddNew() può essere utilizzato per aggiungere elementi all'elenco.Gets or sets a value indicating whether the AddNew() method can be used to add items to the list.

AllowRemove AllowRemove AllowRemove AllowRemove

Ottiene un valore che indica se è possibile rimuovere elementi dall'elenco sottostante.Gets a value indicating whether items can be removed from the underlying list.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Count Count Count Count

Ottiene il numero complessivo di elementi nell'elenco sottostante, prendendo in considerazione il valore Filter corrente.Gets the total number of items in the underlying list, taking the current Filter value into consideration.

CurrencyManager CurrencyManager CurrencyManager CurrencyManager

Ottiene l'oggetto CurrencyManager associato a questo oggetto BindingSource.Gets the currency manager associated with this BindingSource.

Current Current Current Current

Ottiene l'elemento corrente dell'elenco.Gets the current item in the list.

DataMember DataMember DataMember DataMember

Ottiene o imposta l'elenco specifico nell'origine dati a cui il connettore è attualmente associato.Gets or sets the specific list in the data source to which the connector currently binds to.

DataSource DataSource DataSource DataSource

Ottiene o imposta l'origine dati a cui il connettore è associato.Gets or sets the data source that the connector binds to.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Filter Filter Filter Filter

Ottiene o imposta l'espressione usata per filtrare le righe da visualizzare.Gets or sets the expression used to filter which rows are viewed.

IsBindingSuspended IsBindingSuspended IsBindingSuspended IsBindingSuspended

Ottiene un valore che indica se l'associazione dell'elenco è sospeso.Gets a value indicating whether the list binding is suspended.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Ottiene un valore che indica se l'elenco sottostante ha una dimensione fissa.Gets a value indicating whether the underlying list has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se l'elenco sottostante è di sola lettura.Gets a value indicating whether the underlying list is read-only.

IsSorted IsSorted IsSorted IsSorted

Ottiene un valore che indica se gli elementi dell'elenco sottostante sono ordinati.Gets a value indicating whether the items in the underlying list are sorted.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene o imposta l'elemento di un elenco in corrispondenza dell'indice specificato.Gets or sets the list element at the specified index.

List List List List

Ottiene l'elenco a cui è associato il connettore.Gets the list that the connector is bound to.

Position Position Position Position

Ottiene o imposta l'indice dell'elemento corrente nell'elenco sottostante.Gets or sets the index of the current item in the underlying list.

RaiseListChangedEvents RaiseListChangedEvents RaiseListChangedEvents RaiseListChangedEvents

Ottiene o imposta un valore che indica se gli eventi ListChanged devono essere generati.Gets or sets a value indicating whether ListChanged events should be raised.

Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Sort Sort Sort Sort

Ottiene o imposta i nomi di colonna usati per l'ordinamento, nonché l'ordine di visualizzazione delle righe nell'origine dati.Gets or sets the column names used for sorting, and the sort order for viewing the rows in the data source.

SortDescriptions SortDescriptions SortDescriptions SortDescriptions

Ottiene la raccolta delle descrizioni di ordinamento applicate all'origine dati.Gets the collection of sort descriptions applied to the data source.

SortDirection SortDirection SortDirection SortDirection

Ottiene la direzione di ordinamento degli elementi dell'elenco.Gets the direction the items in the list are sorted.

SortProperty SortProperty SortProperty SortProperty

Ottiene l'oggetto PropertyDescriptor che viene utilizzato per l'ordinamento dell'elenco.Gets the PropertyDescriptor that is being used for sorting the list.

SupportsAdvancedSorting SupportsAdvancedSorting SupportsAdvancedSorting SupportsAdvancedSorting

Ottiene un valore che indica se l'origine dati supporta l'ordinamento a più colonne.Gets a value indicating whether the data source supports multi-column sorting.

SupportsChangeNotification SupportsChangeNotification SupportsChangeNotification SupportsChangeNotification

Ottiene un valore che indica se l'origine dati supporta la notifica di modifiche.Gets a value indicating whether the data source supports change notification.

SupportsFiltering SupportsFiltering SupportsFiltering SupportsFiltering

Ottiene un valore che indica se l'origine dati supporta i filtri.Gets a value indicating whether the data source supports filtering.

SupportsSearching SupportsSearching SupportsSearching SupportsSearching

Ottiene un valore che indica se l'origine dati supporta la ricerca con il metodo Find(PropertyDescriptor, Object).Gets a value indicating whether the data source supports searching with the Find(PropertyDescriptor, Object) method.

SupportsSorting SupportsSorting SupportsSorting SupportsSorting

Ottiene un valore che indica se l'origine dati supporta l'ordinamento.Gets a value indicating whether the data source supports sorting.

SyncRoot SyncRoot SyncRoot SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso all'elenco sottostante.Gets an object that can be used to synchronize access to the underlying list.

Metodi

Add(Object) Add(Object) Add(Object) Add(Object)

Aggiunge un elemento esistente all'elenco interno.Adds an existing item to the internal list.

AddNew() AddNew() AddNew() AddNew()

Aggiunge un nuovo elemento all'elenco sottostante.Adds a new item to the underlying list.

ApplySort(ListSortDescriptionCollection) ApplySort(ListSortDescriptionCollection) ApplySort(ListSortDescriptionCollection) ApplySort(ListSortDescriptionCollection)

Ordina l'origine dati con le descrizioni di ordinamento specificate.Sorts the data source with the specified sort descriptions.

ApplySort(PropertyDescriptor, ListSortDirection) ApplySort(PropertyDescriptor, ListSortDirection) ApplySort(PropertyDescriptor, ListSortDirection) ApplySort(PropertyDescriptor, ListSortDirection)

Ordina l'origine dati usando il descrittore e la direzione di ordinamento della proprietà specificati.Sorts the data source using the specified property descriptor and sort direction.

CancelEdit() CancelEdit() CancelEdit() CancelEdit()

Annulla l'operazione di modifica corrente.Cancels the current edit operation.

Clear() Clear() Clear() Clear()

Rimuove tutti gli elementi dall'elenco.Removes all elements from the list.

Contains(Object) Contains(Object) Contains(Object) Contains(Object)

Determina se un oggetto è un elemento incluso nell'elenco.Determines whether an object is an item in the list.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copia il contenuto della proprietà List nella matrice specificata, partendo dal valore dell'indice specificato.Copies the contents of the List to the specified array, starting at the specified index value.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da BindingSource e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the BindingSource and optionally releases the managed resources.

EndEdit() EndEdit() EndEdit() EndEdit()

Applica le modifiche in sospeso all'origine dati sottostante.Applies pending changes to the underlying data source.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object) Find(PropertyDescriptor, Object)

Cerca l'indice dell'elemento con il descrittore di proprietà specificato.Searches for the index of the item that has the given property descriptor.

Find(String, Object) Find(String, Object) Find(String, Object) Find(String, Object)

Restituisce l'indice dell'elemento dell'elenco con il nome e il valore di proprietà specificati.Returns the index of the item in the list with the specified property name and value.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Recupera un enumeratore per l'oggetto List.Retrieves an enumerator for the List.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[]) GetItemProperties(PropertyDescriptor[])

Recupera una matrice di oggetti PropertyDescriptor rappresentante le proprietà associabili del tipo di elenco di origine dati.Retrieves an array of PropertyDescriptor objects representing the bindable properties of the data source list type.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[]) GetListName(PropertyDescriptor[])

Ottiene il nome dell'elenco che fornisce i dati per l'associazione.Gets the name of the list supplying data for the binding.

GetRelatedCurrencyManager(String) GetRelatedCurrencyManager(String) GetRelatedCurrencyManager(String) GetRelatedCurrencyManager(String)

Ottiene il gestore della valuta correlato per il membro dati specificato.Gets the related currency manager for the specified data member.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Object) IndexOf(Object) IndexOf(Object) IndexOf(Object)

Cerca l'oggetto specificato e restituisce l'indice della prima occorrenza all'interno dell'intero elenco.Searches for the specified object and returns the index of the first occurrence within the entire list.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
Insert(Int32, Object) Insert(Int32, Object) Insert(Int32, Object) Insert(Int32, Object)

Inserisce un elemento nell'elenco in corrispondenza dell'indice specificato.Inserts an item into the list at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MoveFirst() MoveFirst() MoveFirst() MoveFirst()

Passa al primo elemento dell'elenco.Moves to the first item in the list.

MoveLast() MoveLast() MoveLast() MoveLast()

Passa all'ultimo elemento dell'elenco.Moves to the last item in the list.

MoveNext() MoveNext() MoveNext() MoveNext()

Passa al successivo elemento dell'elenco.Moves to the next item in the list.

MovePrevious() MovePrevious() MovePrevious() MovePrevious()

Passa all'elemento precedente dell'elenco.Moves to the previous item in the list.

OnAddingNew(AddingNewEventArgs) OnAddingNew(AddingNewEventArgs) OnAddingNew(AddingNewEventArgs) OnAddingNew(AddingNewEventArgs)

Genera l'evento AddingNew.Raises the AddingNew event.

OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs)

Genera l'evento BindingComplete.Raises the BindingComplete event.

OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs)

Genera l'evento CurrentChanged.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs)

Genera l'evento CurrentItemChanged.Raises the CurrentItemChanged event.

OnDataError(BindingManagerDataErrorEventArgs) OnDataError(BindingManagerDataErrorEventArgs) OnDataError(BindingManagerDataErrorEventArgs) OnDataError(BindingManagerDataErrorEventArgs)

Genera l'evento DataError.Raises the DataError event.

OnDataMemberChanged(EventArgs) OnDataMemberChanged(EventArgs) OnDataMemberChanged(EventArgs) OnDataMemberChanged(EventArgs)

Genera l'evento DataMemberChanged.Raises the DataMemberChanged event.

OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs)

Genera l'evento DataSourceChanged.Raises the DataSourceChanged event.

OnListChanged(ListChangedEventArgs) OnListChanged(ListChangedEventArgs) OnListChanged(ListChangedEventArgs) OnListChanged(ListChangedEventArgs)

Genera l'evento ListChanged.Raises the ListChanged event.

OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs)

Genera l'evento PositionChanged.Raises the PositionChanged event.

Remove(Object) Remove(Object) Remove(Object) Remove(Object)

Rimuove dall'elenco l'elemento specificato.Removes the specified item from the list.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Rimuove l'elemento presente nell'elenco in corrispondenza dell'indice specificato.Removes the item at the specified index in the list.

RemoveCurrent() RemoveCurrent() RemoveCurrent() RemoveCurrent()

Rimuove l'elemento corrente dall'elenco.Removes the current item from the list.

RemoveFilter() RemoveFilter() RemoveFilter() RemoveFilter()

Rimuove il filtro associato all'oggetto BindingSource.Removes the filter associated with the BindingSource.

RemoveSort() RemoveSort() RemoveSort() RemoveSort()

Rimuove l'ordinamento associato all'oggetto BindingSource.Removes the sort associated with the BindingSource.

ResetAllowNew() ResetAllowNew() ResetAllowNew() ResetAllowNew()

Reinizializza la proprietà AllowNew.Reinitializes the AllowNew property.

ResetBindings(Boolean) ResetBindings(Boolean) ResetBindings(Boolean) ResetBindings(Boolean)

Fa sì che un controllo associato all'oggetto BindingSource esegua la rilettura di tutti gli elementi dell'elenco e aggiorni i relativi valori visualizzati.Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

ResetCurrentItem() ResetCurrentItem() ResetCurrentItem() ResetCurrentItem()

Fa sì che un controllo associato all'oggetto BindingSource esegua la rilettura dell'elemento correntemente selezionato e aggiorni il relativo valore visualizzato.Causes a control bound to the BindingSource to reread the currently selected item and refresh its displayed value.

ResetItem(Int32) ResetItem(Int32) ResetItem(Int32) ResetItem(Int32)

Fa sì che un controllo associato all'oggetto BindingSource esegua la rilettura dell'elemento posto in corrispondenza dell'indice specificato e aggiorni il relativo valore visualizzato.Causes a control bound to the BindingSource to reread the item at the specified index, and refresh its displayed value.

ResumeBinding() ResumeBinding() ResumeBinding() ResumeBinding()

Riprende l'associazione dati.Resumes data binding.

SuspendBinding() SuspendBinding() SuspendBinding() SuspendBinding()

Sospende il data binding per evitare che le modifiche aggiornino l'origine dati associata.Suspends data binding to prevent changes from updating the bound data source.

ToString() ToString() ToString() ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from Component)

Eventi

AddingNew AddingNew AddingNew AddingNew

Si verifica prima dell'aggiunta di un elemento all'elenco sottostante.Occurs before an item is added to the underlying list.

BindingComplete BindingComplete BindingComplete BindingComplete

Si verifica quando tutti i client sono stati associati a questo oggetto BindingSource.Occurs when all the clients have been bound to this BindingSource.

CurrentChanged CurrentChanged CurrentChanged CurrentChanged

Si verifica quando l'elemento attualmente associato viene modificato.Occurs when the currently bound item changes.

CurrentItemChanged CurrentItemChanged CurrentItemChanged CurrentItemChanged

Si verifica in seguito alla modifica del valore della proprietà Current.Occurs when a property value of the Current property has changed.

DataError DataError DataError DataError

Si verifica quando un'eccezione correlata alla valuta viene gestita in modo invisibile all'utente dall'oggetto BindingSource.Occurs when a currency-related exception is silently handled by the BindingSource.

DataMemberChanged DataMemberChanged DataMemberChanged DataMemberChanged

Si verifica quando viene modificato il valore della proprietà DataMember.Occurs when the DataMember property value has changed.

DataSourceChanged DataSourceChanged DataSourceChanged DataSourceChanged

Si verifica quando viene modificato il valore della proprietà DataSource.Occurs when the DataSource property value has changed.

Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
ListChanged ListChanged ListChanged ListChanged

Si verifica quando viene modificato l'elenco sottostante o uno dei relativi elementi.Occurs when the underlying list changes or an item in the list changes.

PositionChanged PositionChanged PositionChanged PositionChanged

Si verifica in seguito alla modifica del valore della proprietà Position.Occurs after the value of the Position property has changed.

Implementazioni dell'interfaccia esplicita

IBindingList.AddIndex(PropertyDescriptor) IBindingList.AddIndex(PropertyDescriptor) IBindingList.AddIndex(PropertyDescriptor) IBindingList.AddIndex(PropertyDescriptor)

Consente di aggiungere l'oggetto PropertyDescriptor agli indici utilizzati per la ricerca.Adds the PropertyDescriptor to the indexes used for searching.

IBindingList.RemoveIndex(PropertyDescriptor) IBindingList.RemoveIndex(PropertyDescriptor) IBindingList.RemoveIndex(PropertyDescriptor) IBindingList.RemoveIndex(PropertyDescriptor)

Consente di rimuovere l'oggetto PropertyDescriptor dagli indici utilizzati per la ricerca.Removes the PropertyDescriptor from the indexes used for searching.

ICancelAddNew.CancelNew(Int32) ICancelAddNew.CancelNew(Int32) ICancelAddNew.CancelNew(Int32) ICancelAddNew.CancelNew(Int32)

Elimina dall'insieme un nuovo elemento in sospeso.Discards a pending new item from the collection.

ICancelAddNew.EndNew(Int32) ICancelAddNew.EndNew(Int32) ICancelAddNew.EndNew(Int32) ICancelAddNew.EndNew(Int32)

Esegue il commit di un nuovo elemento in sospeso nell'insieme.Commits a pending new item to the collection.

ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit()

Segnala all'oggetto BindingSource l'avvio dell'inizializzazione.Signals the BindingSource that initialization is starting.

ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit()

Segnala all'oggetto BindingSource il completamento dell'inizializzazione.Signals the BindingSource that initialization is complete.

ISupportInitializeNotification.Initialized ISupportInitializeNotification.Initialized ISupportInitializeNotification.Initialized ISupportInitializeNotification.Initialized

Si verifica quando viene inizializzato l'oggetto BindingSource.Occurs when the BindingSource is initialized.

ISupportInitializeNotification.IsInitialized ISupportInitializeNotification.IsInitialized ISupportInitializeNotification.IsInitialized ISupportInitializeNotification.IsInitialized

Ottiene un valore che indica se l'oggetto BindingSource è inizializzato.Gets a value indicating whether the BindingSource is initialized.

Metodi di estensione

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche