HtmlWindow.Open 方法

定义

在已命名的窗口中显示文件。

重载

Open(String, String, String, Boolean)

在已命名的窗口中显示文件。

Open(Uri, String, String, Boolean)

在已命名的窗口中显示文件。

Open(String, String, String, Boolean)

Source:
HtmlWindow.cs
Source:
HtmlWindow.cs
Source:
HtmlWindow.cs

在已命名的窗口中显示文件。

public System.Windows.Forms.HtmlWindow Open (string urlString, string target, string windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow? Open (string urlString, string target, string windowOptions, bool replaceEntry);

参数

urlString
String

描述要加载的文件位置的统一资源定位器。

target
String

要在其中打开资源的窗口的名称。 它可能是开发人员提供的名称或者下列特殊值之一:

_blank urlString:在新窗口中打开。 与调用 OpenNew(String, String) 作用相同。

_media:在媒体栏中打开 urlString

_parent:在创建当前窗口的窗口中打开 urlString

_search:在搜索栏中打开 urlString

_self:在当前窗口中打开 urlString

_top:如果针对属于 元素的FRAME窗口调用,则会在承载其 FRAMESET的窗口中打开urlString。 否则, 的行为与 相同 _self

windowOptions
String

以逗号分隔的字符串,由以下零个或多个选项组成,格式为 name=value。 除了采用任意整数的 lefttopheightwidth 选项外,每个选项都接受 yes1、 和 no0或 作为有效值。

channelmode:与 Internet Explorer 4.0 中已弃用的通道技术一起使用。 默认值为 no

directories:窗口是否应显示目录导航按钮。 默认值为 yes

height:窗口工作区的高度(以像素为单位)。 最小为 100 个像素;尝试打开小于此标准的窗口时,将根据 Internet Explorer 默认设置打开窗口。

left:窗口的左边(x 坐标)位置(以像素为单位),相对于用户屏幕的左上角。 必须是正整数。

location:是否显示地址栏,使用户能够将窗口导航到新 URL。 默认值为 yes

menubar:是否在新窗口上显示菜单。 默认值为 yes

resizable:用户是否可以调整窗口的大小。 默认值为 yes

scrollbars:窗口是否具有水平滚动条和垂直滚动条。 默认值为 yes

status:窗口底部是否有状态栏。 默认值为 yes

titlebar:是否显示当前页的标题。 将此选项设置为 no 在托管应用程序中不起作用;标题栏将始终显示。

toolbar:工具栏按钮(如“后退”、“前进”“停止”)是否可见。 默认值为 yes

top:窗口顶部 (y 坐标) 相对于用户屏幕左上角的位置(以像素为单位)。 必须是正整数。

width:窗口工作区的宽度(以像素为单位)。 最小为 100 个像素;尝试打开小于此标准的窗口时,将根据 Internet Explorer 默认设置打开窗口。

replaceEntry
Boolean

true 将当前窗口的 URL urlString 替换为导航历史记录中的 。 这将对 HtmlHistory 类的方法的操作产生影响。

返回

新窗口,或以前创建的由 参数命名的 target 窗口。

注解

参数 target 可以命名作为先前调用 Open的结果创建的窗口。 参数还可以指向通过单击超链接打开的窗口 (A 元素) 或使用 FORMTARGET 属性在新窗口中打开其 URL 的元素。 以下 HTML 代码将在用户单击时打开名为 orderWindow 的新窗口:

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

如果为 windowOptions 参数提供任何选项,则会自动禁用未包含的任何选项。 换句话说,如果仅通过 指定需要状态栏的方式 windowOptions ,则不会显示菜单栏、工具栏、标题、滚动条等,除非通过 windowOptions显式启用它们。

如果 引用 url 的文件是 HTML 文件、文本文件或可在 Internet Explorer 中托管的其他文件类型,则它将显示在命名窗口中。 如果文件不能显示在 Internet Explorer 内,并且目标命名的窗口不存在,则该窗口将只打开足够长的时间,供 Internet Explorer 下载资源;它随后会立即关闭。

使用 OpenOpenNew创建新窗口时,会导致 HTML 文档对象模型打开 Internet Explorer 的新实例。 如果不在创建的所有窗口上调用 Close ,即使应用程序退出,此 Internet Explorer 实例仍将保持运行状态。

如果使用 Open 在现有窗口中加载 URL, windowOptions 则 将被忽略;该窗口将保留通过对 的初始调用 Open首先给定它的尺寸、外观和屏幕位置。

适用于

.NET Framework 4.8.1 和其他版本
产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Open(Uri, String, String, Boolean)

Source:
HtmlWindow.cs
Source:
HtmlWindow.cs
Source:
HtmlWindow.cs

在已命名的窗口中显示文件。

public System.Windows.Forms.HtmlWindow Open (Uri url, string target, string windowOptions, bool replaceEntry);
public System.Windows.Forms.HtmlWindow? Open (Uri url, string target, string windowOptions, bool replaceEntry);

参数

url
Uri

描述要加载的文件位置的统一资源定位器。

target
String

要在其中打开资源的窗口的名称。 它可以是开发人员提供的名称,或下列特殊值之一:

_blank url:在新窗口中打开。 与调用 OpenNew(String, String) 作用相同。

_media:在媒体栏中打开 url

_parent:在创建当前窗口的窗口中打开 url

_search:在搜索栏中打开 url

_self:在当前窗口中打开 url

_top:如果针对属于 元素的FRAME窗口调用,则会在承载其 FRAMESET的窗口中打开url。 否则, 的行为与 相同 _self

windowOptions
String

以逗号分隔的字符串,由以下零个或多个选项组成,格式为 name=value。 除了采用任意整数的 lefttopheightwidth 选项外,每个选项都接受 yes1、 和 no0或 作为有效值。

channelmode:与 Internet Explorer 4.0 中已弃用的通道技术一起使用。 默认值为 no

directories:窗口是否应显示目录导航按钮。 默认值为 yes

height:窗口工作区的高度(以像素为单位)。 最小为 100 个像素;尝试打开小于此标准的窗口时,将根据 Internet Explorer 默认设置打开窗口。

left:窗口的左边(x 坐标)位置(以像素为单位),相对于用户屏幕的左上角。 必须是正整数。

location:是否显示地址栏,使用户能够将窗口导航到新 URL。 默认值为 yes

menubar:是否在新窗口上显示菜单。 默认值为 yes

resizable:用户是否可以调整窗口的大小。 默认值为 yes

scrollbars:窗口是否具有水平滚动条和垂直滚动条。 默认值为 yes

status:窗口底部是否有状态栏。 默认值为 yes

titlebar:是否显示当前页的标题。 将此选项设置为 no 在托管应用程序中不起作用;标题栏将始终显示。

toolbar:工具栏按钮(如“后退”、“前进”“停止”)是否可见。 默认值为 yes

top:窗口顶部 (y 坐标) 相对于用户屏幕左上角的位置(以像素为单位)。 必须是正整数。

width:窗口工作区的宽度(以像素为单位)。 最小为 100 个像素;尝试打开小于此标准的窗口时,将根据 Internet Explorer 默认设置打开窗口。

replaceEntry
Boolean

true 将当前窗口的 URL url 替换为导航历史记录中的 。 这会影响类上 HtmlHistory 方法的操作。

返回

表示新窗口的 HtmlWindow,或者是以前创建的、由 target 参数命名的窗口。

示例

下面的代码示例包含两种方法:

  • 第一个 在名为 displayWindow的窗口中打开一个 URL,它创建时显示状态栏。
  • 第二个将在同一窗口中打开另一个 URL,但指定仅应显示位置栏。

请注意,窗口的尺寸和显示的控件取决于首先打开的 URL。 代码示例要求窗体包含名为 WebBrowserWebBrowser1控件。

private void DisplayFirstUrl()
{
    if (webBrowser1.Document != null)
    {
        //If this is called first, the window will only have a status bar.
        webBrowser1.Document.Window.Open(new Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", false);
    }
}

private void DisplaySecondUrl()
{
    if (webBrowser1.Document != null)
    {
        // If this is called first, the window will only have an Address bar.
        webBrowser1.Document.Window.Open(new Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", false);
    }
}

注解

参数 target 可以命名作为先前调用 Open的结果创建的窗口。 参数还可以指向通过单击超链接打开的窗口 (A 元素) 或使用 FORMTARGET 属性在新窗口中打开其 URL 的元素。 以下 HTML 代码将在用户单击时打开名为 orderWindow 的新窗口:

<A HREF="/startOrder.aspx" TARGET="orderWindow">Click to Start Order</a>

如果为 windowOptions 参数提供任何选项,则会自动禁用未包含的任何选项。 换句话说,如果仅通过 指定需要状态栏的方式 windowOptions ,则不会显示菜单栏、工具栏、标题、滚动条等,除非通过 windowOptions显式启用它们。

如果 引用 url 的文件是 HTML 文件、文本文件或可在 Internet Explorer 中托管的其他文件类型,则它将显示在命名窗口中。 如果文件不能显示在 Internet Explorer 内,并且目标命名的窗口不存在,则该窗口将只打开足够长的时间,供 Internet Explorer 下载资源;它随后会立即关闭。

使用 OpenOpenNew创建新窗口时,会导致 HTML 文档对象模型打开 Internet Explorer 的新实例。 如果不在创建的所有窗口上调用 Close ,即使应用程序退出,此 Internet Explorer 实例仍将保持运行状态。

如果使用 Open 在现有窗口中加载 URL, windowOptions 则 将被忽略;该窗口将保留通过对 的初始调用 Open首先给定它的尺寸、外观和屏幕位置。

另请参阅

适用于

.NET Framework 4.8.1 和其他版本
产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9