DataBoundControl.PerformDataBinding(IEnumerable) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase derivada, enlaza los datos del origen de datos al control.
protected public:
virtual void PerformDataBinding(System::Collections::IEnumerable ^ data);protected internal virtual void PerformDataBinding (System.Collections.IEnumerable data);abstract member PerformDataBinding : System.Collections.IEnumerable -> unit
override this.PerformDataBinding : System.Collections.IEnumerable -> unitProtected Friend Overridable Sub PerformDataBinding (data As IEnumerable)Parámetros
- data
- IEnumerable
La lista IEnumerable de los datos devueltos por una llamada al método PerformSelect().
Ejemplos
En el ejemplo de código siguiente se muestra cómo implementar el PerformDataBinding método en una clase derivada de DataBoundControl. El TextBoxSet control crea un TextBox control para cada elemento de datos al que está enlazado. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase DataBoundControl.
protected override void PerformDataBinding(IEnumerable retrievedData) {
base.PerformDataBinding(retrievedData);
// If the data is retrieved from an IDataSource as an
// IEnumerable collection, attempt to bind its values to a
// set of TextBox controls.
if (retrievedData != null) {
foreach (object dataItem in retrievedData) {
TextBox box = new TextBox();
// The dataItem is not just a string, but potentially
// a System.Data.DataRowView or some other container.
// If DataTextField is set, use it to determine which
// field to render. Otherwise, use the first field.
if (DataTextField.Length > 0) {
box.Text = DataBinder.GetPropertyValue(dataItem,
DataTextField, null);
}
else {
PropertyDescriptorCollection props =
TypeDescriptor.GetProperties(dataItem);
// Set the "default" value of the TextBox.
box.Text = String.Empty;
// Set the true data-bound value of the TextBox,
// if possible.
if (props.Count >= 1) {
if (null != props[0].GetValue(dataItem)) {
box.Text = props[0].GetValue(dataItem).ToString();
}
}
}
BoxSet.Add(box);
}
}
}
Protected Overrides Sub PerformDataBinding(ByVal retrievedData As IEnumerable)
MyBase.PerformDataBinding(retrievedData)
' If the data is retrieved from an IDataSource as an IEnumerable
' collection, attempt to bind its values to a set of TextBox controls.
If Not (retrievedData Is Nothing) Then
Dim dataItem As Object
For Each dataItem In retrievedData
Dim box As New TextBox()
' The dataItem is not just a string, but potentially
' a System.Data.DataRowView or some other container.
' If DataTextField is set, use it to determine which
' field to render. Otherwise, use the first field.
If DataTextField.Length > 0 Then
box.Text = DataBinder.GetPropertyValue( _
dataItem, DataTextField, Nothing)
Else
Dim props As PropertyDescriptorCollection = _
TypeDescriptor.GetProperties(dataItem)
' Set the "default" value of the TextBox.
box.Text = String.Empty
' Set the true data-bound value of the TextBox,
' if possible.
If props.Count >= 1 Then
If props(0).GetValue(dataItem) IsNot Nothing Then
box.Text = props(0).GetValue(dataItem).ToString()
End If
End If
End If
BoxSet.Add(box)
Next dataItem
End If
End Sub
Comentarios
Implemente este método en lugar del DataBind método cuando derive un control enlazado a datos de la DataBoundControl clase . Colocar la lógica de enlace de datos del control en PerformDataBinding le permite evitar que los DataBinding eventos y DataBound se generen en el orden incorrecto.
Aunque la clase base DataBoundControl no proporciona ninguna implementación específica para este método, el PerformDataBindingPerformSelect método llama al método para enlazar los valores de cualquier control de interfaz de usuario (UI) a los datos recuperados por el PerformSelect método .
