WebBrowser.Navigate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した場所にあるドキュメントを WebBrowser コントロールに読み込みます。
オーバーロード
| 名前 | 説明 |
|---|---|
| Navigate(Uri, String, Byte[], String) |
指定した Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、指定した HTTP データを使用して要求し、Web ページ フレームの内容を指定した名前に置き換えます。 |
| Navigate(String, String, Byte[], String) |
指定した UNIFORM Resource Locator (URL) にあるドキュメントを WebBrowser コントロールに読み込み、指定した HTTP データを使用して要求し、Web ページ フレームの内容を指定した名前に置き換えます。 |
| Navigate(Uri, Boolean) |
指定した Uri で示されている場所にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。 |
| Navigate(Uri, String) |
指定した Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、Web ページ フレームの内容を指定した名前に置き換えます。 |
| Navigate(String, Boolean) |
指定した Uniform Resource Locator (URL) にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。 |
| Navigate(String, String) |
指定した Uniform Resource Locator (URL) にあるドキュメントを WebBrowser コントロールに読み込み、Web ページ フレームの内容を指定した名前に置き換えます。 |
| Navigate(Uri) |
指定した Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、前のドキュメントを置き換えます。 |
| Navigate(String) |
指定した Uniform Resource Locator (URL) にあるドキュメントを WebBrowser コントロールに読み込み、前のドキュメントを置き換えます。 |
Navigate(Uri, String, Byte[], String)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した 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);
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)
パラメーター
- targetFrameName
- String
ドキュメントを読み込むフレームの名前。
- postData
- Byte[]
フォーム データなどの HTTP POST データ。
- additionalHeaders
- String
既定のヘッダーに追加する HTTP ヘッダー。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
url パラメーター値は絶対 URI を表していません。 詳細については、IsAbsoluteUriを参照してください。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、 WebBrowser コントロールは、指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しいInternet Explorer ウィンドウに読み込まれます。
ナビゲーション履歴の前のページにコントロールを返すには、 GoBack メソッドを使用します。 GoForwardメソッドを使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードするのではなく、時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。
こちらもご覧ください
適用対象
Navigate(String, String, Byte[], String)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した UNIFORM Resource Locator (URL) にあるドキュメントを 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);
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 ヘッダー。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、 WebBrowser コントロールは、指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しいInternet Explorer ウィンドウに読み込まれます。
ナビゲーション履歴の前のページにコントロールを返すには、 GoBack メソッドを使用します。 GoForwardメソッドを使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードするのではなく、時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。
こちらもご覧ください
適用対象
Navigate(Uri, Boolean)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した Uri で示されている場所にあるドキュメントを新しいブラウザー ウィンドウまたは WebBrowser コントロールに読み込みます。
public:
void Navigate(Uri ^ url, bool newWindow);
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)
パラメーター
- newWindow
- Boolean
trueドキュメントを新しいブラウザー ウィンドウに読み込む場合。ドキュメントをWebBrowser コントロールに読み込むfalse。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
url パラメーター値は絶対 URI を表していません。 詳細については、IsAbsoluteUriを参照してください。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。
falseのnewWindow パラメーター値を使用してこのオーバーロードを呼び出すと、コントロールは通常どおり指定された URI に移動し、履歴リストの末尾に URI を追加します。
newWindow パラメーター値を true で呼び出すと、WebBrowser コントロールは、指定した URI のドキュメントを新しいInternet Explorer ウィンドウに読み込み、独自のナビゲーション履歴を保持します。
NewWindow イベントを処理して、新しいブラウザー ウィンドウを開く前に通知を受信し、必要に応じてアクションを取り消すことができます。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動したり、ページを別のブラウザー ウィンドウに読み込んだりすると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードする代わりに時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。 ページが別のInternet Explorer ウィンドウに読み込まれると、ユーザーは Refresh ボタンをクリックして最新バージョンを取得できます。
こちらもご覧ください
適用対象
Navigate(Uri, String)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、Web ページ フレームの内容を指定した名前に置き換えます。
public:
void Navigate(Uri ^ url, System::String ^ targetFrameName);
public void Navigate(Uri url, string targetFrameName);
public void Navigate(Uri? url, string? targetFrameName);
member this.Navigate : Uri * string -> unit
Public Sub Navigate (url As Uri, targetFrameName As String)
パラメーター
- targetFrameName
- String
ドキュメントを読み込むフレームの名前。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
url パラメーター値は絶対 URI を表していません。 詳細については、IsAbsoluteUriを参照してください。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、 WebBrowser コントロールは、指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しいInternet Explorer ウィンドウに読み込まれます。
ナビゲーション履歴の前のページにコントロールを返すには、 GoBack メソッドを使用します。 GoForwardメソッドを使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードするのではなく、時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。
こちらもご覧ください
適用対象
Navigate(String, Boolean)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した Uniform Resource Locator (URL) にあるドキュメントを新しいブラウザー ウィンドウまたは 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。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。
falseのnewWindow パラメーター値を使用してこのオーバーロードを呼び出すと、コントロールは通常どおり指定された URI に移動し、履歴リストの末尾に URI を追加します。
newWindow パラメーター値を true で呼び出すと、WebBrowser コントロールは、指定した URI のドキュメントを新しいInternet Explorer ウィンドウに読み込み、独自のナビゲーション履歴を保持します。
NewWindow イベントを処理して、新しいブラウザー ウィンドウを開く前に通知を受信し、必要に応じてアクションを取り消すことができます。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動したり、ページを別のブラウザー ウィンドウに読み込んだりすると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードする代わりに時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。 ページが別のInternet Explorer ウィンドウに読み込まれると、ユーザーは Refresh ボタンをクリックして最新バージョンを取得できます。
こちらもご覧ください
適用対象
Navigate(String, String)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した Uniform Resource Locator (URL) にあるドキュメントを WebBrowser コントロールに読み込み、Web ページ フレームの内容を指定した名前に置き換えます。
public:
void Navigate(System::String ^ urlString, System::String ^ targetFrameName);
public void Navigate(string urlString, 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
ドキュメントを読み込むフレームの名前。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、 WebBrowser コントロールは、指定した URI のドキュメントを、指定した名前の Web ページ フレームに読み込み、URI を履歴リストの末尾に追加します。 指定されたフレーム名が無効な場合、ドキュメントは新しいInternet Explorer ウィンドウに読み込まれます。
ナビゲーション履歴の前のページにコントロールを返すには、 GoBack メソッドを使用します。 GoForwardメソッドを使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードするのではなく、時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。
こちらもご覧ください
適用対象
Navigate(Uri)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した Uri で示された場所にあるドキュメントを WebBrowser コントロールに読み込み、前のドキュメントを置き換えます。
public:
void Navigate(Uri ^ url);
public void Navigate(Uri url);
public void Navigate(Uri? url);
member this.Navigate : Uri -> unit
Public Sub Navigate (url As Uri)
パラメーター
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
url パラメーター値は絶対 URI を表していません。 詳細については、IsAbsoluteUriを参照してください。
例
次のコード例では、 Navigate メソッドを使用して、 WebBrowser コントロールのアドレス バーを実装する方法を示します。 この例では、フォームに WebBrowser と呼ばれるwebBrowser1 コントロール、TextBox と呼ばれるTextBoxAddress コントロール、および Button というButtonGo コントロールが含まれている必要があります。 テキスト ボックスに URL を入力して Enter キーを押すか 、[移動 ] ボタンをクリックすると、 WebBrowser コントロールは指定された URL に移動します。 ハイパーリンクをクリックして移動すると、テキスト ボックスが自動的に更新され、現在の URL が表示されます。
完全なコード例については、「方法: Web ブラウザー機能を Windows フォーム アプリケーションに追加するを参照してください。
// 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のアドレス バーと同様のアドレス バーを実装できます。
こちらもご覧ください
適用対象
Navigate(String)
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
- ソース:
- WebBrowser.cs
指定した Uniform Resource Locator (URL) にあるドキュメントを 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。
例外
この WebBrowser インスタンスは無効です。
IWebBrowser2 インターフェイスの実装への参照を、基になる ActiveX WebBrowser コントロールから取得できませんでした。
注釈
WebBrowser コントロールは、閲覧セッション中にアクセスしたすべての Web ページの履歴リストを保持します。 このオーバーロードを呼び出すと、 WebBrowser コントロールは指定された URI に移動し、履歴リストの末尾に追加します。 ナビゲーション履歴の前のページにコントロールを返すには、 GoBack メソッドを使用します。 GoForwardメソッドを使用して、後方に移動した後、ナビゲーション履歴の後のページに戻ります。
WebBrowser コントロールは、最近アクセスしたサイトの Web ページをローカル ハード ディスク上のキャッシュに格納します。 各ページでは、キャッシュに残る期間を示す有効期限を指定できます。 コントロールがページに移動すると、キャッシュされたバージョン (使用可能な場合) を表示することで、ページを再度ダウンロードするのではなく、時間を節約できます。 Refreshメソッドを使用して、WebBrowser コントロールをダウンロードして現在のページを強制的に再読み込みし、コントロールに最新バージョンが表示されるようにします。
Navigate メソッドを使用して、Internet Explorerのアドレス バーと同様のアドレス バーを実装できます。