UrlBuilder.BuildUrl Methode

Definition

Erstellt ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL.

Überlädt

BuildUrl(IComponent, Control, String, String, String)

Erstellt ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL.

BuildUrl(IComponent, Control, String, String, String, UrlBuilderOptions)

Erstellt unter Verwendung des angegebenen UrlBuilderOptions-Objekts ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL, using the specified UrlBuilderOptions object.

BuildUrl(IServiceProvider, Control, String, String, String, UrlBuilderOptions)

Erstellt unter Verwendung des angegebenen UrlBuilderOptions-Objekts ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL, using the specified UrlBuilderOptions object.

BuildUrl(IComponent, Control, String, String, String)

Erstellt ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL.

public:
 static System::String ^ BuildUrl(System::ComponentModel::IComponent ^ component, System::Windows::Forms::Control ^ owner, System::String ^ initialUrl, System::String ^ caption, System::String ^ filter);
public static string BuildUrl (System.ComponentModel.IComponent component, System.Windows.Forms.Control owner, string initialUrl, string caption, string filter);
static member BuildUrl : System.ComponentModel.IComponent * System.Windows.Forms.Control * string * string * string -> string
Public Shared Function BuildUrl (component As IComponent, owner As Control, initialUrl As String, caption As String, filter As String) As String

Parameter

component
IComponent

Die IComponent, deren Site für den Zugriff auf Entwurfszeitdienste verwendet werden soll.The IComponent whose site is to be used to access design-time services.

owner
Control

Das als übergeordnetes Element für das Auswahlfenster verwendete Control.The Control used as the parent for the picker window.

initialUrl
String

Die Ausgangs-URL, die im Auswahlfenster angezeigt werden soll.The initial URL to be shown in the picker window.

caption
String

Die Beschriftung des Auswahlfensters.The caption of the picker window.

filter
String

Die Filterzeichenfolge zum optionalen Filtern der Dateien, die im Auswahlfenster angezeigt werden.The filter string to use to optionally filter the files displayed in the picker window.

Gibt zurück

String

Die vom Benutzeroberflächenelement zurückgegebene URL.The URL returned from the UI.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die- BuildUrl Methode zum Starten eines URL-Generators über einen Menübefehl zur Entwurfszeit verwendet wird.The following code example shows how to use the BuildUrl method to launch a URL builder from a menu command at design time.

// Create a parent control.
System::Windows::Forms::Control^ c = gcnew System::Windows::Forms::Control;
c->CreateControl();

// Launch the Url Builder using the specified control
// parent, initial URL, empty relative base URL path,
// window caption, filter String* and URLBuilderOptions value.
UrlBuilder::BuildUrl( this->Component, c, "http://www.example.com", "Select a URL", "", UrlBuilderOptions::None );

// This method handles the "Launch Url Builder UI" menu command.
// Invokes the BuildUrl method of the System.Web.UI.Design.UrlBuilder.
private void launchUrlBuilder(object sender, EventArgs e)
{
    // Create a parent control.
    System.Windows.Forms.Control c = new System.Windows.Forms.Control();            
    c.CreateControl();            
                
    // Launch the Url Builder using the specified control
    // parent, initial URL, empty relative base URL path,
    // window caption, filter string and URLBuilderOptions value.
    UrlBuilder.BuildUrl(
        this.Component, 
        c, 
        "http://www.example.com", 
        "Select a URL", 
        "", 
        UrlBuilderOptions.None);                      
}        
' This method handles the "Launch Url Builder UI" menu command.
' Invokes the BuildUrl method of the System.Web.UI.Design.UrlBuilder.
Private Sub launchUrlBuilder(ByVal sender As Object, ByVal e As EventArgs)
    ' Create a parent control.
    Dim c As New System.Windows.Forms.Control()
    c.CreateControl()

    ' Launch the Url Builder using the specified control
    ' parent, initial URL, empty relative base URL path,
    ' window caption, filter string and URLBuilderOptions value.
    UrlBuilder.BuildUrl( _
        Me.Component, _
        c, _
        "http://www.example.com", _
        "Select a URL", _
        "", _
        UrlBuilderOptions.None)
End Sub

Siehe auch

Gilt für:

BuildUrl(IComponent, Control, String, String, String, UrlBuilderOptions)

Erstellt unter Verwendung des angegebenen UrlBuilderOptions-Objekts ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL, using the specified UrlBuilderOptions object.

public:
 static System::String ^ BuildUrl(System::ComponentModel::IComponent ^ component, System::Windows::Forms::Control ^ owner, System::String ^ initialUrl, System::String ^ caption, System::String ^ filter, System::Web::UI::Design::UrlBuilderOptions options);
public static string BuildUrl (System.ComponentModel.IComponent component, System.Windows.Forms.Control owner, string initialUrl, string caption, string filter, System.Web.UI.Design.UrlBuilderOptions options);
static member BuildUrl : System.ComponentModel.IComponent * System.Windows.Forms.Control * string * string * string * System.Web.UI.Design.UrlBuilderOptions -> string
Public Shared Function BuildUrl (component As IComponent, owner As Control, initialUrl As String, caption As String, filter As String, options As UrlBuilderOptions) As String

Parameter

