Freigeben über

HtmlWindow.Open Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Zeigt eine Datei im benannten Fenster an.

Überlädt

Open(String, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.
Open(Uri, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.

Open(String, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.

public:
 System::Windows::Forms::HtmlWindow ^ Open(System::String ^ urlString, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);
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);
member this.Open : string * string * string * bool -> System.Windows.Forms.HtmlWindow
Public Function Open (urlString As String, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Parameter

urlString
String

Die URL (Uniform Resource Locator), die den Speicherort der zu ladenden Datei beschreibt.

target
String

Der Name des Fensters, in dem die Ressource geöffnet werden soll. Hierbei kann es sich um einen vom Entwickler angegebenen Namen oder um einen der folgenden speziellen Werte handeln:

_blank: Wird in einem neuen Fenster geöffnet urlString . Funktioniert wie ein Aufruf von OpenNew(String, String).

_media: Wird in der Medienleiste geöffnet urlString .

_parent: Wird in dem Fenster geöffnet urlString , in dem das aktuelle Fenster erstellt wurde.

_search: Wird in der Suchleiste geöffnet urlString .

_self: Wird im aktuellen Fenster geöffnet urlString .

_top: Wird für ein Fenster aufgerufen, das zu einem FRAME Element gehört, wird in dem Fenster geöffnet urlString , in dem das -Element gehostet wird FRAMESET. Andernfalls verhält sich wie _self.

windowOptions
String

Eine durch Trennzeichen getrennte Zeichenfolge, die aus null oder mehr der folgenden Optionen im Format name=valuebesteht. Mit Ausnahme der leftOptionen , top, heightund width , die beliebige ganze Zahlen annehmen, akzeptiert yes jede Option oder 1, und no oder 0als gültige Werte.

channelmode: Wird mit der veralteten Kanaltechnologie von Internet Explorer 4.0 verwendet. Der Standardwert ist no.

directories: Gibt an, ob im Fenster Schaltflächen für die Verzeichnisnavigation angezeigt werden sollen. Der Standardwert ist yes.

height: Die Höhe des Clientbereichs des Fensters in Pixel. Der Mindestwert ist 100. Beim Versuch, ein kleineres Fenster zu öffnen, wird das Fenster entsprechend der Standardeinstellungen von Internet Explorer geöffnet.

left: Die linke Position (x-Koordinate) des Fensters, in Bezug auf die linke obere Ecke des Benutzerbildschirms (in Pixel). Der Wert muss eine positive ganze Zahl sein.

location: Gibt an, ob die Adressleiste angezeigt werden soll, mit der Benutzer im Fenster zu einer neuen URL navigieren können. Der Standardwert ist yes.

menubar: Gibt an, ob im neuen Fenster Menüs angezeigt werden sollen. Der Standardwert ist yes.

resizable: Gibt an, ob die Größe des Fensters durch den Benutzer geändert werden kann. Der Standardwert ist yes.

scrollbars: Gibt an, ob das Fenster horizontale und vertikale Bildlaufleisten aufweist. Der Standardwert ist yes.

status: Gibt an, ob das Fenster am unteren Rand einen status Balken aufweist. Der Standardwert ist yes.

titlebar: Gibt an, ob der Titel der aktuellen Seite angezeigt wird. Das Festlegen dieser Option auf no hat innerhalb einer verwalteten Anwendung keine Auswirkungen. Die Titelleiste wird immer angezeigt.

toolbar: Gibt an, ob Symbolleistenschaltflächen wie Zurück, Vorwärts und Beenden sichtbar sind. Der Standardwert ist yes.

top: Die obere Position (y-Koordinate) des Fensters relativ zur oberen linken Ecke des Bildschirms des Benutzers in Pixeln. Der Wert muss eine positive ganze Zahl sein.

width: Die Breite des Clientbereichs des Fensters in Pixel. Der Mindestwert ist 100. Beim Versuch, ein kleineres Fenster zu öffnen, wird das Fenster entsprechend der Standardeinstellungen von Internet Explorer geöffnet.

replaceEntry
Boolean

true , um die URL des aktuellen Fensters im Navigationsverlauf durch urlString zu ersetzen. Dies wirkt sich auf die Ausführung von Methoden für die HtmlHistory-Klasse aus.

Gibt zurück

HtmlWindow

Das neue Fenster oder das zuvor erstellte Fenster mit dem Namen des target Parameters.

Hinweise

Der target -Parameter kann ein Fenster benennen, das als Ergebnis eines vorherigen Aufrufs Openvon erstellt wurde. Der Parameter kann auch auf ein Fenster zeigen, das durch Klicken auf einen Link (A Element) geöffnet wird, oder auf ein FORM Element, das das TARGET -Attribut verwendet, um seine URL in einem neuen Fenster zu öffnen. Der folgende HTML-Code öffnet ein neues Fenster namens orderWindow , wenn der Benutzer darauf klickt:

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

Wenn Sie Optionen für den windowOptions Parameter angeben, wird jede nicht enthaltene Option automatisch deaktiviert. Anders ausgedrückt: Wenn Sie nur eine status Leiste angebenwindowOptions, werden die Menüleiste, die Symbolleiste, der Titel, die Bildlaufleiste usw. nur angezeigt, wenn Sie sie explizit über windowOptionsaktivieren.

Wenn es sich bei der Datei, auf die von url verwiesen wird, um eine HTML-Datei, eine Textdatei oder einen anderen Dateityp handelt, der innerhalb von Internet Explorer gehostet werden kann, wird sie im benannten Fenster angezeigt. Wenn die Datei nicht innerhalb von Internet Explorer angezeigt werden kann und das nach Ziel benannte Fenster noch nicht vorhanden ist, wird das Fenster nur so lange geöffnet, dass internet Explorer die Ressource herunterladen kann. Es wird unmittelbar danach geschlossen.

Wenn Sie neue Fenster mit Open oder OpenNewerstellen, wird durch das HTML-Dokumentobjektmodell eine neue instance von Internet Explorer geöffnet. Wenn Sie nicht in allen von Ihnen erstellten Fenstern aufrufenClose, wird diese instance von Internet Explorer auch nach dem Beenden Ihrer Anwendung weiterhin ausgeführt.

Wenn Sie verwenden Open , um eine URL in einem vorhandenen Fenster zu laden, windowOptions wird ignoriert. Das Fenster behält die Dimensionen, das Aussehen und die Bildschirmposition bei, die es zuerst durch den ersten Aufruf Openvon erhalten hat.

Gilt für:

Open(Uri, String, String, Boolean)

Zeigt eine Datei im benannten Fenster an.

public:
 System::Windows::Forms::HtmlWindow ^ Open(Uri ^ url, System::String ^ target, System::String ^ windowOptions, bool replaceEntry);
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);
member this.Open : Uri * string * string * bool -> System.Windows.Forms.HtmlWindow
Public Function Open (url As Uri, target As String, windowOptions As String, replaceEntry As Boolean) As HtmlWindow

Parameter

url
Uri

Die URL (Uniform Resource Locator), die den Speicherort der zu ladenden Datei beschreibt.

target
String

Der Name des Fensters, in dem die Ressource geöffnet werden soll. Hierbei kann es sich um einen vom Entwickler angegebenen Namen oder um einen der folgenden speziellen Werte handeln:

_blank: Wird in einem neuen Fenster geöffnet url . Funktioniert wie ein Aufruf von OpenNew(String, String).

_media: Wird in der Medienleiste geöffnet url .

_parent: Wird in dem Fenster geöffnet url , in dem das aktuelle Fenster erstellt wurde.

_search: Wird in der Suchleiste geöffnet url .

_self: Wird im aktuellen Fenster geöffnet url .

_top: Wird für ein Fenster aufgerufen, das zu einem FRAME Element gehört, wird in dem Fenster geöffnet url , in dem das -Element gehostet wird FRAMESET. Andernfalls verhält sich wie _self.

windowOptions
String

Eine durch Trennzeichen getrennte Zeichenfolge, die aus null oder mehr der folgenden Optionen im Format name=valuebesteht. Mit Ausnahme der leftOptionen , top, heightund width , die beliebige ganze Zahlen annehmen, akzeptiert yes jede Option oder 1, und no oder 0als gültige Werte.

channelmode: Wird mit der veralteten Kanaltechnologie von Internet Explorer 4.0 verwendet. Der Standardwert ist no.

directories: Gibt an, ob im Fenster Schaltflächen für die Verzeichnisnavigation angezeigt werden sollen. Der Standardwert ist yes.

height: Die Höhe des Clientbereichs des Fensters in Pixel. Der Mindestwert ist 100. Beim Versuch, ein kleineres Fenster zu öffnen, wird das Fenster entsprechend der Standardeinstellungen von Internet Explorer geöffnet.

left: Die linke Position (x-Koordinate) des Fensters, in Bezug auf die linke obere Ecke des Benutzerbildschirms (in Pixel). Der Wert muss eine positive ganze Zahl sein.

location: Gibt an, ob die Adressleiste angezeigt werden soll, mit der Benutzer im Fenster zu einer neuen URL navigieren können. Der Standardwert ist yes.

menubar: Gibt an, ob im neuen Fenster Menüs angezeigt werden sollen. Der Standardwert ist yes.

resizable: Gibt an, ob die Größe des Fensters durch den Benutzer geändert werden kann. Der Standardwert ist yes.

scrollbars: Gibt an, ob das Fenster horizontale und vertikale Bildlaufleisten aufweist. Der Standardwert ist yes.

status: Gibt an, ob das Fenster am unteren Rand einen status Balken aufweist. Der Standardwert ist yes.

titlebar: Gibt an, ob der Titel der aktuellen Seite angezeigt wird. Das Festlegen dieser Option auf no hat innerhalb einer verwalteten Anwendung keine Auswirkungen. Die Titelleiste wird immer angezeigt.

toolbar: Gibt an, ob Symbolleistenschaltflächen wie Zurück, Vorwärts und Beenden sichtbar sind. Der Standardwert ist yes.

top: Die obere Position (y-Koordinate) des Fensters relativ zur oberen linken Ecke des Bildschirms des Benutzers in Pixeln. Der Wert muss eine positive ganze Zahl sein.

width: Die Breite des Clientbereichs des Fensters in Pixel. Der Mindestwert ist 100. Beim Versuch, ein kleineres Fenster zu öffnen, wird das Fenster entsprechend der Standardeinstellungen von Internet Explorer geöffnet.

replaceEntry
Boolean

true , um die URL des aktuellen Fensters im Navigationsverlauf durch url zu ersetzen. Dies wirkt sich auf den Betrieb von Methoden für die HtmlHistory -Klasse aus.

Gibt zurück

HtmlWindow

Ein HtmlWindow, das das neue Fenster darstellt, oder das zuvor erstellte Fenster, das durch den target-Parameter benannte wurde.

Beispiele

Das folgende Codebeispiel enthält zwei Methoden:

  • Die erste öffnet eine URL in einem Fenster namens displayWindow, das erstellt wird, wobei eine status leiste angezeigt wird.
  • Die zweite öffnet eine weitere URL im selben Fenster, gibt jedoch an, dass nur die Positionsleiste angezeigt werden soll.

Beachten Sie, dass die Dimensionen des Fensters und der angezeigten Steuerelemente davon abhängen, welche URL zuerst geöffnet wird. Das Codebeispiel erfordert, dass ihr Formular ein WebBrowser Steuerelement mit dem Namen WebBrowser1enthält.

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

Private Sub DisplayFirstUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have a status bar.
            .Window.Open(New Uri("http://www.microsoft.com/"), "displayWindow", "status=yes,width=200,height=400", False)
        End With
    End If
End Sub

Private Sub DisplaySecondUrl()
    If (WebBrowser1.Document IsNot Nothing) Then
        With WebBrowser1.Document
            ' If this is called first, the window will only have an Address bar.
            .Window.Open(New Uri("http://msdn.microsoft.com/"), "displayWindow", "width=400,height=200,location=yes", False)
        End With
    End If
End Sub

Hinweise

Der target -Parameter kann ein Fenster benennen, das als Ergebnis eines vorherigen Aufrufs Openvon erstellt wurde. Der Parameter kann auch auf ein Fenster verweisen, das durch Klicken auf einen Link (A Element) geöffnet wird, oder auf ein FORM Element, das das TARGET Attribut verwendet, um seine URL in einem neuen Fenster zu öffnen. Der folgende HTML-Code öffnet ein neues Fenster namens, orderWindow wenn der Benutzer darauf klickt:

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

Wenn Sie Optionen für den windowOptions Parameter angeben, wird jede nicht enthaltene Option automatisch deaktiviert. Anders ausgedrückt: Wenn Sie nur eine windowOptions status Leiste angeben, werden menüleiste, Symbolleiste, Titel, Bildlaufleisten usw. nicht angezeigt, es sei denn, Sie aktivieren sie explizit über windowOptions.

Wenn es sich bei der Datei, auf die von url verwiesen wird, um eine HTML-Datei, textdatei oder einen anderen Dateityp handelt, der innerhalb von Internet Explorer gehostet werden kann, wird sie im benannten Fenster angezeigt. Wenn die Datei nicht innerhalb von Internet Explorer angezeigt werden kann und das Fenster nach Ziel noch nicht vorhanden ist, wird das Fenster nur lange genug geöffnet, damit internet Explorer die Ressource herunterladen können. Anschließend wird es geschlossen.

Wenn Sie neue Fenster mit Open oder OpenNewerstellen, führt dies dazu, dass das HTML-Dokumentobjektmodell eine neue instance von Internet Explorer öffnet. Wenn Sie nicht für alle fenster aufrufenClose, die Sie erstellt haben, wird diese instance von Internet Explorer auch nach dem Beenden Ihrer Anwendung weiterhin ausgeführt.

Wenn Sie Open verwenden, um eine URL in einem vorhandenen Fenster zu laden, windowOptions wird ignoriert. Das Fenster behält die Dimensionen, das Erscheinungsbild und die Bildschirmposition bei, die zuerst durch den ersten Aufruf Openvon angegeben wurden.

Weitere Informationen

Gilt für: