WebBrowser.Navigate メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

WebBrowser コントロールに、指定された場所にあるドキュメントを読み込みます。

オーバーロード

Navigate(Uri, String, Byte[], String)	指定された Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、それを指定された HTTP データを使用して要求し、指定された名前の Web ページ フレームのコンテンツを置き換えます。
Navigate(String, String, Byte[], String)	指定された URL (Uniform Resource Locator) で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、それを指定された HTTP データを使用して要求し、指定された名前の Web ページ フレームのコンテンツを置き換えます。
Navigate(Uri, Boolean)	指定された Uri で示された場所にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。
Navigate(Uri, String)	指定された Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、指定された名前の Web ページ フレームのコンテンツを置き換えます。
Navigate(String, Boolean)	指定された URL (Uniform Resource Locator) にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。
Navigate(String, String)	指定された URL (Uniform Resource Locator) にあるドキュメントを WebBrowser コントロールに読み込み、指定された名前の Web ページ フレームのコンテンツを置き換えます。
Navigate(Uri)	指定された Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、以前のドキュメントを置き換えます。
Navigate(String)	指定された URL (Uniform Resource Locator) にあるドキュメントを WebBrowser コントロールに読み込み、前のドキュメントを置き換えます。

Navigate(Uri, String, Byte[], String)

指定された Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、それを指定された HTTP データを使用して要求し、指定された名前の Web ページ フレームのコンテンツを置き換えます。

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate (Uri? url, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : Uri * string * byte[] * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String, postData As Byte(), additionalHeaders As String)

パラメーター

url

Uri

読み込む対象のドキュメントの URL を表す Uri。

targetFrameName

String

ドキュメントの読み込み先のフレームの名前。

postData

Byte[]

フォーム データなどの HTTP POST データ。

additionalHeaders

String

既定のヘッダーに追加する HTTP ヘッダー。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

ArgumentException

url パラメーターの値が絶対 URI ではありません。 詳細については、「IsAbsoluteUri」を参照してください。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、コントロールは WebBrowser 指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しい Internet Explorer ウィンドウに読み込まれます。

ナビゲーション履歴の GoBack 前のページにコントロールを返すには、 メソッドを使用します。 後方に GoForward 移動した後、ナビゲーション履歴の後のページに戻るには、 メソッドを使用します。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) が表示され、ページをもう一度ダウンロードするのではなく、時間が節約されます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。

こちらもご覧ください

• GoBack()
• GoForward()
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス

Navigate(String, String, Byte[], String)

指定された URL (Uniform Resource Locator) で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、それを指定された HTTP データを使用して要求し、指定された名前の Web ページ フレームのコンテンツを置き換えます。

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName, cli::array <System::Byte> ^ postData, System::String ^ additionalHeaders);

public void Navigate (string urlString, string? targetFrameName, byte[]? postData, string? additionalHeaders);

member this.Navigate : string * string * byte[] * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String, postData As Byte(), additionalHeaders As String)

パラメーター

urlString

String

読み込むドキュメントの URL。

targetFrameName

String

ドキュメントの読み込み先のフレームの名前。

postData

Byte[]

フォーム データなどの HTTP POST データ。

additionalHeaders

String

既定のヘッダーに追加する HTTP ヘッダー。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、コントロールは WebBrowser 指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しい Internet Explorer ウィンドウに読み込まれます。

ナビゲーション履歴の GoBack 前のページにコントロールを返すには、 メソッドを使用します。 後方に GoForward 移動した後、ナビゲーション履歴の後のページに戻るには、 メソッドを使用します。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) が表示され、ページをもう一度ダウンロードするのではなく、時間が節約されます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。

こちらもご覧ください

• GoBack()
• GoForward()
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス

Navigate(Uri, Boolean)

指定された Uri で示された場所にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。

public:
 void Navigate(Uri ^ url, bool newWindow);

public void Navigate (Uri? url, bool newWindow);

member this.Navigate : Uri * bool -> unit

Public Sub Navigate (url As Uri, newWindow As Boolean)

パラメーター

url

Uri

読み込む対象のドキュメントの URL を表す Uri。

newWindow

Boolean

ドキュメントを新しいブラウザー ウィンドウに読み込む場合は true、ドキュメントを WebBrowser コントロールに読み込む場合は false。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

ArgumentException

url パラメーターの値が絶対 URI ではありません。 詳細については、「IsAbsoluteUri」を参照してください。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 パラメーター値 falseを指定してこのオーバーロードをnewWindow呼び出すと、コントロールは指定された URI に通常どおりに移動し、URI を履歴リストの末尾に追加します。 パラメーター値 trueを 指定してこのオーバーロードをnewWindow呼び出すと、コントロールはWebBrowser、指定された URI のドキュメントを新しい Internet Explorer ウィンドウに読み込み、独自のナビゲーション履歴を保持します。 新しいブラウザー ウィンドウを NewWindow 開く前にイベントを処理して通知を受け取ることができ、必要に応じてアクションを取り消すことができます。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動したり、ページを別のブラウザー ウィンドウに読み込んだりすると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードする代わりに時間を節約できます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。 ページが別の Internet Explorer ウィンドウに読み込まれると、ユーザーは [ 更新 ] ボタンをクリックして最新バージョンを取得できます。

