Export (0) Print
Expand All

DataGrid Class

Displays ADO.NET data in a scrollable grid. The DataGridView control replaces and adds functionality to the DataGrid control; however, the DataGrid control is retained for both backward compatibility and future use, if you choose.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

'Declaration
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
<ComplexBindingPropertiesAttribute("DataSource", "DataMember")> _
<ComVisibleAttribute(True)> _
Public Class DataGrid _
	Inherits Control _
	Implements ISupportInitialize, IDataGridEditingService

The DataGrid type exposes the following members.

  NameDescription
Public methodDataGridInitializes a new instance of the System.Windows.Forms.DataGrid class.
Top

  NameDescription
Public propertyAccessibilityObjectGets the AccessibleObject assigned to the control. (Inherited from Control.)
Public propertyAccessibleDefaultActionDescriptionGets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleDescriptionGets or sets the description of the control used by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleNameGets or sets the name of the control used by accessibility client applications. (Inherited from Control.)
Public propertyAccessibleRoleGets or sets the accessible role of the control (Inherited from Control.)
Public propertyAllowDropGets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control.)
Public propertyAllowNavigationGets or sets a value indicating whether navigation is allowed.
Public propertyAllowSortingGets or sets a value indicating whether the grid can be resorted by clicking on a column header.
Public propertyAlternatingBackColorGets or sets the background color of odd-numbered rows of the grid.
Public propertyAnchorGets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent. (Inherited from Control.)
Public propertyAutoScrollOffsetGets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.)
Public propertyAutoSizeInfrastructure. This property is not relevant for this class. (Inherited from Control.)
Public propertyBackColorGets or sets the background color of even-numbered rows of the grid. (Overrides Control.BackColor.)
Public propertyBackgroundColorGets or sets the color of the non-row area of the grid.
Public propertyBackgroundImageInfrastructure. This member is not meaningful for this control. (Overrides Control.BackgroundImage.)
Public propertyBackgroundImageLayoutInfrastructure. This member is not meaningful for this control. (Overrides Control.BackgroundImageLayout.)
Public propertyBindingContextGets or sets the BindingContext for the control. (Inherited from Control.)
Public propertyBorderStyleGets or sets the grid's border style.
Public propertyBottomGets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area. (Inherited from Control.)
Public propertyBoundsGets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control.)
Protected propertyCanEnableImeGets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. (Inherited from Control.)
Public propertyCanFocusGets a value indicating whether the control can receive focus. (Inherited from Control.)
Protected propertyCanRaiseEventsDetermines if events can be raised on the control. (Inherited from Control.)
Public propertyCanSelectGets a value indicating whether the control can be selected. (Inherited from Control.)
Public propertyCaptionBackColorGets or sets the background color of the caption area.
Public propertyCaptionFontGets or sets the font of the grid's caption.
Public propertyCaptionForeColorGets or sets the foreground color of the caption area.
Public propertyCaptionTextGets or sets the text of the grid's window caption.
Public propertyCaptionVisibleGets or sets a value that indicates whether the grid's caption is visible.
Public propertyCaptureGets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.)
Public propertyCausesValidationGets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus. (Inherited from Control.)
Public propertyClientRectangleGets the rectangle that represents the client area of the control. (Inherited from Control.)
Public propertyClientSizeGets or sets the height and width of the client area of the control. (Inherited from Control.)
Public propertyColumnHeadersVisibleGets or sets a value indicating whether the column headers of a table are visible.
Public propertyCompanyNameGets the name of the company or creator of the application containing the control. (Inherited from Control.)
Public propertyContainerGets the IContainer that contains the Component. (Inherited from Component.)
Public propertyContainsFocusGets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
Public propertyContextMenuGets or sets the shortcut menu associated with the control. (Inherited from Control.)
Public propertyContextMenuStripGets or sets the ContextMenuStrip associated with this control. (Inherited from Control.)
Public propertyControlsGets the collection of controls contained within the control. (Inherited from Control.)
Public propertyCreatedGets a value indicating whether the control has been created. (Inherited from Control.)
Protected propertyCreateParamsGets the required creation parameters when the control handle is created. (Inherited from Control.)
Public propertyCurrentCellGets or sets which cell has the focus. Not available at design time.
Public propertyCurrentRowIndexGets or sets index of the row that currently has focus.
Public propertyCursorInfrastructure. This member is not meaningful for this control. (Overrides Control.Cursor.)
Public propertyDataBindingsGets the data bindings for the control. (Inherited from Control.)
Public propertyDataMemberGets or sets the specific list in a DataSource for which the System.Windows.Forms.DataGrid control displays a grid.
Public propertyDataSourceGets or sets the data source that the grid is displaying data for.
Protected propertyDefaultCursorGets or sets the default cursor for the control. (Inherited from Control.)
Protected propertyDefaultImeModeGets the default Input Method Editor (IME) mode supported by the control. (Inherited from Control.)
Protected propertyDefaultMarginGets the space, in pixels, that is specified by default between controls. (Inherited from Control.)
Protected propertyDefaultMaximumSizeGets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control.)
Protected propertyDefaultMinimumSizeGets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control.)
Protected propertyDefaultPaddingGets the internal spacing, in pixels, of the contents of a control. (Inherited from Control.)
Protected propertyDefaultSizeGets the default size of the control. (Overrides Control.DefaultSize.)
Protected propertyDesignModeGets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public propertyDisplayRectangleGets the rectangle that represents the display area of the control. (Inherited from Control.)
Public propertyDisposingGets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.)
Public propertyDockGets or sets which control borders are docked to its parent control and determines how a control is resized with its parent. (Inherited from Control.)
Protected propertyDoubleBufferedGets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker. (Inherited from Control.)
Public propertyEnabledGets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control.)
Protected propertyEventsGets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public propertyFirstVisibleColumnGets the index of the first visible column in a grid.
Public propertyFlatModeGets or sets a value indicating whether the grid displays in flat mode.
Public propertyFocusedGets a value indicating whether the control has input focus. (Inherited from Control.)
Public propertyFontGets or sets the font of the text displayed by the control. (Inherited from Control.)
Protected propertyFontHeightGets or sets the height of the font of the control. (Inherited from Control.)
Public propertyForeColorGets or sets the foreground color (typically the color of the text) property of the System.Windows.Forms.DataGrid control. (Overrides Control.ForeColor.)
Public propertyGridLineColorGets or sets the color of the grid lines.
Public propertyGridLineStyleGets or sets the line style of the grid.
Public propertyHandleGets the window handle that the control is bound to. (Inherited from Control.)
Public propertyHasChildrenGets a value indicating whether the control contains one or more child controls. (Inherited from Control.)
Public propertyHeaderBackColorGets or sets the background color of all row and column headers.
Public propertyHeaderFontGets or sets the font used for column headers.
Public propertyHeaderForeColorGets or sets the foreground color of headers.
Public propertyHeightGets or sets the height of the control. (Inherited from Control.)
Protected propertyHorizScrollBarGets the horizontal scroll bar for the grid.
Public propertyImeModeGets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control.)
Protected propertyImeModeBaseGets or sets the IME mode of a control. (Inherited from Control.)
Public propertyInvokeRequiredGets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on. (Inherited from Control.)
Public propertyIsAccessibleGets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.)
Public propertyIsDisposedGets a value indicating whether the control has been disposed of. (Inherited from Control.)
Public propertyIsHandleCreatedGets a value indicating whether the control has a handle associated with it. (Inherited from Control.)
Public propertyIsMirroredGets a value indicating whether the control is mirrored. (Inherited from Control.)
Public propertyItem(DataGridCell)Gets or sets the value of a specified DataGridCell.
Public propertyItem(Int32, Int32)Gets or sets the value of the cell at the specified the row and column.
Public propertyLayoutEngineGets a cached instance of the control's layout engine. (Inherited from Control.)
Public propertyLeftGets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area. (Inherited from Control.)
Public propertyLinkColorGets or sets the color of the text that you can click to navigate to a child table.
Public propertyLinkHoverColorInfrastructure. This member is not meaningful for this control.
Protected propertyListManagerGets the CurrencyManager for this System.Windows.Forms.DataGrid control.
Public propertyLocationGets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container. (Inherited from Control.)
Public propertyMarginGets or sets the space between controls. (Inherited from Control.)
Public propertyMaximumSizeGets or sets the size that is the upper limit that GetPreferredSize can specify. (Inherited from Control.)
Public propertyMinimumSizeGets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.)
Public propertyNameGets or sets the name of the control. (Inherited from Control.)
Public propertyPaddingGets or sets padding within the control. (Inherited from Control.)
Public propertyParentGets or sets the parent container of the control. (Inherited from Control.)
Public propertyParentRowsBackColorGets or sets the background color of parent rows.
Public propertyParentRowsForeColorGets or sets the foreground color of parent rows.
Public propertyParentRowsLabelStyleGets or sets the way parent row labels are displayed.
Public propertyParentRowsVisibleGets or sets a value indicating whether the parent rows of a table are visible.
Public propertyPreferredColumnWidthGets or sets the default width of the grid columns in pixels.
Public propertyPreferredRowHeightGets or sets the preferred row height for the System.Windows.Forms.DataGrid control.
Public propertyPreferredSizeGets the size of a rectangular area into which the control can fit. (Inherited from Control.)
Public propertyProductNameGets the product name of the assembly containing the control. (Inherited from Control.)
Public propertyProductVersionGets the version of the assembly containing the control. (Inherited from Control.)
Public propertyReadOnlyGets or sets a value indicating whether the grid is in read-only mode.
Public propertyRecreatingHandleGets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.)
Public propertyRegionGets or sets the window region associated with the control. (Inherited from Control.)
Protected propertyRenderRightToLeft Obsolete. This property is now obsolete. (Inherited from Control.)
Protected propertyResizeRedrawGets or sets a value indicating whether the control redraws itself when resized. (Inherited from Control.)
Public propertyRightGets the distance, in pixels, between the right edge of the control and the left edge of its container's client area. (Inherited from Control.)
Public propertyRightToLeftGets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from Control.)
Public propertyRowHeadersVisibleGets or sets a value that specifies whether row headers are visible.
Public propertyRowHeaderWidthGets or sets the width of row headers.
Protected propertyScaleChildrenGets a value that determines the scaling of child controls. (Inherited from Control.)
Public propertySelectionBackColorGets or sets the background color of selected rows.
Public propertySelectionForeColorGets or set the foreground color of selected rows.
Protected propertyShowFocusCuesGets a value indicating whether the control should display focus rectangles. (Inherited from Control.)
Protected propertyShowKeyboardCuesGets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control.)
Public propertySiteGets or sets the site of the control. (Overrides Control.Site.)
Public propertySizeGets or sets the height and width of the control. (Inherited from Control.)
Public propertyTabIndexGets or sets the tab order of the control within its container. (Inherited from Control.)
Public propertyTableStylesGets the collection of DataGridTableStyle objects for the grid.
Public propertyTabStopGets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.)
Public propertyTagGets or sets the object that contains data about the control. (Inherited from Control.)
Public propertyTextInfrastructure. This member is not meaningful for this control. (Overrides Control.Text.)
Public propertyTopGets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area. (Inherited from Control.)
Public propertyTopLevelControlGets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in. (Inherited from Control.)
Public propertyUseWaitCursorGets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control.)
Protected propertyVertScrollBarGets the vertical scroll bar of the control.
Public propertyVisibleGets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
Public propertyVisibleColumnCountGets the number of visible columns.
Public propertyVisibleRowCountGets the number of rows visible.
Public propertyWidthGets or sets the width of the control. (Inherited from Control.)
Public propertyWindowTargetInfrastructure. This property is not relevant for this class. (Inherited from Control.)
Top

  NameDescription
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.)
Protected methodAccessibilityNotifyClients(AccessibleEvents, Int32, Int32)Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control.)
Public methodBeginEditAttempts to put the grid into a state where editing is allowed.
Public methodBeginInitBegins the initialization of a System.Windows.Forms.DataGrid that is used on a form or used by another component. The initialization occurs at run time.
Public methodBeginInvoke(Delegate)Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public methodBeginInvoke(Delegate, Object())Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public methodBringToFrontBrings the control to the front of the z-order. (Inherited from Control.)
Protected methodCancelEditingCancels the current edit operation and rolls back all changes.
Public methodCollapseCollapses child relations, if any exist for all rows, or for a specified row.
Protected methodColumnStartedEditing(Control)Informs the System.Windows.Forms.DataGrid control when the user begins to edit a column using the specified control.
Protected methodColumnStartedEditing(Rectangle)Informs the System.Windows.Forms.DataGrid control when the user begins to edit the column at the specified location.
Public methodContainsRetrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.)
Protected methodCreateAccessibilityInstanceConstructs a new instance of the accessibility object for this control. (Overrides Control.CreateAccessibilityInstance.)
Public methodCreateControlForces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.)
Protected methodCreateControlsInstanceCreates a new instance of the control collection for the control. (Inherited from Control.)
Public methodCreateGraphicsCreates the Graphics for the control. (Inherited from Control.)
Protected methodCreateGridColumn(PropertyDescriptor)Creates a new DataGridColumnStyle with the specified PropertyDescriptor.
Protected methodCreateGridColumn(PropertyDescriptor, Boolean)Creates a DataGridColumnStyle using the specified PropertyDescriptor.
Protected methodCreateHandleCreates a handle for the control. (Inherited from Control.)
Public methodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Protected methodDefWndProcSends the specified message to the default window procedure. (Inherited from Control.)
Protected methodDestroyHandleDestroys the handle associated with the control. (Inherited from Control.)
Public methodDisposeReleases all resources used by the Component. (Inherited from Component.)
Protected methodDispose(Boolean)Disposes of the resources (other than memory) used by the System.Windows.Forms.DataGrid. (Overrides Control.Dispose(Boolean).)
Public methodDoDragDropBegins a drag-and-drop operation. (Inherited from Control.)
Public methodDrawToBitmapSupports rendering to the specified bitmap. (Inherited from Control.)
Public methodEndEditRequests an end to an edit operation taking place on the System.Windows.Forms.DataGrid control.
Public methodEndInitEnds the initialization of a System.Windows.Forms.DataGrid that is used on a form or used by another component. The initialization occurs at run time.
Public methodEndInvokeRetrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodExpandDisplays child relations, if any exist, for all rows or a specific row.
Protected methodFinalizeReleases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public methodFindFormRetrieves the form that the control is on. (Inherited from Control.)
Public methodFocusSets input focus to the control. (Inherited from Control.)
Protected methodGetAccessibilityObjectByIdRetrieves the specified AccessibleObject. (Inherited from Control.)
Protected methodGetAutoSizeModeRetrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public methodGetCellBounds(DataGridCell)Gets the Rectangle of the cell specified by DataGridCell.
Public methodGetCellBounds(Int32, Int32)Gets the Rectangle of the cell specified by row and column number.
Public methodGetChildAtPoint(Point)Retrieves the child control that is located at the specified coordinates. (Inherited from Control.)
Public methodGetChildAtPoint(Point, GetChildAtPointSkip)Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type. (Inherited from Control.)
Public methodGetContainerControlReturns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
Public methodGetCurrentCellBoundsGets a Rectangle that specifies the four corners of the selected cell.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public methodGetNextControlRetrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
Protected methodGetOutputTextDelimiterInfrastructure. Gets the string that is the delimiter between columns when row contents are copied to the Clipboard.
Public methodGetPreferredSizeRetrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
Protected methodGetScaledBoundsRetrieves the bounds within which the control is scaled. (Inherited from Control.)
Protected methodGetServiceReturns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Protected methodGetStyleRetrieves the value of the specified control style bit for the control. (Inherited from Control.)
Protected methodGetTopLevelDetermines if the control is a top-level control. (Inherited from Control.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodGridHScrolledListens for the scroll event of the horizontal scroll bar.
Protected methodGridVScrolledListens for the scroll event of the vertical scroll bar.
Public methodHideConceals the control from the user. (Inherited from Control.)
Public methodHitTest(Point)Gets information, such as row and column number of a clicked point on the grid, about the grid using a specific Point.
Public methodHitTest(Int32, Int32)Gets information, such as row and column number of a clicked point on the grid, using the x and y coordinate passed to the method.
Public methodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected methodInitLayoutCalled after the control has been added to another container. (Inherited from Control.)
Public methodInvalidateInvalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control.)
Public methodInvalidate(Boolean)Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvalidate(Rectangle)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public methodInvalidate(Region)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. (Inherited from Control.)
Public methodInvalidate(Rectangle, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvalidate(Region, Boolean)Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control. (Inherited from Control.)
Public methodInvoke(Delegate)Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
Public methodInvoke(Delegate, Object())Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments. (Inherited from Control.)
Protected methodInvokeGotFocusRaises the GotFocus event for the specified control. (Inherited from Control.)
Protected methodInvokeLostFocusRaises the LostFocus event for the specified control. (Inherited from Control.)
Protected methodInvokeOnClickRaises the Click event for the specified control. (Inherited from Control.)
Protected methodInvokePaintRaises the Paint event for the specified control. (Inherited from Control.)
Protected methodInvokePaintBackgroundRaises the PaintBackground event for the specified control. (Inherited from Control.)
Public methodIsExpandedGets a value that indicates whether the node of a specified row is expanded or collapsed.
Protected methodIsInputCharDetermines if a character is an input character that the control recognizes. (Inherited from Control.)
Protected methodIsInputKeyDetermines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from Control.)
Public methodIsSelectedGets a value indicating whether a specified row is selected.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodMemberwiseClone(Boolean)Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Public methodNavigateBackNavigates back to the table previously displayed in the grid.
Public methodNavigateToNavigates to the table specified by row and relation name.
Protected methodNotifyInvalidateInfrastructure. Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control.)
Protected methodOnAllowNavigationChangedRaises the AllowNavigationChanged event.
Protected methodOnAutoSizeChangedRaises the AutoSizeChanged event. (Inherited from Control.)
Protected methodOnBackButtonClickedListens for the caption's back button clicked event.
Protected methodOnBackColorChangedRaises the BackColorChanged event. (Overrides Control.OnBackColorChanged(EventArgs).)
Protected methodOnBackgroundColorChangedRaises the BackgroundColorChanged event.
Protected methodOnBackgroundImageChangedRaises the BackgroundImageChanged event. (Inherited from Control.)
Protected methodOnBackgroundImageLayoutChangedRaises the BackgroundImageLayoutChanged event. (Inherited from Control.)
Protected methodOnBindingContextChangedRaises the BindingContextChanged event. (Overrides Control.OnBindingContextChanged(EventArgs).)
Protected methodOnBorderStyleChangedRaises the BorderStyleChanged event.
Protected methodOnCaptionVisibleChangedRaises the CaptionVisibleChanged event.
Protected methodOnCausesValidationChangedRaises the CausesValidationChanged event. (Inherited from Control.)
Protected methodOnChangeUICuesRaises the ChangeUICues event. (Inherited from Control.)
Protected methodOnClickRaises the Click event. (Inherited from Control.)
Protected methodOnClientSizeChangedRaises the ClientSizeChanged event. (Inherited from Control.)
Protected methodOnContextMenuChangedRaises the ContextMenuChanged event. (Inherited from Control.)
Protected methodOnContextMenuStripChangedRaises the ContextMenuStripChanged event. (Inherited from Control.)
Protected methodOnControlAddedRaises the ControlAdded event. (Inherited from Control.)
Protected methodOnControlRemovedRaises the ControlRemoved event. (Inherited from Control.)
Protected methodOnCreateControlRaises the CreateControl method. (Inherited from Control.)
Protected methodOnCurrentCellChangedRaises the CurrentCellChanged event.
Protected methodOnCursorChangedRaises the CursorChanged event. (Inherited from Control.)
Protected methodOnDataSourceChangedRaises the DataSourceChanged event.
Protected methodOnDockChangedRaises the DockChanged event. (Inherited from Control.)
Protected methodOnDoubleClickRaises the DoubleClick event. (Inherited from Control.)
Protected methodOnDragDropRaises the DragDrop event. (Inherited from Control.)
Protected methodOnDragEnterRaises the DragEnter event. (Inherited from Control.)
Protected methodOnDragLeaveRaises the DragLeave event. (Inherited from Control.)
Protected methodOnDragOverRaises the DragOver event. (Inherited from Control.)
Protected methodOnEnabledChangedRaises the EnabledChanged event. (Inherited from Control.)
Protected methodOnEnterRaises the Enter event. (Overrides Control.OnEnter(EventArgs).)
Protected methodOnFlatModeChangedRaises the FlatModeChanged event.
Protected methodOnFontChangedRaises the FontChanged event. (Overrides Control.OnFontChanged(EventArgs).)
Protected methodOnForeColorChangedRaises the ForeColorChanged event. (Overrides Control.OnForeColorChanged(EventArgs).)
Protected methodOnGiveFeedbackRaises the GiveFeedback event. (Inherited from Control.)
Protected methodOnGotFocusRaises the GotFocus event. (Inherited from Control.)
Protected methodOnHandleCreatedRaises the CreateHandle event. (Overrides Control.OnHandleCreated(EventArgs).)
Protected methodOnHandleDestroyedRaises the DestroyHandle event. (Overrides Control.OnHandleDestroyed(EventArgs).)
Protected methodOnHelpRequestedRaises the HelpRequested event. (Inherited from Control.)
Protected methodOnImeModeChangedRaises the ImeModeChanged event. (Inherited from Control.)
Protected methodOnInvalidatedRaises the Invalidated event. (Inherited from Control.)
Protected methodOnKeyDownRaises the KeyDown event. (Overrides Control.OnKeyDown(KeyEventArgs).)
Protected methodOnKeyPressRaises the KeyPress event. (Overrides Control.OnKeyPress(KeyPressEventArgs).)
Protected methodOnKeyUpRaises the KeyUp event. (Inherited from Control.)
Protected methodOnLayoutRaises the Layout event, which repositions controls and updates scroll bars. (Overrides Control.OnLayout(LayoutEventArgs).)
Protected methodOnLeaveRaises the Leave event. (Overrides Control.OnLeave(EventArgs).)
Protected methodOnLocationChangedRaises the LocationChanged event. (Inherited from Control.)
Protected methodOnLostFocusRaises the LostFocus event. (Inherited from Control.)
Protected methodOnMarginChangedRaises the MarginChanged event. (Inherited from Control.)
Protected methodOnMouseCaptureChangedRaises the MouseCaptureChanged event. (Inherited from Control.)
Protected methodOnMouseClickRaises the MouseClick event. (Inherited from Control.)
Protected methodOnMouseDoubleClickRaises the MouseDoubleClick event. (Inherited from Control.)
Protected methodOnMouseDownRaises the MouseDown event. (Overrides Control.OnMouseDown(MouseEventArgs).)
Protected methodOnMouseEnterRaises the MouseEnter event. (Inherited from Control.)
Protected methodOnMouseHoverRaises the MouseHover event. (Inherited from Control.)
Protected methodOnMouseLeaveCreates the MouseLeave event. (Overrides Control.OnMouseLeave(EventArgs).)
Protected methodOnMouseMoveRaises the MouseMove event. (Overrides Control.OnMouseMove(MouseEventArgs).)
Protected methodOnMouseUpRaises the MouseUp event. (Overrides Control.OnMouseUp(MouseEventArgs).)
Protected methodOnMouseWheelRaises the MouseWheel event. (Overrides Control.OnMouseWheel(MouseEventArgs).)
Protected methodOnMoveRaises the Move event. (Inherited from Control.)
Protected methodOnNavigateRaises the Navigate event.
Protected methodOnNotifyMessageNotifies the control of Windows messages. (Inherited from Control.)
Protected methodOnPaddingChangedRaises the PaddingChanged event. (Inherited from Control.)
Protected methodOnPaintRaises the Paint event. (Overrides Control.OnPaint(PaintEventArgs).)
Protected methodOnPaintBackgroundOverrides Control.OnPaintBackground to prevent painting the background of the System.Windows.Forms.DataGrid control. (Overrides Control.OnPaintBackground(PaintEventArgs).)
Protected methodOnParentBackColorChangedRaises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentBackgroundImageChangedRaises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentBindingContextChangedRaises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentChangedRaises the ParentChanged event. (Inherited from Control.)
Protected methodOnParentCursorChangedRaises the CursorChanged event. (Inherited from Control.)
Protected methodOnParentEnabledChangedRaises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentFontChangedRaises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentForeColorChangedRaises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentRightToLeftChangedRaises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control.)
Protected methodOnParentRowsLabelStyleChangedRaises the ParentRowsLabelStyleChanged event.
Protected methodOnParentRowsVisibleChangedRaises the ParentRowsVisibleChanged event.
Protected methodOnParentVisibleChangedRaises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control.)
Protected methodOnPreviewKeyDownRaises the PreviewKeyDown event. (Inherited from Control.)
Protected methodOnPrintRaises the Paint event. (Inherited from Control.)
Protected methodOnQueryContinueDragRaises the QueryContinueDrag event. (Inherited from Control.)
Protected methodOnReadOnlyChangedRaises the ReadOnlyChanged event
Protected methodOnRegionChangedRaises the RegionChanged event. (Inherited from Control.)
Protected methodOnResizeRaises the Resize event. (Overrides Control.OnResize(EventArgs).)
Protected methodOnRightToLeftChangedRaises the RightToLeftChanged event. (Inherited from Control.)
Protected methodOnRowHeaderClickRaises the RowHeaderClick event.
Protected methodOnScrollRaises the Scroll event.
Protected methodOnShowParentDetailsButtonClickedRaises the ShowParentDetailsButtonClick event.
Protected methodOnSizeChangedRaises the SizeChanged event. (Inherited from Control.)
Protected methodOnStyleChangedRaises the StyleChanged event. (Inherited from Control.)
Protected methodOnSystemColorsChangedRaises the SystemColorsChanged event. (Inherited from Control.)
Protected methodOnTabIndexChangedRaises the TabIndexChanged event. (Inherited from Control.)
Protected methodOnTabStopChangedRaises the TabStopChanged event. (Inherited from Control.)
Protected methodOnTextChangedRaises the TextChanged event. (Inherited from Control.)
Protected methodOnValidatedRaises the Validated event. (Inherited from Control.)
Protected methodOnValidatingRaises the Validating event. (Inherited from Control.)
Protected methodOnVisibleChangedRaises the VisibleChanged event. (Inherited from Control.)
Public methodPerformLayoutForces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public methodPerformLayout(Control, String)Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public methodPointToClientComputes the location of the specified screen point into client coordinates. (Inherited from Control.)
Public methodPointToScreenComputes the location of the specified client point into screen coordinates. (Inherited from Control.)
Public methodPreProcessControlMessagePreprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Public methodPreProcessMessagePreprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Protected methodProcessCmdKeyProcesses a command key. (Inherited from Control.)
Protected methodProcessDialogCharProcesses a dialog character. (Inherited from Control.)
Protected methodProcessDialogKeyGets or sets a value that indicates whether a key should be processed further. (Overrides Control.ProcessDialogKey(Keys).)
Protected methodProcessGridKeyProcesses keys for grid navigation.
Protected methodProcessKeyEventArgsProcesses a key message and generates the appropriate control events. (Inherited from Control.)
Protected methodProcessKeyMessageProcesses a keyboard message. (Inherited from Control.)
Protected methodProcessKeyPreviewPreviews a keyboard message and returns a value indicating if the key was consumed. (Overrides Control.ProcessKeyPreview(Message).)
Protected methodProcessMnemonicProcesses a mnemonic character. (Inherited from Control.)
Protected methodProcessTabKeyGets a value indicating whether the Tab key should be processed.
Protected methodRaiseDragEventInfrastructure. Raises the appropriate drag event. (Inherited from Control.)
Protected methodRaiseKeyEventInfrastructure. Raises the appropriate key event. (Inherited from Control.)
Protected methodRaiseMouseEventInfrastructure. Raises the appropriate mouse event. (Inherited from Control.)
Protected methodRaisePaintEventInfrastructure. Raises the appropriate paint event. (Inherited from Control.)
Protected methodRecreateHandleForces the re-creation of the handle for the control. (Inherited from Control.)
Public methodRectangleToClientComputes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
Public methodRectangleToScreenComputes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.)
Public methodRefreshForces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Control.)
Public methodResetAlternatingBackColorResets the AlternatingBackColor property to its default color.
Public methodResetBackColorResets the BackColor property to its default value. (Overrides Control.ResetBackColor.)
Public methodResetBindingsCauses a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.)
Public methodResetCursorResets the Cursor property to its default value. (Inherited from Control.)
Public methodResetFontResets the Font property to its default value. (Inherited from Control.)
Public methodResetForeColorResets the ForeColor property to its default value. (Overrides Control.ResetForeColor.)
Public methodResetGridLineColorResets the GridLineColor property to its default value.
Public methodResetHeaderBackColorResets the HeaderBackColor property to its default value.
Public methodResetHeaderFontResets the HeaderFont property to its default value.
Public methodResetHeaderForeColorResets the HeaderForeColor property to its default value.
Public methodResetImeModeResets the ImeMode property to its default value. (Inherited from Control.)
Public methodResetLinkColorResets the LinkColor property to its default value.
Public methodResetLinkHoverColorResets the LinkHoverColor property to its default value.
Protected methodResetMouseEventArgsInfrastructure. Resets the control to handle the MouseLeave event. (Inherited from Control.)
Public methodResetRightToLeftResets the RightToLeft property to its default value. (Inherited from Control.)
Protected methodResetSelectionTurns off selection for all rows that are selected.
Public methodResetSelectionBackColorResets the SelectionBackColor property to its default value.
Public methodResetSelectionForeColorResets the SelectionForeColor property to its default value.
Public methodResetTextResets the Text property to its default value. (Inherited from Control.)
Public methodResumeLayoutResumes usual layout logic. (Inherited from Control.)
Public methodResumeLayout(Boolean)Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.)
Protected methodRtlTranslateAlignment(ContentAlignment)Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateAlignment(HorizontalAlignment)Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateAlignment(LeftRightAlignment)Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateContentConverts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateHorizontalConverts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected methodRtlTranslateLeftRightConverts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Public methodScale(Single) Obsolete. Scales the control and any child controls. (Inherited from Control.)
Public methodScale(SizeF)Scales the control and all child controls by the specified scaling factor. (Inherited from Control.)
Public methodScale(Single, Single) Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
Protected methodScaleControlScales a control's location, size, padding and margin. (Inherited from Control.)
Protected methodScaleCoreInfrastructure. This method is not relevant for this class. (Inherited from Control.)
Public methodSelectActivates the control. (Inherited from Control.)
Public methodSelect(Int32)Selects a specified row.
Protected methodSelect(Boolean, Boolean)Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from Control.)
Public methodSelectNextControlActivates the next control. (Inherited from Control.)
Public methodSendToBackSends the control to the back of the z-order. (Inherited from Control.)
Protected methodSetAutoSizeModeSets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public methodSetBounds(Int32, Int32, Int32, Int32)Sets the bounds of the control to the specified location and size. (Inherited from Control.)
Public methodSetBounds(Int32, Int32, Int32, Int32, BoundsSpecified)Sets the specified bounds of the control to the specified location and size. (Inherited from Control.)
Protected methodSetBoundsCorePerforms the work of setting the specified bounds of this control. (Inherited from Control.)
Protected methodSetClientSizeCoreSets the size of the client area of the control. (Inherited from Control.)
Public methodSetDataBindingSets the DataSource and DataMember properties at run time.
Protected methodSetStyleSets a specified ControlStyles flag to either true or false. (Inherited from Control.)
Protected methodSetTopLevelSets the control as the top-level control. (Inherited from Control.)
Protected methodSetVisibleCoreSets the control to the specified visible state. (Inherited from Control.)
Protected methodShouldSerializeAlternatingBackColorIndicates whether the AlternatingBackColor property should be persisted.
Protected methodShouldSerializeBackgroundColorIndicates whether the BackgroundColor property should be persisted.
Protected methodShouldSerializeCaptionBackColorGets a value indicating whether the CaptionBackColor property should be persisted.
Protected methodShouldSerializeCaptionForeColorGets a value indicating whether the CaptionForeColor property should be persisted.
Protected methodShouldSerializeGridLineColorIndicates whether the GridLineColor property should be persisted.
Protected methodShouldSerializeHeaderBackColorIndicates whether the HeaderBackColor property should be persisted.
Protected methodShouldSerializeHeaderFontIndicates whether the HeaderFont property should be persisted.
Protected methodShouldSerializeHeaderForeColorIndicates whether the HeaderForeColor property should be persisted.
Protected methodShouldSerializeLinkHoverColorIndicates whether the LinkHoverColor property should be persisted.
Protected methodShouldSerializeParentRowsBackColorIndicates whether the ParentRowsBackColor property should be persisted.
Protected methodShouldSerializeParentRowsForeColorIndicates whether the ParentRowsForeColor property should be persisted.
Protected methodShouldSerializePreferredRowHeightIndicates whether the PreferredRowHeight property should be persisted.
Protected methodShouldSerializeSelectionBackColorIndicates whether the SelectionBackColor property should be persisted.
Protected methodShouldSerializeSelectionForeColorIndicates whether the SelectionForeColor property should be persisted.
Public methodShowDisplays the control to the user. (Inherited from Control.)
Protected methodSizeFromClientSizeDetermines the size of the entire control from the height and width of its client area. (Inherited from Control.)
Public methodSubObjectsSiteChangeInfrastructure. Adds or removes the DataGridTableStyle objects from the container that is associated with the DataGrid.
Public methodSuspendLayoutTemporarily suspends the layout logic for the control. (Inherited from Control.)
Public methodToStringReturns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
Public methodUnSelectUnselects a specified row.
Public methodUpdateCauses the control to redraw the invalidated regions within its client area. (Inherited from Control.)
Protected methodUpdateBoundsUpdates the bounds of the control with the current size and location. (Inherited from Control.)
Protected methodUpdateBounds(Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size and location. (Inherited from Control.)
Protected methodUpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32)Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control.)
Protected methodUpdateStylesForces the assigned styles to be reapplied to the control. (Inherited from Control.)
Protected methodUpdateZOrderUpdates the control in its parent's z-order. (Inherited from Control.)
Protected methodWndProcProcesses Windows messages. (Inherited from Control.)
Top

  NameDescription
