WebBrowser.Url WebBrowser.Url WebBrowser.Url WebBrowser.Url Property

定義

現在のドキュメントの場所を示す URL を取得または設定します。Gets or sets the URL of the current document.

public:
 property Uri ^ Url { Uri ^ get(); void set(Uri ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.WebBrowserUriTypeConverter))]
public Uri Url { get; set; }
member this.Url : Uri with get, set
Public Property Url As Uri

プロパティ値

現在のドキュメントの場所を示す URL を表す UriA Uri representing the URL of the current document.

例外

これは、WebBrowserインスタンスは有効ではありません。This WebBrowser instance is no longer valid.

実装への参照、IWebBrowser2インターフェイスを基になる ActiveX から取得できませんでしたWebBrowserコントロール。A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

このプロパティを設定するときに、指定された値は、絶対 URI ではありません。The specified value when setting this property is not an absolute URI. 詳細については、「 IsAbsoluteUri 」を参照してください。For more information, see IsAbsoluteUri.

次のコード例は、使用する方法を示します、Urlのアドレス バーを実装するプロパティ、WebBrowserコントロール。The following code example demonstrates how to use the Url property to implement an address bar for the WebBrowser control. この例では、フォームが含まれている必要があります、WebBrowserというコントロールwebBrowser1TextBoxというコントロールTextBoxAddress、およびButtonというコントロールButtonGoします。This example requires that your form contains a WebBrowser control called webBrowser1, a TextBox control called TextBoxAddress, and a Button control called ButtonGo. テキスト ボックスに URL を入力および ENTER キーを押しますまたは をクリックすると、移動 ボタン、WebBrowserコントロールが指定された URL に移動します。When you type a URL into the text box and press ENTER or click the Go button, the WebBrowser control navigates to the URL specified. ハイパーリンクをクリックして移動したときに、現在の URL を表示するテキスト ボックスが自動的に更新します。When you navigate by clicking a hyperlink, the text box automatically updates to display the current URL.

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

注釈

このプロパティの設定は、呼び出しに相当、Navigateメソッドと、指定した URL を渡します。Setting this property is equivalent to calling the Navigate method and passing it the specified URL.

WebBrowserコントロールは、すべてのブラウズ セッション中にアクセスした Web ページの履歴一覧を保持します。The WebBrowser control maintains a history list of all the Web pages visited during a browsing session. 設定すると、Urlプロパティ、WebBrowserコントロールが指定された URL に移動し、履歴リストの末尾に追加します。When you set the Url property, the WebBrowser control navigates to the specified URL and adds it to the end of the history list.

WebBrowserコントロールは、ローカルのハード ディスクのキャッシュ最近アクセスしたサイトからの Web ページを格納します。The WebBrowser control stores Web pages from recently visited sites in a cache on the local hard disk. 各ページには、どのくらいの時間は変化しません、キャッシュを示す有効期限の日付を指定できます。Each page can specify an expiration date indicating how long it will remain in the cache. コントロールがページに移動する、ページをもう一度ダウンロードするのではなく、1 つは、使用可能な場合は、キャッシュされたバージョンを表示する時間が保存されます。When the control navigates to a page, it saves time by displaying a cached version, if one is available, rather than downloading the page again. 使用して、Refresh強制する方法、WebBrowserコントロールをダウンロードするには、コントロールが、最新バージョンを表示することを確認して、現在のページを再読み込みします。Use the Refresh method to force the WebBrowser control to reload the current page by downloading it, ensuring that the control displays the latest version.

注意

このプロパティは、別のドキュメントが要求されている場合でも、現在のドキュメントの URL を含みます。This property contains the URL of the current document, even if another document has been requested. このプロパティの値を設定し、すぐに再度取得する場合は、取得した値が場合は、設定値よりも異なる可能性があります、WebBrowser新しいドキュメントの読み込みに時間が制御されていません。If you set the value of this property and then immediately retrieve it again, the value retrieved may be different than the value set if the WebBrowser control has not had time to load the new document. 新しい値を取得することができます、DocumentCompletedイベント ハンドラー。You can retrieve the new value in a DocumentCompleted event handler.

セキュリティ

SecurityPermission
このコントロールを使用する即時呼び出し元。for immediate callers to use this control. 要求値: LinkDemand;[NIB:名前付き権限セット](https://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3):FullTrustします。Demand value: LinkDemand; [NIB: Named Permission Sets](https://msdn.microsoft.com/library/08250d67-c99d-4ab0-8d2b-b0e12019f6e3): FullTrust.

適用対象

こちらもご覧ください