こちらもご覧ください

• GoBack()
• GoForward()
• NewWindow
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス

Navigate(Uri, String)

指定された Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、指定された名前の Web ページ フレームのコンテンツを置き換えます。

public:
 void Navigate(Uri ^ url, System::String ^ targetFrameName);

public void Navigate (Uri? url, string? targetFrameName);

member this.Navigate : Uri * string -> unit

Public Sub Navigate (url As Uri, targetFrameName As String)

パラメーター

url

Uri

読み込む対象のドキュメントの URL を表す Uri。

targetFrameName

String

ドキュメントの読み込み先のフレームの名前。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

ArgumentException

url パラメーターの値が絶対 URI ではありません。 詳細については、「IsAbsoluteUri」を参照してください。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、コントロールは WebBrowser 指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しい Internet Explorer ウィンドウに読み込まれます。

ナビゲーション履歴の GoBack 前のページにコントロールを返すには、 メソッドを使用します。 後方に GoForward 移動した後、ナビゲーション履歴の後のページに戻るには、 メソッドを使用します。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) が表示され、ページをもう一度ダウンロードするのではなく、時間が節約されます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。

こちらもご覧ください

• GoBack()
• GoForward()
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス

Navigate(String, Boolean)

指定された URL (Uniform Resource Locator) にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。

public:
 void Navigate(System::String ^ urlString, bool newWindow);

public void Navigate (string urlString, bool newWindow);

member this.Navigate : string * bool -> unit

Public Sub Navigate (urlString As String, newWindow As Boolean)

パラメーター

urlString

String

読み込むドキュメントの URL。

newWindow

Boolean

ドキュメントを新しいブラウザー ウィンドウに読み込む場合は true、ドキュメントを WebBrowser コントロールに読み込む場合は false。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 パラメーター値 falseを指定してこのオーバーロードをnewWindow呼び出すと、コントロールは指定された URI に通常どおりに移動し、URI を履歴リストの末尾に追加します。 パラメーター値 trueを 指定してこのオーバーロードをnewWindow呼び出すと、コントロールはWebBrowser、指定された URI のドキュメントを新しい Internet Explorer ウィンドウに読み込み、独自のナビゲーション履歴を保持します。 新しいブラウザー ウィンドウが NewWindow 開く前に通知を受け取るイベントを処理できるため、必要に応じてアクションを取り消すことができます。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動したり、ページを別のブラウザー ウィンドウに読み込んだりすると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードする代わりに時間を節約できます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。 ページが別の Internet Explorer ウィンドウに読み込まれると、ユーザーは [更新 ] ボタンをクリックして最新バージョンを取得できます。

こちらもご覧ください

• GoBack()
• GoForward()
• NewWindow
• Refresh()

Navigate(String, String)

指定された URL (Uniform Resource Locator) にあるドキュメントを WebBrowser コントロールに読み込み、指定された名前の Web ページ フレームのコンテンツを置き換えます。

public:
 void Navigate(System::String ^ urlString, System::String ^ targetFrameName);

public void Navigate (string urlString, string? targetFrameName);

member this.Navigate : string * string -> unit

Public Sub Navigate (urlString As String, targetFrameName As String)

パラメーター

urlString

String

読み込むドキュメントの URL。

targetFrameName

String

ドキュメントの読み込み先のフレームの名前。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、コントロールは WebBrowser 指定した URI にあるドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しい Internet Explorer ウィンドウに読み込まれます。

ナビゲーション履歴の GoBack 前のページにコントロールを返すには、 メソッドを使用します。 メソッドを GoForward 使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、ページを再度ダウンロードするのではなく、キャッシュされたバージョン (使用可能な場合) を表示することで時間を節約できます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。

こちらもご覧ください

• GoBack()
• GoForward()
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス

Navigate(Uri)

指定された Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、以前のドキュメントを置き換えます。

public:
 void Navigate(Uri ^ url);

public void Navigate (Uri? url);

member this.Navigate : Uri -> unit

Public Sub Navigate (url As Uri)

パラメーター

url

Uri

読み込む対象のドキュメントの URL を表す Uri。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

ArgumentException

url パラメーターの値が絶対 URI ではありません。 詳細については、「IsAbsoluteUri」を参照してください。

例

次のコード例では、 メソッドを使用 Navigate してコントロールのアドレス バーを実装する方法を WebBrowser 示します。 この例では、フォームに というコントロール、WebBrowserTextBox、 というコントロール、および というTextBoxAddresswebBrowser1コントロールButtonGoがButton含まれている必要があります。 テキスト ボックスに URL を入力し、Enter キーを押すか 、[移動 ] ボタンをクリックすると、コントロールは WebBrowser 指定された URL に移動します。 ハイパーリンクをクリックして移動すると、テキスト ボックスが自動的に更新され、現在の URL が表示されます。

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

