1 out of 3 rated this helpful - Rate this topic

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.

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Control
        System.Windows.Forms.DataGrid

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[ComplexBindingPropertiesAttribute("DataSource", "DataMember")]
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]
[ComVisibleAttribute(true)]
public class DataGrid : Control, ISupportInitialize, 
	IDataGridEditingService

The DataGrid type exposes the following members.

  Name Description
Public method DataGrid Initializes a new instance of the System.Windows.Forms.DataGrid class.
Top
  Name Description
Public property AccessibilityObject Gets the AccessibleObject assigned to the control. (Inherited from Control.)
Public property AccessibleDefaultActionDescription Gets or sets the default action description of the control for use by accessibility client applications. (Inherited from Control.)
Public property AccessibleDescription Gets or sets the description of the control used by accessibility client applications. (Inherited from Control.)
Public property AccessibleName Gets or sets the name of the control used by accessibility client applications. (Inherited from Control.)
Public property AccessibleRole Gets or sets the accessible role of the control (Inherited from Control.)
Public property AllowDrop Gets or sets a value indicating whether the control can accept data that the user drags onto it. (Inherited from Control.)
Public property AllowNavigation Gets or sets a value indicating whether navigation is allowed.
Public property AllowSorting Gets or sets a value indicating whether the grid can be resorted by clicking on a column header.
Public property AlternatingBackColor Gets or sets the background color of odd-numbered rows of the grid.
Public property Anchor Gets 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 property AutoScrollOffset Gets or sets where this control is scrolled to in ScrollControlIntoView. (Inherited from Control.)
Public property AutoSize Infrastructure. This property is not relevant for this class. (Inherited from Control.)
Public property BackColor Gets or sets the background color of even-numbered rows of the grid. (Overrides Control.BackColor.)
Public property BackgroundColor Gets or sets the color of the non-row area of the grid.
Public property BackgroundImage Infrastructure. This member is not meaningful for this control. (Overrides Control.BackgroundImage.)
Public property BackgroundImageLayout Infrastructure. This member is not meaningful for this control. (Overrides Control.BackgroundImageLayout.)
Public property BindingContext Gets or sets the BindingContext for the control. (Inherited from Control.)
Public property BorderStyle Gets or sets the grid's border style.
Public property Bottom Gets 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 property Bounds Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control. (Inherited from Control.)
Protected property CanEnableIme Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support. (Inherited from Control.)
Public property CanFocus Gets a value indicating whether the control can receive focus. (Inherited from Control.)
Protected property CanRaiseEvents Determines if events can be raised on the control. (Inherited from Control.)
Public property CanSelect Gets a value indicating whether the control can be selected. (Inherited from Control.)
Public property CaptionBackColor Gets or sets the background color of the caption area.
Public property CaptionFont Gets or sets the font of the grid's caption.
Public property CaptionForeColor Gets or sets the foreground color of the caption area.
Public property CaptionText Gets or sets the text of the grid's window caption.
Public property CaptionVisible Gets or sets a value that indicates whether the grid's caption is visible.
Public property Capture Gets or sets a value indicating whether the control has captured the mouse. (Inherited from Control.)
Public property CausesValidation Gets 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 property ClientRectangle Gets the rectangle that represents the client area of the control. (Inherited from Control.)
Public property ClientSize Gets or sets the height and width of the client area of the control. (Inherited from Control.)
Public property ColumnHeadersVisible Gets or sets a value indicating whether the column headers of a table are visible.
Public property CompanyName Gets the name of the company or creator of the application containing the control. (Inherited from Control.)
Public property Container Gets the IContainer that contains the Component. (Inherited from Component.)
Public property ContainsFocus Gets a value indicating whether the control, or one of its child controls, currently has the input focus. (Inherited from Control.)
Public property ContextMenu Gets or sets the shortcut menu associated with the control. (Inherited from Control.)
Public property ContextMenuStrip Gets or sets the ContextMenuStrip associated with this control. (Inherited from Control.)
Public property Controls Gets the collection of controls contained within the control. (Inherited from Control.)
Public property Created Gets a value indicating whether the control has been created. (Inherited from Control.)
Protected property CreateParams Gets the required creation parameters when the control handle is created. (Inherited from Control.)
Public property CurrentCell Gets or sets which cell has the focus. Not available at design time.
Public property CurrentRowIndex Gets or sets index of the row that currently has focus.
Public property Cursor Infrastructure. This member is not meaningful for this control. (Overrides Control.Cursor.)
Public property DataBindings Gets the data bindings for the control. (Inherited from Control.)
Public property DataMember Gets or sets the specific list in a DataSource for which the System.Windows.Forms.DataGrid control displays a grid.
Public property DataSource Gets or sets the data source that the grid is displaying data for.
Protected property DefaultCursor Gets or sets the default cursor for the control. (Inherited from Control.)
Protected property DefaultImeMode Gets the default Input Method Editor (IME) mode supported by the control. (Inherited from Control.)
Protected property DefaultMargin Gets the space, in pixels, that is specified by default between controls. (Inherited from Control.)
Protected property DefaultMaximumSize Gets the length and height, in pixels, that is specified as the default maximum size of a control. (Inherited from Control.)
Protected property DefaultMinimumSize Gets the length and height, in pixels, that is specified as the default minimum size of a control. (Inherited from Control.)
Protected property DefaultPadding Gets the internal spacing, in pixels, of the contents of a control. (Inherited from Control.)
Protected property DefaultSize Gets the default size of the control. (Overrides Control.DefaultSize.)
Protected property DesignMode Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component.)
Public property DisplayRectangle Gets the rectangle that represents the display area of the control. (Inherited from Control.)
Public property Disposing Gets a value indicating whether the base Control class is in the process of disposing. (Inherited from Control.)
Public property Dock Gets 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 property DoubleBuffered Gets 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 property Enabled Gets or sets a value indicating whether the control can respond to user interaction. (Inherited from Control.)
Protected property Events Gets the list of event handlers that are attached to this Component. (Inherited from Component.)
Public property FirstVisibleColumn Gets the index of the first visible column in a grid.
Public property FlatMode Gets or sets a value indicating whether the grid displays in flat mode.
Public property Focused Gets a value indicating whether the control has input focus. (Inherited from Control.)
Public property Font Gets or sets the font of the text displayed by the control. (Inherited from Control.)
Protected property FontHeight Gets or sets the height of the font of the control. (Inherited from Control.)
Public property ForeColor Gets or sets the foreground color (typically the color of the text) property of the System.Windows.Forms.DataGrid control. (Overrides Control.ForeColor.)
Public property GridLineColor Gets or sets the color of the grid lines.
Public property GridLineStyle Gets or sets the line style of the grid.
Public property Handle Gets the window handle that the control is bound to. (Inherited from Control.)
Public property HasChildren Gets a value indicating whether the control contains one or more child controls. (Inherited from Control.)
Public property HeaderBackColor Gets or sets the background color of all row and column headers.
Public property HeaderFont Gets or sets the font used for column headers.
Public property HeaderForeColor Gets or sets the foreground color of headers.
Public property Height Gets or sets the height of the control. (Inherited from Control.)
Protected property HorizScrollBar Gets the horizontal scroll bar for the grid.
Public property ImeMode Gets or sets the Input Method Editor (IME) mode of the control. (Inherited from Control.)
Protected property ImeModeBase Gets or sets the IME mode of a control. (Inherited from Control.)
Public property InvokeRequired Gets 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 property IsAccessible Gets or sets a value indicating whether the control is visible to accessibility applications. (Inherited from Control.)
Public property IsDisposed Gets a value indicating whether the control has been disposed of. (Inherited from Control.)
Public property IsHandleCreated Gets a value indicating whether the control has a handle associated with it. (Inherited from Control.)
Public property IsMirrored Gets a value indicating whether the control is mirrored. (Inherited from Control.)
Public property Item[DataGridCell] Gets or sets the value of a specified DataGridCell.
Public property Item[Int32, Int32] Gets or sets the value of the cell at the specified the row and column.
Public property LayoutEngine Gets a cached instance of the control's layout engine. (Inherited from Control.)
Public property Left Gets 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 property LinkColor Gets or sets the color of the text that you can click to navigate to a child table.
Public property LinkHoverColor Infrastructure. This member is not meaningful for this control.
Protected property ListManager Gets the CurrencyManager for this System.Windows.Forms.DataGrid control.
Public property Location Gets 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 property Margin Gets or sets the space between controls. (Inherited from Control.)
Public property MaximumSize Gets or sets the size that is the upper limit that GetPreferredSize can specify. (Inherited from Control.)
Public property MinimumSize Gets or sets the size that is the lower limit that GetPreferredSize can specify. (Inherited from Control.)
Public property Name Gets or sets the name of the control. (Inherited from Control.)
Public property Padding Gets or sets padding within the control. (Inherited from Control.)
Public property Parent Gets or sets the parent container of the control. (Inherited from Control.)
Public property ParentRowsBackColor Gets or sets the background color of parent rows.
Public property ParentRowsForeColor Gets or sets the foreground color of parent rows.
Public property ParentRowsLabelStyle Gets or sets the way parent row labels are displayed.
Public property ParentRowsVisible Gets or sets a value indicating whether the parent rows of a table are visible.
Public property PreferredColumnWidth Gets or sets the default width of the grid columns in pixels.
Public property PreferredRowHeight Gets or sets the preferred row height for the System.Windows.Forms.DataGrid control.
Public property PreferredSize Gets the size of a rectangular area into which the control can fit. (Inherited from Control.)
Public property ProductName Gets the product name of the assembly containing the control. (Inherited from Control.)
Public property ProductVersion Gets the version of the assembly containing the control. (Inherited from Control.)
Public property ReadOnly Gets or sets a value indicating whether the grid is in read-only mode.
Public property RecreatingHandle Gets a value indicating whether the control is currently re-creating its handle. (Inherited from Control.)
Public property Region Gets or sets the window region associated with the control. (Inherited from Control.)
Protected property RenderRightToLeft Obsolete. This property is now obsolete. (Inherited from Control.)
Protected property ResizeRedraw Gets or sets a value indicating whether the control redraws itself when resized. (Inherited from Control.)
Public property Right Gets 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 property RightToLeft Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts. (Inherited from Control.)
Public property RowHeadersVisible Gets or sets a value that specifies whether row headers are visible.
Public property RowHeaderWidth Gets or sets the width of row headers.
Protected property ScaleChildren Gets a value that determines the scaling of child controls. (Inherited from Control.)
Public property SelectionBackColor Gets or sets the background color of selected rows.
Public property SelectionForeColor Gets or set the foreground color of selected rows.
Protected property ShowFocusCues Gets a value indicating whether the control should display focus rectangles. (Inherited from Control.)
Protected property ShowKeyboardCues Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators. (Inherited from Control.)
Public property Site Gets or sets the site of the control. (Overrides Control.Site.)
Public property Size Gets or sets the height and width of the control. (Inherited from Control.)
Public property TabIndex Gets or sets the tab order of the control within its container. (Inherited from Control.)
Public property TableStyles Gets the collection of DataGridTableStyle objects for the grid.
Public property TabStop Gets or sets a value indicating whether the user can give the focus to this control using the TAB key. (Inherited from Control.)
Public property Tag Gets or sets the object that contains data about the control. (Inherited from Control.)
Public property Text Infrastructure. This member is not meaningful for this control. (Overrides Control.Text.)
Public property Top Gets 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 property TopLevelControl Gets 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 property UseWaitCursor Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls. (Inherited from Control.)
Protected property VertScrollBar Gets the vertical scroll bar of the control.
Public property Visible Gets or sets a value indicating whether the control and all its child controls are displayed. (Inherited from Control.)
Public property VisibleColumnCount Gets the number of visible columns.
Public property VisibleRowCount Gets the number of rows visible.
Public property Width Gets or sets the width of the control. (Inherited from Control.)
Public property WindowTarget Infrastructure. This property is not relevant for this class. (Inherited from Control.)
Top
  Name Description
