This documentation is archived and is not being maintained.

DataGrid.Navigate Event

Occurs when the user navigates to a new table.

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

public event NavigateEventHandler Navigate

Use the Navigate event to reset individual column properties, such as width, as appropriate to the table.

For more information about handling events, see Consuming Events.

The following code example demonstrates the use of this member.

// Instantiate the 'Navigate' NavigateEventHandler.
private void CallNavigate()
   myDataGrid.Navigate += new NavigateEventHandler(Grid_Navigate);

// Raise the event when navigating to another table.
private void Grid_Navigate(object sender, NavigateEventArgs e)
   // String variable used to show message.
   string myString = "Navigate event raised, moved to another table";
   // Show the message when navigating to another table.
   MessageBox.Show(myString, "Table navigation information");

.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.