// Navigates to the URL in the address text box when 
// the ENTER key is pressed while the text box has focus.
void TextBoxAddress_KeyDown( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^ e )
{
   if ( e->KeyCode == System::Windows::Forms::Keys::Enter &&  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Navigates to the URL in the address text box when 
// the Go button is clicked.
void ButtonGo_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   if (  !this->TextBoxAddress->Text->Equals( "" ) )
   {
      this->WebBrowser1->Navigate( this->TextBoxAddress->Text );
   }
}

// Updates the URL in TextBoxAddress upon navigation.
void WebBrowser1_Navigated( Object^ /*sender*/, System::Windows::Forms::WebBrowserNavigatedEventArgs^ /*e*/ )
{
   this->TextBoxAddress->Text = this->WebBrowser1->Url->ToString();
}

// Navigates to the URL in the address box when 
// the ENTER key is pressed while the ToolStripTextBox has focus.
private void toolStripTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode == Keys.Enter)
    {
        Navigate(toolStripTextBox1.Text);
    }
}

// Navigates to the URL in the address box when 
// the Go button is clicked.
private void goButton_Click(object sender, EventArgs e)
{
    Navigate(toolStripTextBox1.Text);
}

// Navigates to the given URL if it is valid.
private void Navigate(String address)
{
    if (String.IsNullOrEmpty(address)) return;
    if (address.Equals("about:blank")) return;
    if (!address.StartsWith("http://") &&
        !address.StartsWith("https://"))
    {
        address = "http://" + address;
    }
    try
    {
        webBrowser1.Navigate(new Uri(address));
    }
    catch (System.UriFormatException)
    {
        return;
    }
}

// Updates the URL in TextBoxAddress upon navigation.
private void webBrowser1_Navigated(object sender,
    WebBrowserNavigatedEventArgs e)
{
    toolStripTextBox1.Text = webBrowser1.Url.ToString();
}

' Navigates to the URL in the address box when 
' the ENTER key is pressed while the ToolStripTextBox has focus.
Private Sub toolStripTextBox1_KeyDown( _
    ByVal sender As Object, ByVal e As KeyEventArgs) _
    Handles toolStripTextBox1.KeyDown

    If (e.KeyCode = Keys.Enter) Then
        Navigate(toolStripTextBox1.Text)
    End If

End Sub

' Navigates to the URL in the address box when 
' the Go button is clicked.
Private Sub goButton_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles goButton.Click

    Navigate(toolStripTextBox1.Text)

End Sub

' Navigates to the given URL if it is valid.
Private Sub Navigate(ByVal address As String)

    If String.IsNullOrEmpty(address) Then Return
    If address.Equals("about:blank") Then Return
    If Not address.StartsWith("http://") And _
        Not address.StartsWith("https://") Then
        address = "http://" & address
    End If

    Try
        webBrowser1.Navigate(New Uri(address))
    Catch ex As System.UriFormatException
        Return
    End Try

End Sub

' Updates the URL in TextBoxAddress upon navigation.
Private Sub webBrowser1_Navigated(ByVal sender As Object, _
    ByVal e As WebBrowserNavigatedEventArgs) _
    Handles webBrowser1.Navigated

    toolStripTextBox1.Text = webBrowser1.Url.ToString()

End Sub

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、コントロールは WebBrowser 指定した URI に移動し、履歴リストの末尾に追加します。 ナビゲーション履歴の GoBack 前のページにコントロールを返すには、 メソッドを使用します。 メソッドを GoForward 使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、ページを再度ダウンロードするのではなく、キャッシュされたバージョン (使用可能な場合) を表示することで時間を節約できます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。

メソッドを Navigate 使用して、Internet Explorer と同様のアドレス バーを実装できます。

こちらもご覧ください

• GoBack()
• GoForward()
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス

Navigate(String)

指定された URL (Uniform Resource Locator) にあるドキュメントを WebBrowser コントロールに読み込み、前のドキュメントを置き換えます。

public:
 void Navigate(System::String ^ urlString);

public void Navigate (string urlString);

member this.Navigate : string -> unit

Public Sub Navigate (urlString As String)

パラメーター

urlString

String

読み込むドキュメントの URL。

例外

ObjectDisposedException

この WebBrowser インスタンスは無効になっています。

InvalidOperationException

IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。

注釈

コントロールは WebBrowser 、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、コントロールは WebBrowser 指定した URI に移動し、履歴リストの末尾に追加します。 ナビゲーション履歴の GoBack 前のページにコントロールを返すには、 メソッドを使用します。 メソッドを GoForward 使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。

コントロールは WebBrowser 、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、ページを再度ダウンロードするのではなく、キャッシュされたバージョン (使用可能な場合) を表示することで時間を節約できます。 メソッドを Refresh 使用して、コントロールをダウンロードして現在の WebBrowser ページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。

メソッドを Navigate 使用して、Internet Explorer と同様のアドレス バーを実装できます。

こちらもご覧ください

• GoBack()
• GoForward()
• Refresh()
• WebBrowser コントロール
• IWebBrowser2 インターフェイス