component
IComponent

Die IComponent, deren Site für den Zugriff auf Entwurfszeitdienste verwendet werden soll.The IComponent whose site is to be used to access design-time services.

owner
Control

Das als übergeordnetes Element für das Auswahlfenster verwendete Control.The Control used as the parent for the picker window.

initialUrl
String

Die Ausgangs-URL, die im Auswahlfenster angezeigt werden soll.The initial URL to be shown in the picker window.

caption
String

Die Beschriftung des Auswahlfensters.The caption of the picker window.

filter
String

Die Filterzeichenfolge zum optionalen Filtern der Dateien, die im Auswahlfenster angezeigt werden.The filter string to use to optionally filter the files displayed in the picker window.

options
UrlBuilderOptions

Ein UrlBuilderOptions, das die Optionen für die URL-Auswahl angibt.A UrlBuilderOptions indicating the options for URL selection.

Gibt zurück

String

Die vom Benutzeroberflächenelement zurückgegebene URL.The URL returned from the UI.

Beispiele

// Create a parent control.
System::Windows::Forms::Control^ c = gcnew System::Windows::Forms::Control;
c->CreateControl();

// Launch the Url Builder using the specified control
// parent, initial URL, empty relative base URL path,
// window caption, filter String* and URLBuilderOptions value.
UrlBuilder::BuildUrl( this->Component, c, "http://www.example.com", "Select a URL", "", UrlBuilderOptions::None );

// This method handles the "Launch Url Builder UI" menu command.
// Invokes the BuildUrl method of the System.Web.UI.Design.UrlBuilder.
private void launchUrlBuilder(object sender, EventArgs e)
{
    // Create a parent control.
    System.Windows.Forms.Control c = new System.Windows.Forms.Control();            
    c.CreateControl();            
                
    // Launch the Url Builder using the specified control
    // parent, initial URL, empty relative base URL path,
    // window caption, filter string and URLBuilderOptions value.
    UrlBuilder.BuildUrl(
        this.Component, 
        c, 
        "http://www.example.com", 
        "Select a URL", 
        "", 
        UrlBuilderOptions.None);                      
}        
' This method handles the "Launch Url Builder UI" menu command.
' Invokes the BuildUrl method of the System.Web.UI.Design.UrlBuilder.
Private Sub launchUrlBuilder(ByVal sender As Object, ByVal e As EventArgs)
    ' Create a parent control.
    Dim c As New System.Windows.Forms.Control()
    c.CreateControl()

    ' Launch the Url Builder using the specified control
    ' parent, initial URL, empty relative base URL path,
    ' window caption, filter string and URLBuilderOptions value.
    UrlBuilder.BuildUrl( _
        Me.Component, _
        c, _
        "http://www.example.com", _
        "Select a URL", _
        "", _
        UrlBuilderOptions.None)
End Sub

Siehe auch

Gilt für:

BuildUrl(IServiceProvider, Control, String, String, String, UrlBuilderOptions)

Erstellt unter Verwendung des angegebenen UrlBuilderOptions-Objekts ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.Creates a UI to create or pick a URL, using the specified UrlBuilderOptions object.

public:
 static System::String ^ BuildUrl(IServiceProvider ^ serviceProvider, System::Windows::Forms::Control ^ owner, System::String ^ initialUrl, System::String ^ caption, System::String ^ filter, System::Web::UI::Design::UrlBuilderOptions options);
public static string BuildUrl (IServiceProvider serviceProvider, System.Windows.Forms.Control owner, string initialUrl, string caption, string filter, System.Web.UI.Design.UrlBuilderOptions options);
static member BuildUrl : IServiceProvider * System.Windows.Forms.Control * string * string * string * System.Web.UI.Design.UrlBuilderOptions -> string
Public Shared Function BuildUrl (serviceProvider As IServiceProvider, owner As Control, initialUrl As String, caption As String, filter As String, options As UrlBuilderOptions) As String

Parameter

serviceProvider
IServiceProvider

Der IServiceProvider, der für den Zugriff auf Entwurfszeitdienste verwendet werden soll.The IServiceProvider to be used to access design-time services.

owner
Control

Das als übergeordnetes Element für das Auswahlfenster verwendete Control.The Control used as the parent for the picker window.

initialUrl
String

Die Ausgangs-URL, die im Auswahlfenster angezeigt werden soll.The initial URL to be shown in the picker window.

caption
String

Die Beschriftung des Auswahlfensters.The caption of the picker window.

filter
String

Die Filterzeichenfolge zum optionalen Filtern der Dateien, die im Auswahlfenster angezeigt werden.The filter string to use to optionally filter the files displayed in the picker window.

options
UrlBuilderOptions

Ein UrlBuilderOptions, das die Optionen für die URL-Auswahl angibt.A UrlBuilderOptions indicating the options for URL selection.

Gibt zurück

String

Die vom Benutzeroberflächenelement zurückgegebene URL.The URL returned from the UI.

Hinweise

Die- IServiceProvider Schnittstelle wird verwendet, um die IDesignerHost Implementierung für den Designer Host zu erhalten.The IServiceProvider interface is used to obtain the IDesignerHost implementation for the designer host.

Siehe auch

Gilt für: