# DataRepeater

Namespace: **Wisej.Web**

Assembly: **Wisej.Framework** (2.5.0.0)

* [Control](https://docs.wisej.com/api/v2.5/wisej.web/general/control)
  * [ScrollableControl](https://docs.wisej.com/api/v2.5/wisej.web/containers/scrollablecontrol)
    * [ContainerControl](https://docs.wisej.com/api/v2.5/wisej.web/containers/containercontrol)
      * [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater)

Displays data in a customizable list format.

{% tabs %}
{% tab title="C#" %}

```csharp
public class DataRepeater : ContainerControl, ISupportInitialize
```

{% endtab %}

{% tab title="VB.NET" %}

```visual-basic
Public Class DataRepeater
    Inherits ContainerControl
    Implements ISupportInitialize
```

{% endtab %}
{% endtabs %}

## Constructors

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DataRepeater()

Initializes a new instance of the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) class.

## Properties

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)AllowUserToAddItems

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Returns or sets whether users can add a new row to the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) at run time.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)AllowUserToDeleteItems

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Returns or sets whether users can delete a row from the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) at run time.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)BorderStyle

[BorderStyle](https://docs.wisej.com/api/v2.5/wisej.web/enumerations/wisej.web.borderstyle): Returns or sets the border style for the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)CurrentItem

[DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem): Returns the current [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) in the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)CurrentItemIndex

[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32): Returns or sets the index of the current [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) in a [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DataMember

[String](https://docs.microsoft.com/en-us/dotnet/api/system.string): Return or sets the name of the list or table in the data source for which the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) is displaying data.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DataSource

[Object](https://docs.microsoft.com/en-us/dotnet/api/system.object): Returns or sets the data source for which the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) is displaying data.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DisplayedItems

[DataRepeaterItem\[\]](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem): Returns the list of [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) items currently displayed on the client.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)FirstDisplayedItemIndex

[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32): Return the index of the first currently displayed [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) in a [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)IsCurrentItemModified

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Return whether the data for a [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) in the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control has been changed by a user.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemBorderStyle

[BorderStyle](https://docs.wisej.com/api/v2.5/wisej.web/enumerations/wisej.web.borderstyle): Returns or sets the border style for the items in a [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemCount

[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32): Returns or sets the number of [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) items that are in the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemHeaderSize

[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32): Return sets the size of the item header in a [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemHeaderVisible

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Returns or sets whether item headers are displayed in a [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemSelectedBackColor

[Color](https://docs.microsoft.com/en-us/dotnet/api/system.drawing.color): Returns or sets the background color for the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) panel when it's the [CurrentItem](#currentitem).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemSize

[Size](https://docs.microsoft.com/en-us/dotnet/api/system.drawing.size): Returns or sets the size of the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) child panels.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemTemplate

[DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem): Returns the template that represents the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) for the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)LayoutStyle

[DataRepeaterLayoutStyles](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeaterlayoutstyles): Return or sets whether the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control will be displayed with a vertical or horizontal orientation.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)PrefetchItems

[Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32): Returns or sets the number of items to prefetch outside of the visible area. The default is 0 (disabled).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)RightToLeftLayout

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Enables or disables right-to-left layout when the value of [RightToLeft](https://docs.wisej.com/api/v2.5/general/control#righttoleft) is [Yes](https://docs.wisej.com/api/v2.5/enumerations/wisej.web.righttoleft#fields)

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ScrollBarVisible

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Returns or sets whether the scrollbar is visible. When the scrollbar is hidden, the user can still scroll using touch events, the keyboard, or the wheel.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)VirtualMode

[Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Returns or sets a value that indicates whether you have provided your own data-management operations for the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

## Methods

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)AddNew()

Adds a new [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) to the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

**Throws:**

* [ReadOnlyException](https://docs.microsoft.com/en-us/dotnet/api/system.data.readonlyexception) The [AllowUserToAddItems](#allowusertoadditems) property is set to False.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)CancelEdit()

Allows users to cancel an edit to the current child control in the current [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)Refresh()

Forces a full reload of the data displayed by this [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)Refresh(refreshChildren)

Forces a full reload of the data displayed by this [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater).

| Parameter           | Type                                                                  | Description                                            |
| ------------------- | --------------------------------------------------------------------- | ------------------------------------------------------ |
| **refreshChildren** | [Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean) | True to also refresh all the children of this control. |

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)RemoveAt(index)

Removes a [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) at the specified position from a [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

| Parameter | Type                                                              | Description                                                                                                                        |
| --------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **index** | [Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32) | The index of the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem). |

**Throws:**

* [ArgumentOutOfRangeException](https://docs.microsoft.com/en-us/dotnet/api/system.argumentoutofrangeexception) The value specified for *index* is less than 0 or greater than [ItemCount](#itemcount) - 1.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ResetItemBorderStyle()

Resets the value of [ItemBorderStyle](#itemborderstyle) to the original value.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ResetItemHeaderSize()

Resets the value of [ItemHeaderSize](#itemheadersize) to the original value.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ResetItemHeaderVisible()

Resets the value of [ItemHeaderVisible](#itemheadervisible) to the original value.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ScrollItemIntoView(index)

Scrolls the specified [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) into view.

| Parameter | Type                                                              | Description                                                                                                                        |
| --------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **index** | [Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32) | The index of the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem). |

**Throws:**

* [ArgumentOutOfRangeException](https://docs.microsoft.com/en-us/dotnet/api/system.argumentoutofrangeexception) The value specified for *index* is less than 0 or greater than [ItemCount](#itemcount) - 1.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ScrollItemIntoView(index, alignWithTop)

Scrolls a specified [DataRepeaterItem](https://docs.microsoft.com/en-us/dotnet/api/microsoft.visualbasic.powerpacks.datarepeateritem) into view, optionally aligning it with the top of the control.

| Parameter        | Type                                                                  | Description                                                                                                                                                                                  |
| ---------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **index**        | [Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32)     | The index of the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem).                                                           |
| **alignWithTop** | [Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean) | true to align the top of the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) with the top of the control; otherwise, false. |

**Throws:**

* [ArgumentOutOfRangeException](https://docs.microsoft.com/en-us/dotnet/api/system.argumentoutofrangeexception) The value specified for *index* is less than 0 or greater than [ItemCount](#itemcount) - 1.

## Events

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)AllowUserToAddItemsChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [AllowUserToAddItems](#allowusertoadditems) property changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)AllowUserToDeleteItemsChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [AllowUserToDeleteItems](#allowusertodeleteitems) property changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)CurrentItemIndexChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the property [CurrentItemIndex](#currentitemindex) changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DataError

[DataRepeaterDataErrorEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeaterdataerroreventhandler) Fired when an external data-parsing or validation operation throws an exception, or when an attempt to commit data to a data source fails.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DataMemberChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [DataMember](#datamember) property changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)DataSourceChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [DataSource](#datasource) property changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemCloned

[DataRepeaterItemEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritemeventhandler) Fired after the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) and its controls are cloned from the [ItemTemplate](#itemtemplate).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemCloning

[DataRepeaterItemCloneEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritemcloneeventhandler) Fired before the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) and its controls are cloned from the [ItemTemplate](#itemtemplate).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemsAdded

[DataRepeaterAddRemoveItemsEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateraddremoveitemseventhandler) Fired when a new [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) is added to the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemSelected

[DataRepeaterItemEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritemeventhandler) Fired after the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) becomes the current item.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemsRemoved

[DataRepeaterAddRemoveItemsEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateraddremoveitemseventhandler) Fired when a [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) is deleted from the [DataRepeater](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater) control.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemUpdate

[DataRepeaterItemEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritemeventhandler) Fired when an instance of [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) is updated.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemValueNeeded

[DataRepeaterItemValueEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritemvalueeventhandler) Fired when the [VirtualMode](#virtualmode) property is set to true and a new value for a child control of a [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) is needed.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)ItemValuePushed

[DataRepeaterItemValueEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritemvalueeventhandler) Fired when the [VirtualMode](#virtualmode) property is set to true and the value of a child control in the [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem) changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)LayoutStyleChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [LayoutStyle](#layoutstyle) property changes.

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)NewItemNeeded

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [VirtualMode](#virtualmode) property is set to true and the user creates a new [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)UserAddedItems

[DataRepeaterAddRemoveItemsEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateraddremoveitemseventhandler) Fired when the user adds a new [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)UserDeletedItems

[DataRepeaterAddRemoveItemsEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateraddremoveitemseventhandler) Fired after the user deletes a [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)UserDeletingItems

[DataRepeaterAddRemoveItemsCancelEventHandler](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateraddremoveitemscanceleventhandler) Fired when the user deletes a [DataRepeaterItem](https://docs.wisej.com/api/v2.5/wisej.web/containers/datarepeater/wisej.web.datarepeateritem).

### ![](https://314832588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MTHCfAYyBPycFG90wsw-4198400543%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media\&token=060b281d-9363-48a1-a0f9-788ad1831e96)VirtualModeChanged

[EventHandler](https://docs.microsoft.com/en-us/dotnet/api/system.eventhandler) Fired when the [VirtualMode](#virtualmode) property changes.

## Implements

| Name                                                                                                      | Description                                                                                                                                   |
| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| [IBindableComponent](https://docs.wisej.com/api/v2.5/wisej.web/data-binding/wisej.web.ibindablecomponent) | Bindable components implement this interface.                                                                                                 |
| [IContainerControl](https://docs.wisej.com/api/v2.5/wisej.web/interfaces/wisej.web.icontainercontrol)     | Provides the functionality for a control to act as a parent for other controls.                                                               |
| [IWisejComponent](https://docs.wisej.com/api/v2.5/wisej.core/interfaces/wisej.core.iwisejcomponent)       | All wisej components implement this interface.                                                                                                |
| [IWisejControl](https://docs.wisej.com/api/v2.5/wisej.core/interfaces/wisej.core.iwisejcontrol)           | All wisej controls derived from the [Control](https://docs.wisej.com/api/v2.5/wisej.web/general/control) class must implement this interface. |
| [IWisejSerializable](https://docs.wisej.com/api/v2.5/wisej.core/interfaces/wisej.core.iwisejserializable) | Allows an object to serialize itself.                                                                                                         |
