BindingSource.Find Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Trovare l'elemento specificato nell'origine dati.
Overload
| Nome | Descrizione |
|---|---|
| Find(PropertyDescriptor, Object) |
Cerca l'indice dell'elemento con il descrittore di proprietà specificato. |
| Find(String, Object) |
Restituisce l'indice dell'elemento nell'elenco con il nome e il valore della proprietà specificati. |
Find(PropertyDescriptor, Object)
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
Cerca l'indice dell'elemento con il descrittore di proprietà specificato.
public:
virtual int Find(System::ComponentModel::PropertyDescriptor ^ prop, System::Object ^ key);
public virtual int Find(System.ComponentModel.PropertyDescriptor prop, object key);
abstract member Find : System.ComponentModel.PropertyDescriptor * obj -> int
override this.Find : System.ComponentModel.PropertyDescriptor * obj -> int
Public Overridable Function Find (prop As PropertyDescriptor, key As Object) As Integer
Parametri
- prop
- PropertyDescriptor
Oggetto PropertyDescriptor da cercare.
- key
- Object
Valore di prop da trovare.
Valori restituiti
Indice in base zero dell'elemento con il valore specificato per PropertyDescriptor.
Implementazioni
Eccezioni
L'elenco sottostante non è di tipo IBindingList.
Esempio
Nell'esempio di codice seguente viene illustrato come usare il Find metodo . Per l'esempio completo, vedere l'argomento panoramica della classe.
void button1_Click(object sender, EventArgs e)
{
if (!binding1.SupportsSearching)
{
_ = 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.");
}
}
}
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
Commenti
Questo metodo viene in genere usato in casi complessi di data binding per individuare la prima riga in cui il valore del campo specificato dal prop parametro è uguale al valore del key parametro
Questo metodo fa semplicemente riferimento alla richiesta al metodo dell'elenco IBindingList.Find sottostante. Ad esempio, se l'origine dati sottostante è un DataSetoggetto , DataTableo DataView, questo metodo chiama il DataView.IBindingList.Find metodo . Il comportamento di IBindingList.Find, ad esempio il valore restituito se non viene trovato alcun elemento corrispondente, dipende dall'implementazione del metodo nell'elenco sottostante.
Vedi anche
Si applica a
Find(String, Object)
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
- Origine:
- BindingSource.cs
Restituisce l'indice dell'elemento nell'elenco con il nome e il valore della proprietà specificati.
public:
int Find(System::String ^ propertyName, System::Object ^ key);
public int Find(string propertyName, object key);
member this.Find : string * obj -> int
Public Function Find (propertyName As String, key As Object) As Integer
Parametri
- propertyName
- String
Nome della proprietà da cercare.
- key
- Object
Valore dell'elemento con l'oggetto specificato propertyName da trovare.
Valori restituiti
Indice in base zero dell'elemento con il nome e il valore della proprietà specificati.
Eccezioni
L'elenco sottostante non è un IBindingList oggetto con la funzionalità di ricerca implementata.
propertyName non corrisponde a una proprietà nell'elenco.
Esempio
Nell'esempio seguente viene illustrato come usare il Find metodo con un oggetto DataView. Per eseguire questo esempio, incollare il codice in un Windows Form e chiamare PopulateDataViewAndFind dal costruttore del modulo o Load dal metodo di gestione degli eventi. Il modulo deve importare gli System.Xml spazi dei nomi e System.IO .
private void PopulateDataViewAndFind()
{
DataSet set1 = new DataSet();
// Some xml data to populate the DataSet with.
string musicXml =
"<?xml version='1.0' encoding='UTF-8'?>" +
"<music>" +
"<recording><artist>Coldplay</artist><cd>X&Y</cd></recording>" +
"<recording><artist>Dave Matthews</artist><cd>Under the Table and Dreaming</cd></recording>" +
"<recording><artist>Natalie Merchant</artist><cd>Tigerlily</cd></recording>" +
"<recording><artist>U2</artist><cd>How to Dismantle an Atomic Bomb</cd></recording>" +
"</music>";
// Read the xml.
StringReader reader = new StringReader(musicXml);
set1.ReadXml(reader);
// Get a DataView of the table contained in the dataset.
DataTableCollection tables = set1.Tables;
DataView view1 = new DataView(tables[0]);
// Create a DataGridView control and add it to the form.
DataGridView datagridview1 = new DataGridView();
datagridview1.AutoGenerateColumns = true;
this.Controls.Add(datagridview1);
// Create a BindingSource and set its DataSource property to
// the DataView.
BindingSource source1 = new BindingSource();
source1.DataSource = view1;
// Set the data source for the DataGridView.
datagridview1.DataSource = source1;
// Set the Position property to the results of the Find method.
int itemFound = source1.Find("artist", "Natalie Merchant");
source1.Position = itemFound;
}
Private Sub PopulateDataViewAndFind()
Dim set1 As New DataSet()
' Some xml data to populate the DataSet with.
Dim musicXml As String = "<?xml version='1.0' encoding='UTF-8'?>" & _
"<music>" & _
"<recording><artist>Coldplay</artist><cd>X&Y</cd></recording>" & _
"<recording><artist>Dave Matthews</artist><cd>Under the Table and Dreaming</cd></recording>" & _
"<recording><artist>Natalie Merchant</artist><cd>Tigerlily</cd></recording>" & _
"<recording><artist>U2</artist><cd>How to Dismantle an Atomic Bomb</cd></recording>" & _
"</music>"
' Read the xml.
Dim reader As New StringReader(musicXml)
set1.ReadXml(reader)
' Get a DataView of the table contained in the dataset.
Dim tables As DataTableCollection = set1.Tables
Dim view1 As New DataView(tables(0))
' Create a DataGridView control and add it to the form.
Dim datagridview1 As New DataGridView()
datagridview1.AutoGenerateColumns = True
Me.Controls.Add(datagridview1)
' Create a BindingSource and set its DataSource property to
' the DataView.
Dim source1 As New BindingSource()
source1.DataSource = view1
' Set the data source for the DataGridView.
datagridview1.DataSource = source1
' Set the Position property to the results of the Find method.
Dim itemFound As Integer = source1.Find("artist", "Natalie Merchant")
source1.Position = itemFound
End Sub
Commenti
Il Find metodo può essere utilizzato solo quando l'elenco sottostante è un IBindingList oggetto con la ricerca implementata. Questo metodo fa semplicemente riferimento alla richiesta al metodo dell'elenco IBindingList.Find sottostante. Ad esempio, se l'origine dati sottostante è un DataSetoggetto , DataTableo DataView, questo metodo viene convertito propertyName in e PropertyDescriptor chiama il IBindingList.Find metodo . Il comportamento di Find, ad esempio il valore restituito se non viene trovato alcun elemento corrispondente, dipende dall'implementazione del metodo nell'elenco sottostante.
Il confronto tra nomi di proprietà non fa distinzione tra maiuscole e minuscole.