WebBrowser.CanGoBack Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene un valor que indica si una página anterior del historial de navegación está disponible; de esta forma, el método GoBack() se puede ejecutar correctamente.

public:
 property bool CanGoBack { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool CanGoBack { get; }

[<System.ComponentModel.Browsable(false)>]
member this.CanGoBack : bool

Public ReadOnly Property CanGoBack As Boolean

Valor de propiedad

Boolean

true si el control puede navegar hacia atrás; en caso contrario, false.

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la CanGoBack propiedad para implementar un botón Atrás para el WebBrowser control similar al del de Internet Explorer. En este ejemplo se requiere que el formulario contenga un WebBrowser control denominado webBrowser1 y un Button control denominado backButton.

Para obtener el ejemplo de código completo, vea How to: Add Web Browser Capabilities to a Windows Forms Application.

// Navigates WebBrowser1 to the previous page in the history.
void backButton_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   this->WebBrowser1->GoBack();
}

// Disables the Back button at the beginning of the navigation history.
void WebBrowser1_CanGoBackChanged( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   this->backButton->Enabled = this->WebBrowser1->CanGoBack;
}

// Navigates webBrowser1 to the previous page in the history.
private void backButton_Click(object sender, EventArgs e)
{
    webBrowser1.GoBack();
}

// Disables the Back button at the beginning of the navigation history.
private void webBrowser1_CanGoBackChanged(object sender, EventArgs e)
{
    backButton.Enabled = webBrowser1.CanGoBack;
}

' Navigates webBrowser1 to the previous page in the history.
Private Sub backButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles backButton.Click

    webBrowser1.GoBack()

End Sub

' Disables the Back button at the beginning of the navigation history.
Private Sub webBrowser1_CanGoBackChanged( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles webBrowser1.CanGoBackChanged

    backButton.Enabled = webBrowser1.CanGoBack

End Sub

Comentarios

El WebBrowser control mantiene una lista de historial de todas las páginas web visitadas durante una sesión de exploración. El GoBack método navega por el WebBrowser control a la página anterior de este historial, si hay uno disponible. Use la propiedad para determinar si el CanGoBack historial de navegación está disponible y contiene una página anterior. Si esta propiedad es true, el GoBack método se realizará correctamente. De lo contrario, al llamar al GoBack método se devolverá un valor de false y no se producirá ninguna navegación.

También puede controlar el CanGoBackChanged evento para recibir una notificación cuando cambie la CanGoBack propiedad. Controlar este evento es útil, por ejemplo, para cambiar el estado habilitado de un botón Atrás cuando el WebBrowser control navega a o sale del principio del historial de navegación.

Consulte también

• CanGoBackChanged
• GoBack()