UrlBuilder.BuildUrl Methode

Referenz

Definition

Namespace:: System.Web.UI.Design

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.

Überlädt

BuildUrl(IComponent, Control, String, String, String)	Erstellt ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.
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.
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.

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

Erstellt ein Benutzeroberflächenelement, mit dem eine URL erstellt oder ausgewählt werden kann.

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.

owner: Control

Das als übergeordnetes Element für das Auswahlfenster verwendete Control.

initialUrl: String

Die Ausgangs-URL, die im Auswahlfenster angezeigt werden soll.

caption: String

Die Beschriftung des Auswahlfensters.

filter: String

Die Filterzeichenfolge zum optionalen Filtern der Dateien, die im Auswahlfenster angezeigt werden.

Gibt zurück

String

Die vom Benutzeroberflächenelement zurückgegebene URL.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die BuildUrl -Methode verwenden, um zur Entwurfszeit einen URL-Generator über einen Menübefehl zu starten.

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

Weitere Informationen

UrlBuilderOptions

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.

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.

owner: Control

Das als übergeordnetes Element für das Auswahlfenster verwendete Control.

initialUrl: String

Die Ausgangs-URL, die im Auswahlfenster angezeigt werden soll.

caption: String

Die Beschriftung des Auswahlfensters.

filter: String

Die Filterzeichenfolge zum optionalen Filtern der Dateien, die im Auswahlfenster angezeigt werden.

options: UrlBuilderOptions

Ein UrlBuilderOptions, das die Optionen für die URL-Auswahl angibt.

Gibt zurück

String

Die vom Benutzeroberflächenelement zurückgegebene URL.

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

Weitere Informationen

UrlBuilderOptions

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.

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.

owner: Control

Das als übergeordnetes Element für das Auswahlfenster verwendete Control.

initialUrl: String

Die Ausgangs-URL, die im Auswahlfenster angezeigt werden soll.

caption: String

Die Beschriftung des Auswahlfensters.

filter: String

Die Filterzeichenfolge zum optionalen Filtern der Dateien, die im Auswahlfenster angezeigt werden.

options: UrlBuilderOptions

Ein UrlBuilderOptions, das die Optionen für die URL-Auswahl angibt.

Gibt zurück

String

Die vom Benutzeroberflächenelement zurückgegebene URL.

Hinweise

Die IServiceProvider -Schnittstelle wird verwendet, um die IDesignerHost Implementierung für den Designerhost abzurufen.

Weitere Informationen

UrlBuilderOptions

Gilt für:

UrlBuilder.BuildUrl Methode

Definition

Überlädt

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

Parameter

Gibt zurück

Beispiele

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Beispiele

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Hinweise

Weitere Informationen

Gilt für:

Feedback

Zusätzliche Ressourcen