Protected method AccessibilityNotifyClients(AccessibleEvents, Int32) Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control. (Inherited from Control.)
Protected method AccessibilityNotifyClients(AccessibleEvents, Int32, Int32) Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control . (Inherited from Control.)
Public method BeginEdit Attempts to put the grid into a state where editing is allowed.
Public method BeginInit Begins 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 method BeginInvoke(Delegate) Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on. (Inherited from Control.)
Public method BeginInvoke(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 method BringToFront Brings the control to the front of the z-order. (Inherited from Control.)
Protected method CancelEditing Cancels the current edit operation and rolls back all changes.
Public method Collapse Collapses child relations, if any exist for all rows, or for a specified row.
Protected method ColumnStartedEditing(Control) Informs the System.Windows.Forms.DataGrid control when the user begins to edit a column using the specified control.
Protected method ColumnStartedEditing(Rectangle) Informs the System.Windows.Forms.DataGrid control when the user begins to edit the column at the specified location.
Public method Contains Retrieves a value indicating whether the specified control is a child of the control. (Inherited from Control.)
Protected method CreateAccessibilityInstance Constructs a new instance of the accessibility object for this control. (Overrides Control.CreateAccessibilityInstance().)
Public method CreateControl Forces the creation of the visible control, including the creation of the handle and any visible child controls. (Inherited from Control.)
Protected method CreateControlsInstance Creates a new instance of the control collection for the control. (Inherited from Control.)
Public method CreateGraphics Creates the Graphics for the control. (Inherited from Control.)
Protected method CreateGridColumn(PropertyDescriptor) Creates a new DataGridColumnStyle with the specified PropertyDescriptor.
Protected method CreateGridColumn(PropertyDescriptor, Boolean) Creates a DataGridColumnStyle using the specified PropertyDescriptor.
Protected method CreateHandle Creates a handle for the control. (Inherited from Control.)
Public method CreateObjRef Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
Protected method DefWndProc Sends the specified message to the default window procedure. (Inherited from Control.)
Protected method DestroyHandle Destroys the handle associated with the control. (Inherited from Control.)
Public method Dispose() Releases all resources used by the Component. (Inherited from Component.)
Protected method Dispose(Boolean) Disposes of the resources (other than memory) used by the System.Windows.Forms.DataGrid. (Overrides Control.Dispose(Boolean).)
Public method DoDragDrop Begins a drag-and-drop operation. (Inherited from Control.)
Public method DrawToBitmap Supports rendering to the specified bitmap. (Inherited from Control.)
Public method EndEdit Requests an end to an edit operation taking place on the System.Windows.Forms.DataGrid control.
Public method EndInit Ends 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 method EndInvoke Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed. (Inherited from Control.)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Public method Expand Displays child relations, if any exist, for all rows or a specific row.
Protected method Finalize Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component.)
Public method FindForm Retrieves the form that the control is on. (Inherited from Control.)
Public method Focus Sets input focus to the control. (Inherited from Control.)
Protected method GetAccessibilityObjectById Retrieves the specified AccessibleObject. (Inherited from Control.)
Protected method GetAutoSizeMode Retrieves a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public method GetCellBounds(DataGridCell) Gets the Rectangle of the cell specified by DataGridCell.
Public method GetCellBounds(Int32, Int32) Gets the Rectangle of the cell specified by row and column number.
Public method GetChildAtPoint(Point) Retrieves the child control that is located at the specified coordinates. (Inherited from Control.)
Public method GetChildAtPoint(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 method GetContainerControl Returns the next ContainerControl up the control's chain of parent controls. (Inherited from Control.)
Public method GetCurrentCellBounds Gets a Rectangle that specifies the four corners of the selected cell.
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetLifetimeService Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public method GetNextControl Retrieves the next control forward or back in the tab order of child controls. (Inherited from Control.)
Protected method GetOutputTextDelimiter Infrastructure. Gets the string that is the delimiter between columns when row contents are copied to the Clipboard.
Public method GetPreferredSize Retrieves the size of a rectangular area into which a control can be fitted. (Inherited from Control.)
Protected method GetScaledBounds Retrieves the bounds within which the control is scaled. (Inherited from Control.)
Protected method GetService Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component.)
Protected method GetStyle Retrieves the value of the specified control style bit for the control. (Inherited from Control.)
Protected method GetTopLevel Determines if the control is a top-level control. (Inherited from Control.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method GridHScrolled Listens for the scroll event of the horizontal scroll bar.
Protected method GridVScrolled Listens for the scroll event of the vertical scroll bar.
Public method Hide Conceals the control from the user. (Inherited from Control.)
Public method HitTest(Point) Gets information, such as row and column number of a clicked point on the grid, about the grid using a specific Point.
Public method HitTest(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 method InitializeLifetimeService Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Protected method InitLayout Called after the control has been added to another container. (Inherited from Control.)
Public method Invalidate() Invalidates the entire surface of the control and causes the control to be redrawn. (Inherited from Control.)
Public method Invalidate(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 method Invalidate(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 method Invalidate(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 method Invalidate(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 method Invalidate(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 method Invoke(Delegate) Executes the specified delegate on the thread that owns the control's underlying window handle. (Inherited from Control.)
Public method Invoke(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 method InvokeGotFocus Raises the GotFocus event for the specified control. (Inherited from Control.)
Protected method InvokeLostFocus Raises the LostFocus event for the specified control. (Inherited from Control.)
Protected method InvokeOnClick Raises the Click event for the specified control. (Inherited from Control.)
Protected method InvokePaint Raises the Paint event for the specified control. (Inherited from Control.)
Protected method InvokePaintBackground Raises the PaintBackground event for the specified control. (Inherited from Control.)
Public method IsExpanded Gets a value that indicates whether the node of a specified row is expanded or collapsed.
Protected method IsInputChar Determines if a character is an input character that the control recognizes. (Inherited from Control.)
Protected method IsInputKey Determines whether the specified key is a regular input key or a special key that requires preprocessing. (Inherited from Control.)
Public method IsSelected Gets a value indicating whether a specified row is selected.
Protected method MemberwiseClone() Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method MemberwiseClone(Boolean) Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Public method NavigateBack Navigates back to the table previously displayed in the grid.
Public method NavigateTo Navigates to the table specified by row and relation name.
Protected method NotifyInvalidate Infrastructure. Raises the Invalidated event with a specified region of the control to invalidate. (Inherited from Control.)
Protected method OnAllowNavigationChanged Raises the AllowNavigationChanged event.
Protected method OnAutoSizeChanged Raises the AutoSizeChanged event. (Inherited from Control.)
Protected method OnBackButtonClicked Listens for the caption's back button clicked event.
Protected method OnBackColorChanged Raises the BackColorChanged event. (Overrides Control.OnBackColorChanged(EventArgs).)
Protected method OnBackgroundColorChanged Raises the BackgroundColorChanged event.
Protected method OnBackgroundImageChanged Raises the BackgroundImageChanged event. (Inherited from Control.)
Protected method OnBackgroundImageLayoutChanged Raises the BackgroundImageLayoutChanged event. (Inherited from Control.)
Protected method OnBindingContextChanged Raises the BindingContextChanged event. (Overrides Control.OnBindingContextChanged(EventArgs).)
Protected method OnBorderStyleChanged Raises the BorderStyleChanged event.
Protected method OnCaptionVisibleChanged Raises the CaptionVisibleChanged event.
Protected method OnCausesValidationChanged Raises the CausesValidationChanged event. (Inherited from Control.)
Protected method OnChangeUICues Raises the ChangeUICues event. (Inherited from Control.)
Protected method OnClick Raises the Click event. (Inherited from Control.)
Protected method OnClientSizeChanged Raises the ClientSizeChanged event. (Inherited from Control.)
Protected method OnContextMenuChanged Raises the ContextMenuChanged event. (Inherited from Control.)
Protected method OnContextMenuStripChanged Raises the ContextMenuStripChanged event. (Inherited from Control.)
Protected method OnControlAdded Raises the ControlAdded event. (Inherited from Control.)
Protected method OnControlRemoved Raises the ControlRemoved event. (Inherited from Control.)
Protected method OnCreateControl Raises the CreateControl method. (Inherited from Control.)
Protected method OnCurrentCellChanged Raises the CurrentCellChanged event.
Protected method OnCursorChanged Raises the CursorChanged event. (Inherited from Control.)
Protected method OnDataSourceChanged Raises the DataSourceChanged event.
Protected method OnDockChanged Raises the DockChanged event. (Inherited from Control.)
Protected method OnDoubleClick Raises the DoubleClick event. (Inherited from Control.)
Protected method OnDragDrop Raises the DragDrop event. (Inherited from Control.)
Protected method OnDragEnter Raises the DragEnter event. (Inherited from Control.)
Protected method OnDragLeave Raises the DragLeave event. (Inherited from Control.)
Protected method OnDragOver Raises the DragOver event. (Inherited from Control.)
Protected method OnEnabledChanged Raises the EnabledChanged event. (Inherited from Control.)
Protected method OnEnter Raises the Enter event. (Overrides Control.OnEnter(EventArgs).)
Protected method OnFlatModeChanged Raises the FlatModeChanged event.
Protected method OnFontChanged Raises the FontChanged event. (Overrides Control.OnFontChanged(EventArgs).)
Protected method OnForeColorChanged Raises the ForeColorChanged event. (Overrides Control.OnForeColorChanged(EventArgs).)
Protected method OnGiveFeedback Raises the GiveFeedback event. (Inherited from Control.)
Protected method OnGotFocus Raises the GotFocus event. (Inherited from Control.)
Protected method OnHandleCreated Raises the CreateHandle event. (Overrides Control.OnHandleCreated(EventArgs).)
Protected method OnHandleDestroyed Raises the DestroyHandle event. (Overrides Control.OnHandleDestroyed(EventArgs).)
Protected method OnHelpRequested Raises the HelpRequested event. (Inherited from Control.)
Protected method OnImeModeChanged Raises the ImeModeChanged event. (Inherited from Control.)
Protected method OnInvalidated Raises the Invalidated event. (Inherited from Control.)
Protected method OnKeyDown Raises the KeyDown event. (Overrides Control.OnKeyDown(KeyEventArgs).)
Protected method OnKeyPress Raises the KeyPress event. (Overrides Control.OnKeyPress(KeyPressEventArgs).)
Protected method OnKeyUp Raises the KeyUp event. (Inherited from Control.)
Protected method OnLayout Raises the Layout event, which repositions controls and updates scroll bars. (Overrides Control.OnLayout(LayoutEventArgs).)
Protected method OnLeave Raises the Leave event. (Overrides Control.OnLeave(EventArgs).)
Protected method OnLocationChanged Raises the LocationChanged event. (Inherited from Control.)
Protected method OnLostFocus Raises the LostFocus event. (Inherited from Control.)
Protected method OnMarginChanged Raises the MarginChanged event. (Inherited from Control.)
Protected method OnMouseCaptureChanged Raises the MouseCaptureChanged event. (Inherited from Control.)
Protected method OnMouseClick Raises the MouseClick event. (Inherited from Control.)
Protected method OnMouseDoubleClick Raises the MouseDoubleClick event. (Inherited from Control.)
Protected method OnMouseDown Raises the MouseDown event. (Overrides Control.OnMouseDown(MouseEventArgs).)
Protected method OnMouseEnter Raises the MouseEnter event. (Inherited from Control.)
Protected method OnMouseHover Raises the MouseHover event. (Inherited from Control.)
Protected method OnMouseLeave Creates the MouseLeave event. (Overrides Control.OnMouseLeave(EventArgs).)
Protected method OnMouseMove Raises the MouseMove event. (Overrides Control.OnMouseMove(MouseEventArgs).)
Protected method OnMouseUp Raises the MouseUp event. (Overrides Control.OnMouseUp(MouseEventArgs).)
Protected method OnMouseWheel Raises the MouseWheel event. (Overrides Control.OnMouseWheel(MouseEventArgs).)
Protected method OnMove Raises the Move event. (Inherited from Control.)
Protected method OnNavigate Raises the Navigate event.
Protected method OnNotifyMessage Notifies the control of Windows messages. (Inherited from Control.)
Protected method OnPaddingChanged Raises the PaddingChanged event. (Inherited from Control.)
Protected method OnPaint Raises the Paint event. (Overrides Control.OnPaint(PaintEventArgs).)
Protected method OnPaintBackground Overrides Control.OnPaintBackground to prevent painting the background of the System.Windows.Forms.DataGrid control. (Overrides Control.OnPaintBackground(PaintEventArgs).)
Protected method OnParentBackColorChanged Raises the BackColorChanged event when the BackColor property value of the control's container changes. (Inherited from Control.)
Protected method OnParentBackgroundImageChanged Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes. (Inherited from Control.)
Protected method OnParentBindingContextChanged Raises the BindingContextChanged event when the BindingContext property value of the control's container changes. (Inherited from Control.)
Protected method OnParentChanged Raises the ParentChanged event. (Inherited from Control.)
Protected method OnParentCursorChanged Raises the CursorChanged event. (Inherited from Control.)
Protected method OnParentEnabledChanged Raises the EnabledChanged event when the Enabled property value of the control's container changes. (Inherited from Control.)
Protected method OnParentFontChanged Raises the FontChanged event when the Font property value of the control's container changes. (Inherited from Control.)
Protected method OnParentForeColorChanged Raises the ForeColorChanged event when the ForeColor property value of the control's container changes. (Inherited from Control.)
Protected method OnParentRightToLeftChanged Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes. (Inherited from Control.)
Protected method OnParentRowsLabelStyleChanged Raises the ParentRowsLabelStyleChanged event.
Protected method OnParentRowsVisibleChanged Raises the ParentRowsVisibleChanged event.
Protected method OnParentVisibleChanged Raises the VisibleChanged event when the Visible property value of the control's container changes. (Inherited from Control.)
Protected method OnPreviewKeyDown Raises the PreviewKeyDown event. (Inherited from Control.)
Protected method OnPrint Raises the Paint event. (Inherited from Control.)
Protected method OnQueryContinueDrag Raises the QueryContinueDrag event. (Inherited from Control.)
Protected method OnReadOnlyChanged Raises the ReadOnlyChanged event
Protected method OnRegionChanged Raises the RegionChanged event. (Inherited from Control.)
Protected method OnResize Raises the Resize event. (Overrides Control.OnResize(EventArgs).)
Protected method OnRightToLeftChanged Raises the RightToLeftChanged event. (Inherited from Control.)
Protected method OnRowHeaderClick Raises the RowHeaderClick event.
Protected method OnScroll Raises the Scroll event.
Protected method OnShowParentDetailsButtonClicked Raises the ShowParentDetailsButtonClick event.
Protected method OnSizeChanged Raises the SizeChanged event. (Inherited from Control.)
Protected method OnStyleChanged Raises the StyleChanged event. (Inherited from Control.)
Protected method OnSystemColorsChanged Raises the SystemColorsChanged event. (Inherited from Control.)
Protected method OnTabIndexChanged Raises the TabIndexChanged event. (Inherited from Control.)
Protected method OnTabStopChanged Raises the TabStopChanged event. (Inherited from Control.)
Protected method OnTextChanged Raises the TextChanged event. (Inherited from Control.)
Protected method OnValidated Raises the Validated event. (Inherited from Control.)
Protected method OnValidating Raises the Validating event. (Inherited from Control.)
Protected method OnVisibleChanged Raises the VisibleChanged event. (Inherited from Control.)
Public method PerformLayout() Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public method PerformLayout(Control, String) Forces the control to apply layout logic to all its child controls. (Inherited from Control.)
Public method PointToClient Computes the location of the specified screen point into client coordinates. (Inherited from Control.)
Public method PointToScreen Computes the location of the specified client point into screen coordinates. (Inherited from Control.)
Public method PreProcessControlMessage Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Public method PreProcessMessage Preprocesses keyboard or input messages within the message loop before they are dispatched. (Inherited from Control.)
Protected method ProcessCmdKey Processes a command key. (Inherited from Control.)
Protected method ProcessDialogChar Processes a dialog character. (Inherited from Control.)
Protected method ProcessDialogKey Gets or sets a value that indicates whether a key should be processed further. (Overrides Control.ProcessDialogKey(Keys).)
Protected method ProcessGridKey Processes keys for grid navigation.
Protected method ProcessKeyEventArgs Processes a key message and generates the appropriate control events. (Inherited from Control.)
Protected method ProcessKeyMessage Processes a keyboard message. (Inherited from Control.)
Protected method ProcessKeyPreview Previews a keyboard message and returns a value indicating if the key was consumed. (Overrides Control.ProcessKeyPreview(Message).)
Protected method ProcessMnemonic Processes a mnemonic character. (Inherited from Control.)
Protected method ProcessTabKey Gets a value indicating whether the Tab key should be processed.
Protected method RaiseDragEvent Infrastructure. Raises the appropriate drag event. (Inherited from Control.)
Protected method RaiseKeyEvent Infrastructure. Raises the appropriate key event. (Inherited from Control.)
Protected method RaiseMouseEvent Infrastructure. Raises the appropriate mouse event. (Inherited from Control.)
Protected method RaisePaintEvent Infrastructure. Raises the appropriate paint event. (Inherited from Control.)
Protected method RecreateHandle Forces the re-creation of the handle for the control. (Inherited from Control.)
Public method RectangleToClient Computes the size and location of the specified screen rectangle in client coordinates. (Inherited from Control.)
Public method RectangleToScreen Computes the size and location of the specified client rectangle in screen coordinates. (Inherited from Control.)
Public method Refresh Forces the control to invalidate its client area and immediately redraw itself and any child controls. (Inherited from Control.)
Public method ResetAlternatingBackColor Resets the AlternatingBackColor property to its default color.
Public method ResetBackColor Resets the BackColor property to its default value. (Overrides Control.ResetBackColor().)
Public method ResetBindings Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values. (Inherited from Control.)
Public method ResetCursor Resets the Cursor property to its default value. (Inherited from Control.)
Public method ResetFont Resets the Font property to its default value. (Inherited from Control.)
Public method ResetForeColor Resets the ForeColor property to its default value. (Overrides Control.ResetForeColor().)
Public method ResetGridLineColor Resets the GridLineColor property to its default value.
Public method ResetHeaderBackColor Resets the HeaderBackColor property to its default value.
Public method ResetHeaderFont Resets the HeaderFont property to its default value.
Public method ResetHeaderForeColor Resets the HeaderForeColor property to its default value.
Public method ResetImeMode Resets the ImeMode property to its default value. (Inherited from Control.)
Public method ResetLinkColor Resets the LinkColor property to its default value.
Public method ResetLinkHoverColor Resets the LinkHoverColor property to its default value.
Protected method ResetMouseEventArgs Infrastructure. Resets the control to handle the MouseLeave event. (Inherited from Control.)
Public method ResetRightToLeft Resets the RightToLeft property to its default value. (Inherited from Control.)
Protected method ResetSelection Turns off selection for all rows that are selected.
Public method ResetSelectionBackColor Resets the SelectionBackColor property to its default value.
Public method ResetSelectionForeColor Resets the SelectionForeColor property to its default value.
Public method ResetText Resets the Text property to its default value. (Inherited from Control.)
Public method ResumeLayout() Resumes usual layout logic. (Inherited from Control.)
Public method ResumeLayout(Boolean) Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests. (Inherited from Control.)
Protected method RtlTranslateAlignment(ContentAlignment) Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateAlignment(HorizontalAlignment) Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateAlignment(LeftRightAlignment) Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateContent Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateHorizontal Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text. (Inherited from Control.)
Protected method RtlTranslateLeftRight Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text. (Inherited from Control.)
Public method Scale(Single) Obsolete. Scales the control and any child controls. (Inherited from Control.)
Public method Scale(SizeF) Scales the control and all child controls by the specified scaling factor. (Inherited from Control.)
Public method Scale(Single, Single) Obsolete. Scales the entire control and any child controls. (Inherited from Control.)
Protected method ScaleControl Scales a control's location, size, padding and margin. (Inherited from Control.)
Protected method ScaleCore Infrastructure. This method is not relevant for this class. (Inherited from Control.)
Public method Select() Activates the control. (Inherited from Control.)
Public method Select(Int32) Selects a specified row.
Protected method Select(Boolean, Boolean) Activates a child control. Optionally specifies the direction in the tab order to select the control from. (Inherited from Control.)
Public method SelectNextControl Activates the next control. (Inherited from Control.)
Public method SendToBack Sends the control to the back of the z-order. (Inherited from Control.)
Protected method SetAutoSizeMode Sets a value indicating how a control will behave when its AutoSize property is enabled. (Inherited from Control.)
Public method SetBounds(Int32, Int32, Int32, Int32) Sets the bounds of the control to the specified location and size. (Inherited from Control.)
Public method SetBounds(Int32, Int32, Int32, Int32, BoundsSpecified) Sets the specified bounds of the control to the specified location and size. (Inherited from Control.)
Protected method SetBoundsCore Performs the work of setting the specified bounds of this control. (Inherited from Control.)
Protected method SetClientSizeCore Sets the size of the client area of the control. (Inherited from Control.)
Public method SetDataBinding Sets the DataSource and DataMember properties at run time.
Protected method SetStyle Sets a specified ControlStyles flag to either true or false. (Inherited from Control.)
Protected method SetTopLevel Sets the control as the top-level control. (Inherited from Control.)
Protected method SetVisibleCore Sets the control to the specified visible state. (Inherited from Control.)
Protected method ShouldSerializeAlternatingBackColor Indicates whether the AlternatingBackColor property should be persisted.
Protected method ShouldSerializeBackgroundColor Indicates whether the BackgroundColor property should be persisted.
Protected method ShouldSerializeCaptionBackColor Gets a value indicating whether the CaptionBackColor property should be persisted.
Protected method ShouldSerializeCaptionForeColor Gets a value indicating whether the CaptionForeColor property should be persisted.
Protected method ShouldSerializeGridLineColor Indicates whether the GridLineColor property should be persisted.
Protected method ShouldSerializeHeaderBackColor Indicates whether the HeaderBackColor property should be persisted.
Protected method ShouldSerializeHeaderFont Indicates whether the HeaderFont property should be persisted.
Protected method ShouldSerializeHeaderForeColor Indicates whether the HeaderForeColor property should be persisted.
Protected method ShouldSerializeLinkHoverColor Indicates whether the LinkHoverColor property should be persisted.
Protected method ShouldSerializeParentRowsBackColor Indicates whether the ParentRowsBackColor property should be persisted.
Protected method ShouldSerializeParentRowsForeColor Indicates whether the ParentRowsForeColor property should be persisted.
Protected method ShouldSerializePreferredRowHeight Indicates whether the PreferredRowHeight property should be persisted.
Protected method ShouldSerializeSelectionBackColor Indicates whether the SelectionBackColor property should be persisted.
Protected method ShouldSerializeSelectionForeColor Indicates whether the SelectionForeColor property should be persisted.
Public method Show Displays the control to the user. (Inherited from Control.)
Protected method SizeFromClientSize Determines the size of the entire control from the height and width of its client area. (Inherited from Control.)
Public method SubObjectsSiteChange Infrastructure. Adds or removes the DataGridTableStyle objects from the container that is associated with the DataGrid.
Public method SuspendLayout Temporarily suspends the layout logic for the control. (Inherited from Control.)
Public method ToString Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component.)
Public method UnSelect Unselects a specified row.
Public method Update Causes the control to redraw the invalidated regions within its client area. (Inherited from Control.)
Protected method UpdateBounds() Updates the bounds of the control with the current size and location. (Inherited from Control.)
Protected method UpdateBounds(Int32, Int32, Int32, Int32) Updates the bounds of the control with the specified size and location. (Inherited from Control.)
Protected method UpdateBounds(Int32, Int32, Int32, Int32, Int32, Int32) Updates the bounds of the control with the specified size, location, and client size. (Inherited from Control.)
Protected method UpdateStyles Forces the assigned styles to be reapplied to the control. (Inherited from Control.)
Protected method UpdateZOrder Updates the control in its parent's z-order. (Inherited from Control.)
Protected method WndProc Processes Windows messages. (Inherited from Control.)
Top
  Name Description
Public event AllowNavigationChanged Occurs when the AllowNavigation property has changed.
Public event AutoSizeChanged Infrastructure. This event is not relevant for this class. (Inherited from Control.)
Public event BackButtonClick Occurs when the Back button on a child table is clicked.
Public event BackColorChanged Occurs when the value of the BackColor property changes. (Inherited from Control.)
Public event BackgroundColorChanged Occurs when the BackgroundColor has changed.
Public event BackgroundImageChanged Infrastructure. Occurs when the value of the BackgroundImage property changes.
Public event BackgroundImageLayoutChanged Infrastructure. Occurs when the value of the BackgroundImageLayout property changes.
Public event BindingContextChanged Occurs when the value of the BindingContext property changes. (Inherited from Control.)
Public event BorderStyleChanged Occurs when the BorderStyle has changed.
Public event CaptionVisibleChanged Occurs when the CaptionVisible property has changed.
Public event CausesValidationChanged Occurs when the value of the CausesValidation property changes. (Inherited from Control.)
Public event ChangeUICues Occurs when the focus or keyboard user interface (UI) cues change. (Inherited from Control.)
Public event Click Occurs when the control is clicked. (Inherited from Control.)
Public event ClientSizeChanged Occurs when the value of the ClientSize property changes. (Inherited from Control.)
Public event ContextMenuChanged Occurs when the value of the ContextMenu property changes. (Inherited from Control.)
Public event ContextMenuStripChanged Occurs when the value of the ContextMenuStrip property changes. (Inherited from Control.)
Public event ControlAdded Occurs when a new control is added to the Control.ControlCollection. (Inherited from Control.)
Public event ControlRemoved Occurs when a control is removed from the Control.ControlCollection. (Inherited from Control.)
Public event CurrentCellChanged Occurs when the CurrentCell property has changed.
Public event CursorChanged Infrastructure. Occurs when the value of the Cursor property changes.
Public event DataSourceChanged Occurs when the DataSource property value has changed.
Public event Disposed Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component.)
Public event DockChanged Occurs when the value of the Dock property changes. (Inherited from Control.)
Public event DoubleClick Occurs when the control is double-clicked. (Inherited from Control.)
Public event DragDrop Occurs when a drag-and-drop operation is completed. (Inherited from Control.)
Public event DragEnter Occurs when an object is dragged into the control's bounds. (Inherited from Control.)
Public event DragLeave Occurs when an object is dragged out of the control's bounds. (Inherited from Control.)
Public event DragOver Occurs when an object is dragged over the control's bounds. (Inherited from Control.)
Public event EnabledChanged Occurs when the Enabled property value has changed. (Inherited from Control.)
Public event Enter Occurs when the control is entered. (Inherited from Control.)
Public event FlatModeChanged Occurs when the FlatMode has changed.
Public event FontChanged Occurs when the Font property value changes. (Inherited from Control.)
Public event ForeColorChanged Occurs when the ForeColor property value changes. (Inherited from Control.)
Public event GiveFeedback Occurs during a drag operation. (Inherited from Control.)
Public event GotFocus Occurs when the control receives focus. (Inherited from Control.)
Public event HandleCreated Occurs when a handle is created for the control. (Inherited from Control.)
Public event HandleDestroyed Occurs when the control's handle is in the process of being destroyed. (Inherited from Control.)
Public event HelpRequested Occurs when the user requests help for a control. (Inherited from Control.)
Public event ImeModeChanged Occurs when the ImeMode property has changed. (Inherited from Control.)
Public event Invalidated Occurs when a control's display requires redrawing. (Inherited from Control.)
Public event KeyDown Occurs when a key is pressed while the control has focus. (Inherited from Control.)
Public event KeyPress Occurs when a key is pressed while the control has focus. (Inherited from Control.)
Public event KeyUp Occurs when a key is released while the control has focus. (Inherited from Control.)
Public event Layout Occurs when a control should reposition its child controls. (Inherited from Control.)
Public event Leave Occurs when the input focus leaves the control. (Inherited from Control.)
Public event LocationChanged Occurs when the Location property value has changed. (Inherited from Control.)
Public event LostFocus Occurs when the control loses focus. (Inherited from Control.)
Public event MarginChanged Occurs when the control's margin changes. (Inherited from Control.)
Public event MouseCaptureChanged Occurs when the control loses mouse capture. (Inherited from Control.)
Public event MouseClick Occurs when the control is clicked by the mouse. (Inherited from Control.)
Public event MouseDoubleClick Occurs when the control is double clicked by the mouse. (Inherited from Control.)
Public event MouseDown Occurs when the mouse pointer is over the control and a mouse button is pressed. (Inherited from Control.)
Public event MouseEnter Occurs when the mouse pointer enters the control. (Inherited from Control.)
Public event MouseHover Occurs when the mouse pointer rests on the control. (Inherited from Control.)
Public event MouseLeave Occurs when the mouse pointer leaves the control. (Inherited from Control.)
Public event MouseMove Occurs when the mouse pointer is moved over the control. (Inherited from Control.)
Public event MouseUp Occurs when the mouse pointer is over the control and a mouse button is released. (Inherited from Control.)
Public event MouseWheel Occurs when the mouse wheel moves while the control has focus. (Inherited from Control.)
Public event Move Occurs when the control is moved. (Inherited from Control.)
Public event Navigate Occurs when the user navigates to a new table.
Public event PaddingChanged Occurs when the control's padding changes. (Inherited from Control.)
Public event Paint Occurs when the control is redrawn. (Inherited from Control.)
Public event ParentChanged Occurs when the Parent property value changes. (Inherited from Control.)
Public event ParentRowsLabelStyleChanged Occurs when the label style of the parent row is changed.
Public event ParentRowsVisibleChanged Occurs when the ParentRowsVisible property value changes.
Public event PreviewKeyDown Occurs before the KeyDown event when a key is pressed while focus is on this control. (Inherited from Control.)
Public event QueryAccessibilityHelp Occurs when AccessibleObject is providing help to accessibility applications. (Inherited from Control.)
Public event QueryContinueDrag Occurs 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 event ReadOnlyChanged Occurs when the ReadOnly property value changes.
Public event RegionChanged Occurs when the value of the Region property changes. (Inherited from Control.)
Public event Resize Occurs when the control is resized. (Inherited from Control.)
Public event RightToLeftChanged Occurs when the RightToLeft property value changes. (Inherited from Control.)
Protected event RowHeaderClick Occurs when a row header is clicked.
Public event Scroll Occurs when the user scrolls the System.Windows.Forms.DataGrid control.
Public event ShowParentDetailsButtonClick Occurs when the ShowParentDetails button is clicked.
Public event SizeChanged Occurs when the Size property value changes. (Inherited from Control.)
Public event StyleChanged Occurs when the control style changes. (Inherited from Control.)
Public event SystemColorsChanged Occurs when the system colors change. (Inherited from Control.)
Public event TabIndexChanged Occurs when the TabIndex property value changes. (Inherited from Control.)
Public event TabStopChanged Occurs when the TabStop property value changes. (Inherited from Control.)
Public event TextChanged Infrastructure. Occurs when the value of the Text property changes.
Public event Validated Occurs when the control is finished validating. (Inherited from Control.)
Public event Validating Occurs when the control is validating. (Inherited from Control.)
Public event VisibleChanged Occurs when the Visible property value changes. (Inherited from Control.)
Top
  Name Description
Explicit interface implemetation Private method IDropTarget.OnDragDrop Infrastructure. Raises the DragDrop event. (Inherited from Control.)
Explicit interface implemetation Private method IDropTarget.OnDragEnter Infrastructure. Raises the DragEnter event. (Inherited from Control.)
Explicit interface implemetation Private method IDropTarget.OnDragLeave Infrastructure. Raises the DragLeave event. (Inherited from Control.)
Explicit interface implemetation Private method IDropTarget.OnDragOver Infrastructure. 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 (ADO.NET).

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.

Note Note

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 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 note Caution

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.

Note Note

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.


using System;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
   private System.ComponentModel.Container components;
   private Button button1;
   private Button button2;
   private DataGrid myDataGrid;   
   private DataSet myDataSet;
   private bool TablesAlreadyAdded;
   public Form1()
   {
      // Required for Windows Form Designer support.
      InitializeComponent();
      // Call SetUp to bind the controls.
      SetUp();
   }

   protected override void Dispose( bool disposing ){
      if( disposing ){
         if (components != null){
            components.Dispose();}
      }
      base.Dispose( disposing );
   }
   private void InitializeComponent()
   {
      // Create the form and its controls.
      this.components = new System.ComponentModel.Container();
      this.button1 = new System.Windows.Forms.Button();
      this.button2 = new System.Windows.Forms.Button();
      this.myDataGrid = new DataGrid();

      this.Text = "DataGrid Control Sample";
      this.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";
      button1.Click+=new System.EventHandler(button1_Click);

      button2.Location = new Point(150, 16);
      button2.Size = new System.Drawing.Size(120, 24);
      button2.Text = "Get Binding Manager";
      button2.Click+=new System.EventHandler(button2_Click);

      myDataGrid.Location = new  Point(24, 50);
      myDataGrid.Size = new Size(300, 200);
      myDataGrid.CaptionText = "Microsoft DataGrid Control";
      myDataGrid.MouseUp += new MouseEventHandler(Grid_MouseUp);

      this.Controls.Add(button1);
      this.Controls.Add(button2);
      this.Controls.Add(myDataGrid);
   }

   public static void Main()
   {
      Application.Run(new Form1());
   }

   private void 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");
   }

   private void button1_Click(object sender, System.EventArgs e)
   {
      if(TablesAlreadyAdded) return;
      AddCustomDataTableStyle();
   }

   private void AddCustomDataTableStyle()
   {
      DataGridTableStyle ts1 = 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. */

      DataGridColumnStyle boolCol = new DataGridBoolColumn();
      boolCol.MappingName = "Current";
      boolCol.HeaderText = "IsCurrent Customer";
      boolCol.Width = 150;
      ts1.GridColumnStyles.Add(boolCol);

      // Add a second column style.
      DataGridColumnStyle TextCol = new DataGridTextBoxColumn();
      TextCol.MappingName = "custName";
      TextCol.HeaderText = "Customer Name";
      TextCol.Width = 250;
      ts1.GridColumnStyles.Add(TextCol);

      // Create the second table style with columns.
      DataGridTableStyle ts2 = new DataGridTableStyle();
      ts2.MappingName = "Orders";

      // Set other properties.
      ts2.AlternatingBackColor = Color.LightBlue;

      // Create new ColumnStyle objects
      DataGridColumnStyle cOrderDate = 
      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. */
      PropertyDescriptorCollection pcol = this.BindingContext
      [myDataSet, "Customers.custToOrders"].GetItemProperties();

      /* Create a formatted column using a PropertyDescriptor.
      The formatting character "c" specifies a currency format. */     
      DataGridColumnStyle csOrderAmount = 
      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;
   }

   private void button2_Click(object sender, System.EventArgs e)
   {
      BindingManagerBase bmGrid;
      bmGrid = BindingContext[myDataSet, "Customers"];
      MessageBox.Show("Current BindingManager Position: " + bmGrid.Position);
   }

   private void Grid_MouseUp(object sender, MouseEventArgs e)
   {
      // Create a HitTestInfo object using the HitTest method.

      // Get the DataGrid by casting sender.
      DataGrid myGrid = (DataGrid)sender;
      DataGrid.HitTestInfo myHitInfo = myGrid.HitTest(e.X, e.Y);
      Console.WriteLine(myHitInfo);
      Console.WriteLine(myHitInfo.Type);
      Console.WriteLine(myHitInfo.Row);
      Console.WriteLine(myHitInfo.Column);
   }

   // Create a DataSet with two tables and populate it.
   private void MakeDataSet()
   {
      // Create a DataSet.
      myDataSet = new DataSet("myDataSet");

      // Create two DataTables.
      DataTable tCust = new DataTable("Customers");
      DataTable tOrders = new DataTable("Orders");

      // Create two columns, and add them to the first table.
      DataColumn cCustID = new DataColumn("CustID", typeof(int));
      DataColumn cCustName = new DataColumn("CustName");
      DataColumn cCurrent = new DataColumn("Current", typeof(bool));
      tCust.Columns.Add(cCustID);
      tCust.Columns.Add(cCustName);
      tCust.Columns.Add(cCurrent);

      // Create three columns, and add them to the second table.
      DataColumn cID = 
      new DataColumn("CustID", typeof(int));
      DataColumn cOrderDate = 
      new DataColumn("orderDate",typeof(DateTime));
      DataColumn cOrderAmount = 
      new DataColumn("OrderAmount", typeof(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.
      DataRelation dr = new DataRelation
      ("custToOrders", cCustID , cID);
      myDataSet.Relations.Add(dr);

      /* Populates the tables. For each customer and order, 
      creates two DataRow variables. */
      DataRow newRow1;
      DataRow newRow2;

      // Create three customers in the Customers Table.
      for(int i = 1; i < 4; i++)
      {
         newRow1 = tCust.NewRow();
         newRow1["custID"] = i;
         // Add the row to the Customers table.
         tCust.Rows.Add(newRow1);
      }
      // 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(int i = 1; i < 4; i++)
      {
         for(int j = 1; j < 6; j++)
         {
            newRow2 = tOrders.NewRow();
            newRow2["CustID"]= i;
            newRow2["orderDate"]= new DateTime(2001, i, j * 2);
            newRow2["OrderAmount"] = i * 10 + j  * .1;
            // Add the row to the Orders table.
            tOrders.Rows.Add(newRow2);
         }
      }
   }
}


.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
To hide a column, set its MappingName to something other than a valid ColumnName.
If we use a invalid string as the mapping name to achieve the hide column request, it will cause more others issues.
http://social.msdn.microsoft.com/Forums/en-US/winformsdatacontrols/thread/e8cd80bd-9c0b-449c-97d0-82f379aaad03,
as I searched from discussions, I think set the column with to 0 as below said is the suitable method than the document suggested.
Create a DataGridTableStyle, set its MappingName to the name of your table, create DataGridColumnStyle objects for each of your column, setting the MappingName equal to the ColumnName and add them to the DataGridTableStyle. Add the table style to the DataGrid's TableStyles collection. Then you can hide the desired column by setting the Width property of DataGridColumnStyle object of the specific column equal to 0.
And I also suggest this document should let others note the probable unexpected results after set a invalid mapping name.