DataRepeater Class
Displays data in a customizable list format.
Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)
Inheritance Hierarchy
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.ContainerControl
Microsoft.VisualBasic.PowerPacks.DataRepeater
Syntax
[ComplexBindingPropertiesAttribute("DataSource", "DataMember")]
[DefaultBindingPropertyAttribute("")]
[ToolboxBitmapAttribute(typeof(DataRepeater), "Microsoft.VisualBasic.PowerPacks.DataRepeater.bmp")]
[DockingAttribute(DockingBehavior.Ask)]
public class DataRepeater : ContainerControl
[ComplexBindingPropertiesAttribute("DataSource", "DataMember")]
[DefaultBindingPropertyAttribute("")]
[ToolboxBitmapAttribute((DataRepeater^::typeid), "Microsoft.VisualBasic.PowerPacks.DataRepeater.bmp")]
[DockingAttribute(DockingBehavior::Ask)]
public ref class DataRepeater : ContainerControl
[<ComplexBindingPropertiesAttribute("DataSource", "DataMember")>]
[<DefaultBindingPropertyAttribute("")>]
[<ToolboxBitmapAttribute(typeof(DataRepeater), "Microsoft.VisualBasic.PowerPacks.DataRepeater.bmp")>]
[<DockingAttribute(DockingBehavior.Ask)>]
type DataRepeater =
class
inherit ContainerControl
end
<ComplexBindingPropertiesAttribute("DataSource", "DataMember")>
<DefaultBindingPropertyAttribute("")>
<ToolboxBitmapAttribute(GetType(DataRepeater), "Microsoft.VisualBasic.PowerPacks.DataRepeater.bmp")>
<DockingAttribute(DockingBehavior.Ask)>
Public Class DataRepeater
Inherits ContainerControl
Constructors
Name | Description | |
---|---|---|
DataRepeater() | Initializes a new instance of the DataRepeater class. |
Properties
Name | Description | |
---|---|---|
AccessibilityObject | (Inherited from Control.) |
|
AccessibleDefaultActionDescription | (Inherited from Control.) |
|
AccessibleDescription | (Inherited from Control.) |
|
AccessibleName | (Inherited from Control.) |
|
AccessibleRole | (Inherited from Control.) |
|
ActiveControl | (Inherited from ContainerControl.) |
|
AllowDrop | (Inherited from Control.) |
|
AllowUserToAddItems | Gets or sets a value that determines whether users can add a new row to a DataRepeater at run time. |
|
AllowUserToDeleteItems | Gets or sets a value that determines whether users can delete a row from a DataRepeater at run time. |
|
Anchor | (Inherited from Control.) |
|
AutoScaleDimensions | (Inherited from ContainerControl.) |
|
AutoScaleFactor | (Inherited from ContainerControl.) |
|
AutoScaleMode | (Inherited from ContainerControl.) |
|
AutoScroll | (Inherited from ScrollableControl.) |
|
AutoScrollMargin | (Inherited from ScrollableControl.) |
|
AutoScrollMinSize | (Inherited from ScrollableControl.) |
|
AutoScrollOffset | (Inherited from Control.) |
|
AutoScrollPosition | (Inherited from ScrollableControl.) |
|
BackColor | (Inherited from Control.) |
|
BackgroundImage | (Inherited from Control.) |
|
BackgroundImageLayout | (Inherited from Control.) |
|
BindingContext | (Inherited from ContainerControl.) |
|
Bottom | (Inherited from Control.) |
|
Bounds | (Inherited from Control.) |
|
CanFocus | (Inherited from Control.) |
|
CanRaiseEvents | (Inherited from Control.) |
|
CanSelect | (Inherited from Control.) |
|
Capture | (Inherited from Control.) |
|
CausesValidation | (Inherited from Control.) |
|
ClientRectangle | (Inherited from Control.) |
|
ClientSize | (Inherited from Control.) |
|
CompanyName | (Inherited from Control.) |
|
Container | (Inherited from Component.) |
|
ContainsFocus | (Inherited from Control.) |
|
ContextMenu | (Inherited from Control.) |
|
ContextMenuStrip | (Inherited from Control.) |
|
Controls | (Inherited from Control.) |
|
Created | (Inherited from Control.) |
|
CreateParams | This API supports the product infrastructure and is not intended to be used directly from your code. This member overrides CreateParams.(Overrides ContainerControl.CreateParams.) |
|
CurrentAutoScaleDimensions | (Inherited from ContainerControl.) |
|
CurrentItem | Gets the current DataRepeaterItem in a DataRepeater control. |
|
CurrentItemIndex | Gets or sets the current DataRepeaterItem in a DataRepeater control. |
|
Cursor | (Inherited from Control.) |
|
DataBindings | (Inherited from Control.) |
|
DataMember | Gets or sets the name of the list or table in the data source for which the DataRepeater is displaying data. |
|
DataSource | Gets or sets the data source for which the DataRepeater is displaying data. |
|
DefaultCursor | (Inherited from Control.) |
|
DefaultImeMode | (Inherited from Control.) |
|
DefaultMargin | (Inherited from Control.) |
|
DefaultMaximumSize | (Inherited from Control.) |
|
DefaultMinimumSize | (Inherited from Control.) |
|
DefaultPadding | This API supports the product infrastructure and is not intended to be used directly from your code. This member overrides the DefaultPadding property.(Overrides Control.DefaultPadding.) |
|
DefaultSize | (Inherited from Control.) |
|
DesignMode | (Inherited from Component.) |
|
DisplayedItemCount[Boolean] | Gets the number of DataRepeaterItem items that are visible in a DataRepeater control, optionally including partially displayed items. |
|
DisplayRectangle | (Inherited from ScrollableControl.) |
|
Disposing | (Inherited from Control.) |
|
Dock | (Inherited from Control.) |
|
DoubleBuffered | (Inherited from Control.) |
|
Enabled | (Inherited from Control.) |
|
Events | (Inherited from Component.) |
|
FirstDisplayedItemIndex | Gets the index of the first currently displayed DataRepeaterItem in a DataRepeater control. |
|
Focused | (Inherited from Control.) |
|
Font | (Inherited from Control.) |
|
FontHeight | (Inherited from Control.) |
|
ForeColor | (Inherited from Control.) |
|
Handle | (Inherited from Control.) |
|
HasChildren | (Inherited from Control.) |
|
Height | (Inherited from Control.) |
|
HorizontalScroll | (Inherited from ScrollableControl.) |
|
HScroll | (Inherited from ScrollableControl.) |
|
ImeMode | (Inherited from Control.) |
|
InvokeRequired | (Inherited from Control.) |
|
IsAccessible | (Inherited from Control.) |
|
IsCurrentItemDirty | Gets a value that determines whether the data for a DataRepeaterItem in a DataRepeater control has been changed by a user. |
|
IsDisposed | (Inherited from Control.) |
|
IsHandleCreated | (Inherited from Control.) |
|
IsMirrored | (Inherited from Control.) |
|
ItemCount | Gets or sets the number of DataRepeaterItem items that are in a DataRepeater control. |
|
ItemHeaderSize | Gets or sets the size of the item header in a DataRepeater control. |
|
ItemHeaderVisible | Gets or sets a value that determines whether item headers are displayed in a DataRepeater control. |
|
ItemTemplate | Gets a template that represents the DataRepeaterItem for a DataRepeater control. |
|
LayoutEngine | (Inherited from Control.) |
|
LayoutStyle | Gets or sets a value that determines whether a DataRepeater control will be displayed with a vertical or horizontal orientation. |
|
Left | (Inherited from Control.) |
|
Location | (Inherited from Control.) |
|
Margin | (Inherited from Control.) |
|
MaximumSize | (Inherited from Control.) |
|
MinimumSize | (Inherited from Control.) |
|
Name | (Inherited from Control.) |
|
Padding | (Inherited from Control.) |
|
Parent | (Inherited from Control.) |
|
ParentForm | (Inherited from ContainerControl.) |
|
PreferredSize | (Inherited from Control.) |
|
ProductName | (Inherited from Control.) |
|
ProductVersion | (Inherited from Control.) |
|
RecreatingHandle | (Inherited from Control.) |
|
Region | (Inherited from Control.) |
|
RenderRightToLeft | (Inherited from Control.) |
|
ResizeRedraw | (Inherited from Control.) |
|
Right | (Inherited from Control.) |
|
RightToLeft | (Inherited from Control.) |
|
ScaleChildren | (Inherited from Control.) |
|
SelectionColor | Gets or sets the color that is displayed in the item header of a DataRepeater control when an item is first selected. |
|
ShowFocusCues | (Inherited from Control.) |
|
ShowKeyboardCues | (Inherited from Control.) |
|
Site | (Inherited from Control.) |
|
Size | (Inherited from Control.) |
|
TabIndex | (Inherited from Control.) |
|
TabStop | (Inherited from Control.) |
|
Tag | (Inherited from Control.) |
|
Text | (Inherited from Control.) |
|
Top | (Inherited from Control.) |
|
TopLevelControl | (Inherited from Control.) |
|
UseWaitCursor | (Inherited from Control.) |
|
VerticalScroll | (Inherited from ScrollableControl.) |
|
VirtualMode | Gets or sets a value that indicates whether you have provided your own data-management operations for the DataRepeater control. |
|
Visible | (Inherited from Control.) |
|
VScroll | (Inherited from ScrollableControl.) |
|
Width | (Inherited from Control.) |
Methods
Events
Name | Description | |
---|---|---|
AllowUserToAddItemsChanged | Occurs when the AllowUserToAddItems property changes. |
|
AllowUserToDeleteItemsChanged | Occurs when the AllowUserToDeleteItems property changes. |
|
BackColorChanged | (Inherited from Control.) |
|
BackgroundImageChanged | (Inherited from Control.) |
|
BackgroundImageLayoutChanged | (Inherited from Control.) |
|
BindingContextChanged | (Inherited from Control.) |
|
CausesValidationChanged | (Inherited from Control.) |
|
ChangeUICues | (Inherited from Control.) |
|
Click | (Inherited from Control.) |
|
ClientSizeChanged | (Inherited from Control.) |
|
ContextMenuChanged | (Inherited from Control.) |
|
ContextMenuStripChanged | (Inherited from Control.) |
|
ControlAdded | (Inherited from Control.) |
|
ControlRemoved | (Inherited from Control.) |
|
CurrentItemIndexChanged | Occurs when the CurrentItemIndex changes. |
|
CursorChanged | (Inherited from Control.) |
|
DataError | Occurs when an external data-parsing or validation operation throws an exception, or when an attempt to commit data to a data source fails. |
|
DataMemberChanged | Occurs when the DataMember property changes. |
|
DataSourceChanged | Occurs when the DataSource property is changed. |
|
DeletingItems | Occurs when a DataRepeaterItem is being deleted. |
|
Disposed | (Inherited from Component.) |
|
DockChanged | (Inherited from Control.) |
|
DoubleClick | (Inherited from Control.) |
|
DragDrop | (Inherited from Control.) |
|
DragEnter | (Inherited from Control.) |
|
DragLeave | (Inherited from Control.) |
|
DragOver | (Inherited from Control.) |
|
DrawItem | Occurs when a DataRepeaterItem must be drawn. |
|
EnabledChanged | (Inherited from Control.) |
|
Enter | (Inherited from Control.) |
|
FontChanged | (Inherited from Control.) |
|
ForeColorChanged | (Inherited from Control.) |
|
GiveFeedback | (Inherited from Control.) |
|
GotFocus | (Inherited from Control.) |
|
HandleCreated | (Inherited from Control.) |
|
HandleDestroyed | (Inherited from Control.) |
|
HelpRequested | (Inherited from Control.) |
|
ImeModeChanged | (Inherited from Control.) |
|
Invalidated | (Inherited from Control.) |
|
ItemCloned | Occurs after the DataRepeaterItem and its controls are cloned from the ItemTemplate. |
|
ItemCloning | Occurs before the DataRepeaterItem and its controls are cloned from the ItemTemplate. |
|
ItemHeaderVisibleChanged | Occurs when the ItemHeaderVisible property changes. |
|
ItemsAdded | Occurs when a new DataRepeaterItem is added to a DataRepeater control. |
|
ItemsRemoved | Occurs when a DataRepeaterItem is deleted from a DataRepeater control. |
|
ItemValueNeeded | Occurs when the VirtualMode property is set to True and a new value for a child control of a DataRepeaterItem is needed. |
|
ItemValuePushed | Occurs when the VirtualMode property is set to True and the value of a child control in the DataRepeaterItem changes. |
|
KeyDown | (Inherited from Control.) |
|
KeyPress | (Inherited from Control.) |
|
KeyUp | (Inherited from Control.) |
|
Layout | (Inherited from Control.) |
|
LayoutStyleChanged | Occurs when the LayoutStyle property value changes. |
|
Leave | (Inherited from Control.) |
|
LocationChanged | (Inherited from Control.) |
|
LostFocus | (Inherited from Control.) |
|
MarginChanged | (Inherited from Control.) |
|
MouseCaptureChanged | (Inherited from Control.) |
|
MouseClick | (Inherited from Control.) |
|
MouseDoubleClick | (Inherited from Control.) |
|
MouseDown | (Inherited from Control.) |
|
MouseEnter | (Inherited from Control.) |
|
MouseHover | (Inherited from Control.) |
|
MouseLeave | (Inherited from Control.) |
|
MouseMove | (Inherited from Control.) |
|
MouseUp | (Inherited from Control.) |
|
MouseWheel | (Inherited from Control.) |
|
Move | (Inherited from Control.) |
|
NewItemNeeded | Occurs when the VirtualMode property is set to True and the user creates a new blank DataRepeaterItem. |
|
PaddingChanged | (Inherited from Control.) |
|
Paint | (Inherited from Control.) |
|
ParentChanged | (Inherited from Control.) |
|
PreviewKeyDown | (Inherited from Control.) |
|
QueryAccessibilityHelp | (Inherited from Control.) |
|
QueryContinueDrag | (Inherited from Control.) |
|
RegionChanged | (Inherited from Control.) |
|
Resize | (Inherited from Control.) |
|
RightToLeftChanged | (Inherited from Control.) |
|
Scroll | (Inherited from ScrollableControl.) |
|
SelectionColorChanged | Occurs when the SelectionColor property is changed. |
|
SizeChanged | (Inherited from Control.) |
|
StyleChanged | (Inherited from Control.) |
|
SystemColorsChanged | (Inherited from Control.) |
|
TabIndexChanged | (Inherited from Control.) |
|
TabStopChanged | (Inherited from Control.) |
|
TextChanged | (Inherited from Control.) |
|
UserAddedItems | Occurs when the user adds a new DataRepeaterItem by pressing the CTRL+N keyboard shortcut. |
|
UserDeletedItems | Occurs after the user deletes a DataRepeaterItem by pressing the DELETE key. |
|
UserDeletingItems | Occurs when the user deletes a DataRepeaterItem by pressing the DELETE key. |
|
Validated | (Inherited from Control.) |
|
Validating | (Inherited from Control.) |
|
VirtualModeChanged | Occurs when the VirtualMode property is changed. |
|
VisibleChanged | (Inherited from Control.) |
Explicit Interface Implementations
Name | Description | |
---|---|---|
IContainerControl.ActivateControl(Control) | (Inherited from ContainerControl.) |
|
IDropTarget.OnDragDrop(DragEventArgs) | (Inherited from Control.) |
|
IDropTarget.OnDragEnter(DragEventArgs) | (Inherited from Control.) |
|
IDropTarget.OnDragLeave(EventArgs) | (Inherited from Control.) |
|
IDropTarget.OnDragOver(DragEventArgs) | (Inherited from Control.) |
Remarks
The DataRepeater control functions as a scrollable container for controls that display repeated data, for example, rows in a database table. It can be used as an alternative to the DataGridView control when you need more control over the layout of the data.
You can use a DataRepeater control to display data with or without an underlying data source. For more information, see How to: Display Bound Data in a DataRepeater Control (Visual Studio).
Without specifying a data source, you can create rows that contain data and add them to the DataRepeater.
When working with large amounts of data, you can set the VirtualMode property to True to display a subset of the available data. Virtual mode requires the implementation of a data cache from which the DataRepeater control is populated. For more information, see Virtual Mode in the DataRepeater Control (Visual Studio).
For additional information about the features available in the DataRepeater control, see Introduction to the DataRepeater Control (Visual Studio).
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also
Microsoft.VisualBasic.PowerPacks Namespace
Introduction to the DataRepeater Control (Visual Studio)
How to: Display Bound Data in a DataRepeater Control (Visual Studio)
How to: Display Unbound Controls in a DataRepeater Control (Visual Studio)
How to: Change the Layout of a DataRepeater Control (Visual Studio)
How to: Change the Appearance of a DataRepeater Control (Visual Studio)
How to: Display Item Headers in a DataRepeater Control (Visual Studio)
How to: Disable Adding and Deleting DataRepeater Items (Visual Studio)
How to: Search Data in a DataRepeater Control (Visual Studio)
How to: Create a Master/Detail Form by Using Two DataRepeater Controls (Visual Studio)
Walkthrough: Displaying Data in a DataRepeater Control (Visual Studio)
Return to top