WebBrowser.GoBack メソッド

.NET Framework クラス ライブラリ リファレンス

WebBrowser.GoBack メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ナビゲーション履歴に前のページがある場合に、WebBrowser コントロールを前のページに戻します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function GoBack As
 Boolean

Visual Basic (使用法)

Dim instance As WebBrowser
Dim returnValue As Boolean

returnValue = instance.GoBack

C#

public bool GoBack ()

C++

public:
bool GoBack ()

J#

public boolean GoBack ()

JScript

public function GoBack () : boolean

戻り値
ナビゲーションに成功する場合は true。ナビゲーション履歴に前のページがない場合は false。

解説

WebBrowser コントロールは、ブラウジング セッション時に閲覧したすべての Web ページの履歴リストを保持します。GoBack メソッドを使用して Internet Explorer の [戻る] ボタンのようなボタンを実装できます。ユーザーはこのボタンを使って、ナビゲーション履歴の前のページに戻ることができます。

ナビゲーション履歴を利用できるかどうか、そして前のページがあるかどうかを判断するには、CanGoBack プロパティを使用します。CanGoBackChanged イベントを処理して、CanGoBack プロパティの値が変更されたときに通知を受け取ります。たとえば、WebBrowser コントロールでナビゲーション履歴の最初のページに移動したとき、またはそのページから移動したときに [戻る] ボタンの有効状態を変更する場合に、このイベントが役立ちます。

使用例

GoBack メソッドを使用して、Internet Explorer の [戻る] ボタンのようなボタンを WebBrowser コントロールに実装する方法を次のコード例に示します。この例は、フォームに webBrowser1 という名前の WebBrowser コントロールと、ButtonBack という名前の Button コントロールが存在することを前提にしています。

コード全体については、「方法 : Windows フォーム アプリケーションに Web ブラウザの機能を追加する」を参照してください。

Visual Basic

' 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

C#

// 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;
}

C++

// Navigates WebBrowser1 to the previous page in the history.
void ButtonBack_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->ButtonBack->Enabled = this->WebBrowser1->CanGoBack;
}

.NET Framework のセキュリティ

• SecurityPermission  (このコントロールを使用する直接の呼び出し元に必要なアクセス許可)。要求値 : LinkDemand、名前付きアクセス許可セット、FullTrust。

プラットフォーム

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
WebBrowser クラス
WebBrowser メンバ
System.Windows.Forms 名前空間
CanGoBack
CanGoBackChanged
GoForward
GoHome
GoSearch
Refresh
Stop