DataGrid.AllowNavigation-Eigenschaft

Ruft einen Wert ab, der angibt, ob die Navigation zulässig ist, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property AllowNavigation As Boolean
'Usage
Dim instance As DataGrid
Dim value As Boolean

value = instance.AllowNavigation

instance.AllowNavigation = value

public bool AllowNavigation { get; set; }

public:
property bool AllowNavigation {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_AllowNavigation ()

/** @property */
public void set_AllowNavigation (boolean value)

public function get AllowNavigation () : boolean

public function set AllowNavigation (value : boolean)

Eigenschaftenwert

true, wenn die Navigation zulässig ist, andernfalls false. Der Standardwert ist true.

Hinweise

Wenn diese Eigenschaft auf false festgelegt ist, werden keine Hyperlinks zu untergeordneten Tabellen angezeigt.

Beispiel

Im folgenden Codebeispiel wird für die AllowNavigation-Eigenschaft zwischen true und false umgeschaltet.

' Create an instance of the 'AllowNavigationChanged' EventHandler.
Private Sub CallAllowNavigationChanged()
   AddHandler myDataGrid.AllowNavigationChanged, AddressOf Grid_AllowNavChange
End Sub 'CallAllowNavigationChanged


' Set the 'AllowNavigation' property on click of a button.
 Private Sub myButton_Click(ByVal sender As Object, ByVal e As EventArgs)
     If myDataGrid.AllowNavigation = True Then
         myDataGrid.AllowNavigation = False
     Else
         myDataGrid.AllowNavigation = True
     End If
 End Sub 'myButton_Click
 
' Raise the event when 'AllowNavigation' property is changed.
 Private Sub Grid_AllowNavChange(ByVal sender As Object, ByVal e As EventArgs)
     Dim myString As String = "AllowNavigationChanged event raised, Navigation "
     Dim myBool As Boolean = myDataGrid.AllowNavigation
     ' Create appropriate alert message.
     myString = myString + IIF(mybool, "is", "is not") + "allowed"
     ' Show information about navigation.
     MessageBox.Show(myString, "Navigation information")
 End Sub 'Grid_AllowNavChange

// Create an instance of the 'AllowNavigationChanged' EventHandler.
private void CallAllowNavigationChanged()
{
   myDataGrid.AllowNavigationChanged += 
                                   new EventHandler(Grid_AllowNavChange);
}

// Set the 'AllowNavigation' property on click of a button.
private void myButton_Click(object sender, EventArgs e)
{
   if (myDataGrid.AllowNavigation == true)
      myDataGrid.AllowNavigation = false;
   else
      myDataGrid.AllowNavigation = true;
}

// Raise the event when 'AllowNavigation' property is changed.
private void Grid_AllowNavChange(object sender, EventArgs e)
{
   string myString = "AllowNavigationChanged event raised, Navigation ";
   bool myBool = myDataGrid.AllowNavigation;
   // Create appropriate alert message.
   myString = myString + (myBool ? " is " : " is not ") + "allowed";
   // Show information about navigation.
   MessageBox.Show(myString, "Navigation information");
}

private:
   // Create an instance of the 'AllowNavigationChanged' EventHandler.
   void CallAllowNavigationChanged()
   {
      myDataGrid->AllowNavigationChanged += gcnew EventHandler( this, &MyDataGrid::Grid_AllowNavChange );
   }

   // Set the 'AllowNavigation' property on click of a button.
private:
   void myButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      if ( myDataGrid->AllowNavigation == true )
            myDataGrid->AllowNavigation = false;
      else
            myDataGrid->AllowNavigation = true;
   }

   // Raise the event when 'AllowNavigation' property is changed.
private:
   void Grid_AllowNavChange( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      String^ myString = "AllowNavigationChanged event raised, Navigation ";
      bool myBool = myDataGrid->AllowNavigation;

      // Create appropriate alert message.
      myString = String::Concat( myString, myBool ? (String^)" is " : " is not ", "allowed" );

      // Show information about navigation.
      MessageBox::Show( myString, "Navigation information" );
   }

// Create an instance of the 'AllowNavigationChanged' EventHandler.
private void CallAllowNavigationChanged()
{
    myDataGrid.add_AllowNavigationChanged(new EventHandler(
        GridAllowNavChange));
} //CallAllowNavigationChanged

// Set the 'AllowNavigation' property on click of a button.
protected void myButton_Click(Object sender, EventArgs e)
{
    if (myDataGrid.get_AllowNavigation() == true) {
        myDataGrid.set_AllowNavigation(false);
    }
    else {
        myDataGrid.set_AllowNavigation(true);
    }
} //myButton_Click

// Raise the event when 'AllowNavigation' property is changed.
protected void GridAllowNavChange(Object sender, EventArgs e)
{
    String myString = "AllowNavigationChanged event raised, Navigation ";
    boolean myBool = myDataGrid.get_AllowNavigation();

    // Create appropriate alert message.
    myString = myString + ((myBool) ? " is " : " is not " + "allowed");

    // Show information about navigation.
    MessageBox.Show(myString, "Navigation information");
} //GridAllowNavChange

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DataGrid-Klasse
DataGrid-Member
System.Windows.Forms-Namespace