Public eventAllowNavigationChangedOccurs when the AllowNavigation property has changed.
Public eventAutoSizeChangedInfrastructure. This event is not relevant for this class. (Inherited from Control.)
Public eventBackButtonClickOccurs when the Back button on a child table is clicked.
Public eventBackColorChangedOccurs when the value of the BackColor property changes. (Inherited from Control.)
Public eventBackgroundColorChangedOccurs when the BackgroundColor has changed.
Public eventBackgroundImageChangedInfrastructure. Occurs when the value of the BackgroundImage property changes.
Public eventBackgroundImageLayoutChangedInfrastructure. Occurs when the value of the BackgroundImageLayout property changes.
Public eventBindingContextChangedOccurs when the value of the BindingContext property changes. (Inherited from Control.)
Public eventBorderStyleChangedOccurs when the BorderStyle has changed.
Public eventCaptionVisibleChangedOccurs when the CaptionVisible property has changed.
Public eventCausesValidationChangedOccurs when the value of the CausesValidation property changes. (Inherited from Control.)
Public eventChangeUICuesOccurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control.)
Public eventClickOccurs when the control is clicked. (Inherited from Control.)
Public eventClientSizeChangedOccurs when the value of the ClientSize property changes. (Inherited from Control.)
Public eventContextMenuChangedOccurs when the value of the ContextMenu property changes. (Inherited from Control.)
Public eventContextMenuStripChangedOccurs when the value of the ContextMenuStrip property changes. (Inherited from Control.)
Public eventControlAddedOccurs when a new control is added to the Control.ControlCollection. (Inherited from Control.)
Public eventControlRemovedOccurs when a control is removed from the Control.ControlCollection. (Inherited from Control.)
Public eventCurrentCellChangedOccurs when the CurrentCell property has changed.
Public eventCursorChangedInfrastructure. Occurs when the value of the Cursor property changes.
Public eventDataSourceChangedOccurs when the DataSource property value has changed.
Public eventDisposedOccurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public eventDockChangedOccurs when the value of the Dock property changes. (Inherited from Control.)
Public eventDoubleClickOccurs when the control is double-clicked. (Inherited from Control.)
Public eventDragDropOccurs when a drag-and-drop operation is completed. (Inherited from Control.)
Public eventDragEnterOccurs when an object is dragged into the control's bounds. (Inherited from Control.)
Public eventDragLeaveOccurs when an object is dragged out of the control's bounds. (Inherited from Control.)
Public eventDragOverOccurs when an object is dragged over the control's bounds. (Inherited from Control.)
Public eventEnabledChangedOccurs when the Enabled property value has changed. (Inherited from Control.)
Public eventEnterOccurs when the control is entered. (Inherited from Control.)
Public eventFlatModeChangedOccurs when the FlatMode has changed.
Public eventFontChangedOccurs when the Font property value changes. (Inherited from Control.)
Public eventForeColorChangedOccurs when the ForeColor property value changes. (Inherited from Control.)
Public eventGiveFeedbackOccurs during a drag operation. (Inherited from Control.)
Public eventGotFocusOccurs when the control receives focus. (Inherited from Control.)
Public eventHandleCreatedOccurs when a handle is created for the control. (Inherited from Control.)
Public eventHandleDestroyedOccurs when the control's handle is in the process of being destroyed. (Inherited from Control.)
Public eventHelpRequestedOccurs when the user requests help for a control. (Inherited from Control.)
Public eventImeModeChangedOccurs when the ImeMode property has changed. (Inherited from Control.)
Public eventInvalidatedOccurs when a control's display requires redrawing. (Inherited from Control.)
Public eventKeyDownOccurs when a key is pressed while the control has focus. (Inherited from Control.)
Public eventKeyPressOccurs when a character. space or backspace key is pressed while the control has focus. (Inherited from Control.)
Public eventKeyUpOccurs when a key is released while the control has focus. (Inherited from Control.)
Public eventLayoutOccurs when a control should reposition its child controls. (Inherited from Control.)
Public eventLeaveOccurs when the input focus leaves the control. (Inherited from Control.)
Public eventLocationChangedOccurs when the Location property value has changed. (Inherited from Control.)
Public eventLostFocusOccurs when the control loses focus. (Inherited from Control.)
Public eventMarginChangedOccurs when the control's margin changes. (Inherited from Control.)
Public eventMouseCaptureChangedOccurs when the control loses mouse capture. (Inherited from Control.)
Public eventMouseClickOccurs when the control is clicked by the mouse. (Inherited from Control.)
Public eventMouseDoubleClickOccurs when the control is double clicked by the mouse. (Inherited from Control.)
Public eventMouseDownOccurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control.)
Public eventMouseEnterOccurs when the mouse pointer enters the control. (Inherited from Control.)
Public eventMouseHoverOccurs when the mouse pointer rests on the control. (Inherited from Control.)
Public eventMouseLeaveOccurs when the mouse pointer leaves the control. (Inherited from Control.)
Public eventMouseMoveOccurs when the mouse pointer is moved over the control. (Inherited from Control.)
Public eventMouseUpOccurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control.)
Public eventMouseWheelOccurs when the mouse wheel moves while the control has focus. (Inherited from Control.)
Public eventMoveOccurs when the control is moved. (Inherited from Control.)
Public eventNavigateOccurs when the user navigates to a new table.
Public eventPaddingChangedOccurs when the control's padding changes. (Inherited from Control.)
Public eventPaintOccurs when the control is redrawn. (Inherited from Control.)
Public eventParentChangedOccurs when the Parent property value changes. (Inherited from Control.)
Public eventParentRowsLabelStyleChangedOccurs when the label style of the parent row is changed.
Public eventParentRowsVisibleChangedOccurs when the ParentRowsVisible property value changes.
Public eventPreviewKeyDownOccurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.)
Public eventQueryAccessibilityHelpOccurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control.)
Public eventQueryContinueDragOccurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled. (Inherited from Control.)
Public eventReadOnlyChangedOccurs when the ReadOnly property value changes.
Public eventRegionChangedOccurs when the value of the Region property changes. (Inherited from Control.)
Public eventResizeOccurs when the control is resized. (Inherited from Control.)
Public eventRightToLeftChangedOccurs when the RightToLeft property value changes. (Inherited from Control.)
Protected eventRowHeaderClickOccurs when a row header is clicked.
Public eventScrollOccurs when the user scrolls the System.Windows.Forms.DataGrid control.
Public eventShowParentDetailsButtonClickOccurs when the ShowParentDetails button is clicked.
Public eventSizeChangedOccurs when the Size property value changes. (Inherited from Control.)
Public eventStyleChangedOccurs when the control style changes. (Inherited from Control.)
Public eventSystemColorsChangedOccurs when the system colors change. (Inherited from Control.)
Public eventTabIndexChangedOccurs when the TabIndex property value changes. (Inherited from Control.)
Public eventTabStopChangedOccurs when the TabStop property value changes. (Inherited from Control.)
Public eventTextChangedInfrastructure. Occurs when the value of the Text property changes.
Public eventValidatedOccurs when the control is finished validating. (Inherited from Control.)
Public eventValidatingOccurs when the control is validating. (Inherited from Control.)
Public eventVisibleChangedOccurs when the Visible property value changes. (Inherited from Control.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIDropTarget.OnDragDropInfrastructure. Raises the DragDrop event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragEnterInfrastructure. Raises the DragEnter event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragLeaveInfrastructure. Raises the DragLeave event. (Inherited from Control.)
Explicit interface implemetationPrivate methodIDropTarget.OnDragOverInfrastructure. Raises the DragOver event. (Inherited from Control.)
Top

The System.Windows.Forms.DataGrid displays Web-like links to child tables. You can click on a link to navigate to the child table. When a child table is displayed, a back button appears in the caption that can be clicked to navigate back to the parent table. The data from the parent rows is displayed below the caption and above the column headers. You can hide the parent row information by clicking the button to the right of the back button.

To display a table in the System.Windows.Forms.DataGrid at run time, use the SetDataBinding method to set the DataSource and DataMember properties to a valid data source. The following data sources are valid:

For more information about the DataSet class, see DataSets, DataTables, and DataViews.

You can create a grid that enables users to edit data but prevents them from adding new rows by using a DataView as the data source and setting the AllowNew property to false.

Data sources are further managed by BindingManagerBase objects. For each table in a data source, a BindingManagerBase can be returned from the form's BindingContext. For example, you can determine the number of rows contained by a data source by returning the associated BindingManagerBase object's Count property.

To validate data, use the underlying objects that represent data and their events. For example, if the data comes from a DataTable in a DataSet, use the ColumnChanging and RowChanging events.

NoteNote

Because the number of columns can be customized (by adding or deleting members of the GridColumnStylesCollection) and the rows can be sorted by column, the RowNumber and ColumnNumber property values cannot be guaranteed to correspond to DataRow and DataColumn indexes in a DataTable. Therefore you should avoid using those properties in the Validating event to validate data.

To determine which cell is selected, use the CurrentCell property. Change the value of any cell by using the Item property, which can take either the row and column indexes of the cell, or a single DataGridCell. Monitor the CurrentCellChanged event to detect when the user selects another cell.

To determine which part of the control the user clicked, use the HitTest method in the MouseDown event. The HitTest method returns a DataGrid.HitTestInfo object, which contains the row and column of a clicked area.

To manage the appearance of the control at run time, several properties for setting the color and caption attributes are available, including the CaptionForeColor, CaptionBackColor, CaptionFont, and so on.

The appearance of the displayed grid (or grids) can be further modified by creating DataGridTableStyle objects and adding them to the GridTableStylesCollection, which is accessed through the TableStyles property. For example, if the DataSource is set to a DataSet containing three DataTable objects, you can add three DataGridTableStyle objects to the collection, one for each table. To synchronize each DataGridTableStyle object with a DataTable, set the MappingName of the DataGridTableStyle to the TableName of the DataTable. For more information about binding to an array of objects, see the DataGridTableStyle.MappingName property.

To create a customized view of a table, create an instance of a DataGridTextBoxColumn or DataGridBoolColumn class and add the object to the GridTableStylesCollection accessed through the TableStyles property. Both classes inherit from DataGridColumnStyle. For each column style, set the MappingName to the ColumnName of a column that you want to show in the grid. To hide a column, set its MappingName to something other than a valid ColumnName.

To format the text of a column, set the Format property of the DataGridTextBoxColumn to one of the values found in Formatting Types in the .NET Framework and Custom Date and Time Format Strings.

To bind the DataGrid to a strongly typed array of objects, the object type must contain public properties. To create a DataGridTableStyle that displays the array, set the DataGridTableStyle.MappingName property to typename[] where typename is replaced by the name of the object type. Also note that the MappingName property is case-sensitive; the type name must be matched exactly. See the MappingName property for an example.

You can also bind the DataGrid to an ArrayList. A feature of the ArrayList is that it can contain objects of multiple types, but the DataGrid can only bind to such a list when all items in the list are of the same type as the first item. This means that all objects must either be of the same type, or they must inherit from the same class as the first item in the list. For example, if the first item in a list is a Control, the second item could be a TextBox (which inherits from Control). If, on the other hand, the first item is a TextBox, the second object cannot be a Control. Further, the ArrayList must have items in it when it is bound. An empty ArrayList will result in an empty grid. In addition, the objects in the ArrayList must contain public properties. When binding to an ArrayList, set the MappingName of the DataGridTableStyle to "ArrayList" (the type name).

For each DataGridTableStyle, you can set color and caption attributes that override the settings for the System.Windows.Forms.DataGrid control. However, if those properties are not set, the settings for the control are used by default. The following properties can be overridden by DataGridTableStyle properties:

To customize the appearance of individual columns, add DataGridColumnStyle objects to the GridColumnStylesCollection, which is accessed through the GridColumnStyles property of each DataGridTableStyle. To synchronize each DataGridColumnStyle with a DataColumn in the DataTable, set the MappingName to the ColumnName of a DataColumn. When constructing a DataGridColumnStyle, you can also set a formatting string that specifies how the column displays data. For example, you can specify that the column use a short-date format to display dates contained in the table.

Caution noteCaution

Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

NoteNote

The DataGridView control replaces and adds functionality to the DataGrid control; however, the DataGrid control is retained for both backward compatibility and future use, if you choose. For more information, see Differences Between the Windows Forms DataGridView and DataGrid Controls.

The following code example creates a Windows form, a DataSet containing two DataTable objects, and a DataRelation that relates the two tables. To display the data, a System.Windows.Forms.DataGrid control is then bound to the DataSet through the SetDataBinding method. A button on the form changes the appearance of the grid by creating two DataGridTableStyle objects and setting the MappingName of each object to a TableName of one of the DataTable objects. The example also contains code in the MouseUp event that uses the HitTest method to print the column, row, and part of the grid that has been clicked.

Option Explicit
Option Strict

Imports System
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
   Inherits System.Windows.Forms.Form
   Private components As System.ComponentModel.Container
   Private button1 As Button
   Private button2 As Button
   Private myDataGrid As DataGrid
   Private myDataSet As DataSet
   Private TablesAlreadyAdded As Boolean     

   Public Sub New()
      ' Required for Windows Form Designer support.
      InitializeComponent()
      ' Call SetUp to bind the controls.
      SetUp()
   End Sub  

  Private Sub InitializeComponent()
      ' Create the form and its controls. 
      Me.components = New System.ComponentModel.Container()
      Me.button1 = New System.Windows.Forms.Button()
      Me.button2 = New System.Windows.Forms.Button()
      Me.myDataGrid = New DataGrid()

      Me.Text = "DataGrid Control Sample" 
      Me.ClientSize = New System.Drawing.Size(450, 330)

      button1.Location = New Point(24, 16)
      button1.Size = New System.Drawing.Size(120, 24)
      button1.Text = "Change Appearance" 
      AddHandler button1.Click, AddressOf button1_Click

      button2.Location = New Point(150, 16)
      button2.Size = New System.Drawing.Size(120, 24)
      button2.Text = "Get Binding Manager" 
      AddHandler button2.Click, AddressOf button2_Click

      myDataGrid.Location = New Point(24, 50)
      myDataGrid.Size = New Size(300, 200)
      myDataGrid.CaptionText = "Microsoft DataGrid Control" 
      AddHandler myDataGrid.MouseUp, AddressOf Grid_MouseUp

      Me.Controls.Add(button1)
      Me.Controls.Add(button2)
      Me.Controls.Add(myDataGrid)
   End Sub  

   Public Shared Sub Main()
      Application.Run(New Form1())
   End Sub  

   Private Sub SetUp()
      ' Create a DataSet with two tables and one relation.
      MakeDataSet()
      ' Bind the DataGrid to the DataSet. The dataMember 
      ' specifies that the Customers table should be displayed.
      myDataGrid.SetDataBinding(myDataSet, "Customers")
   End Sub  

    Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        If TablesAlreadyAdded = True Then Exit Sub
        AddCustomDataTableStyle()
    End Sub 

   Private Sub AddCustomDataTableStyle()
      Dim ts1 As New DataGridTableStyle()
      ts1.MappingName = "Customers" 
      ' Set other properties.
      ts1.AlternatingBackColor = Color.LightGray
      ' Add a GridColumnStyle and set its MappingName  
      ' to the name of a DataColumn in the DataTable.  
      ' Set the HeaderText and Width properties.  

      Dim boolCol As New DataGridBoolColumn()
      boolCol.MappingName = "Current"
      boolCol.HeaderText = "IsCurrent Customer"
      boolCol.Width = 150
      ts1.GridColumnStyles.Add(boolCol)

      ' Add a second column style. 
      Dim TextCol As New DataGridTextBoxColumn()
      TextCol.MappingName = "custName"
      TextCol.HeaderText = "Customer Name"
      TextCol.Width = 250
      ts1.GridColumnStyles.Add(TextCol)

      ' Create the second table style with columns. 
      Dim ts2 As New DataGridTableStyle()
      ts2.MappingName = "Orders" 

      ' Set other properties.
      ts2.AlternatingBackColor = Color.LightBlue

      ' Create new ColumnStyle objects 
      Dim cOrderDate As New DataGridTextBoxColumn()
      cOrderDate.MappingName = "OrderDate"
      cOrderDate.HeaderText = "Order Date"
      cOrderDate.Width = 100
      ts2.GridColumnStyles.Add(cOrderDate)

      ' Use a PropertyDescriptor to create a formatted 
      ' column. First get the PropertyDescriptorCollection 
      ' for the data source and data member.  
      Dim pcol As PropertyDescriptorCollection = _
      Me.BindingContext(myDataSet, "Customers.custToOrders"). _
      GetItemProperties()

      ' Create a formatted column using a PropertyDescriptor. 
      ' The formatting character "c" specifies a currency format. */      

      Dim csOrderAmount As _
      New DataGridTextBoxColumn(pcol("OrderAmount"), "c", True)
      csOrderAmount.MappingName = "OrderAmount"
      csOrderAmount.HeaderText = "Total"
      csOrderAmount.Width = 100
      ts2.GridColumnStyles.Add(csOrderAmount)

      ' Add the DataGridTableStyle instances to  
      ' the GridTableStylesCollection. 
      myDataGrid.TableStyles.Add(ts1)
      myDataGrid.TableStyles.Add(ts2)

     ' Sets the TablesAlreadyAdded to true so this doesn't happen again.
      TablesAlreadyAdded = true
   End Sub  

    Private Sub button2_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        Dim bmGrid As BindingManagerBase
        bmGrid = BindingContext(myDataSet, "Customers")
        MessageBox.Show(("Current BindingManager Position: " & bmGrid.Position))
    End Sub 

   Private Sub Grid_MouseUp(sender As Object, e As MouseEventArgs)
      ' Create a HitTestInfo object using the HitTest method. 
      ' Get the DataGrid by casting sender. 
      Dim myGrid As DataGrid = CType(sender, DataGrid)
      Dim myHitInfo As DataGrid.HitTestInfo = myGrid.HitTest(e.X, e.Y)
      Console.WriteLine(myHitInfo)
      Console.WriteLine(myHitInfo.Type)
      Console.WriteLine(myHitInfo.Row)
      Console.WriteLine(myHitInfo.Column)
   End Sub  

   ' Create a DataSet with two tables and populate it. 
   Private Sub MakeDataSet()
      ' Create a DataSet.
      myDataSet = New DataSet("myDataSet")

      ' Create two DataTables. 
      Dim tCust As New DataTable("Customers")
      Dim tOrders As New DataTable("Orders")

      ' Create two columns, and add them to the first table. 
      Dim cCustID As New DataColumn("CustID", GetType(Integer))
      Dim cCustName As New DataColumn("CustName")
      Dim cCurrent As New DataColumn("Current", GetType(Boolean))
      tCust.Columns.Add(cCustID)
      tCust.Columns.Add(cCustName)
      tCust.Columns.Add(cCurrent)

      ' Create three columns, and add them to the second table. 
      Dim cID As New DataColumn("CustID", GetType(Integer))
      Dim cOrderDate As New DataColumn("orderDate", GetType(DateTime))
      Dim cOrderAmount As New DataColumn("OrderAmount", GetType(Decimal))
      tOrders.Columns.Add(cOrderAmount)
      tOrders.Columns.Add(cID)
      tOrders.Columns.Add(cOrderDate)

      ' Add the tables to the DataSet.
      myDataSet.Tables.Add(tCust)
      myDataSet.Tables.Add(tOrders)

      ' Create a DataRelation, and add it to the DataSet. 
      Dim dr As New DataRelation("custToOrders", cCustID, cID)
      myDataSet.Relations.Add(dr)

      ' Populates the tables. For each customer and order,  
      ' creates two DataRow variables.  
      Dim newRow1 As DataRow
      Dim newRow2 As DataRow

      ' Create three customers in the Customers Table. 
      Dim i As Integer 
      For i = 1 To 3
         newRow1 = tCust.NewRow()
         newRow1("custID") = i
         ' Add the row to the Customers table.
         tCust.Rows.Add(newRow1)
      Next i
      ' Give each customer a distinct name.
      tCust.Rows(0)("custName") = "Customer1"
      tCust.Rows(1)("custName") = "Customer2"
      tCust.Rows(2)("custName") = "Customer3" 

      ' Give the Current column a value.
      tCust.Rows(0)("Current") = True
      tCust.Rows(1)("Current") = True
      tCust.Rows(2)("Current") = False 

      ' For each customer, create five rows in the Orders table. 
      For i = 1 To 3
         Dim j As Integer 
         For j = 1 To 5
            newRow2 = tOrders.NewRow()
            newRow2("CustID") = i
            newRow2("orderDate") = New DateTime(2001, i, j * 2)
            newRow2("OrderAmount") = i * 10 + j * 0.1
            ' Add the row to the Orders table.
            tOrders.Rows.Add(newRow2)
         Next j
      Next i
   End Sub  
End Class

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft