Control.ResolveUrl-Methode

Konvertiert einen URL in einen vom anfordernden Client verwendbaren URL.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Function ResolveUrl ( _
    relativeUrl As String _
) As String
'Usage
Dim instance As Control
Dim relativeUrl As String
Dim returnValue As String

returnValue = instance.ResolveUrl(relativeUrl)

public string ResolveUrl (
    string relativeUrl
)

public:
String^ ResolveUrl (
    String^ relativeUrl
)

public String ResolveUrl (
    String relativeUrl
)

public function ResolveUrl (
    relativeUrl : String
) : String

Parameter

• relativeUrl
  Der der TemplateSourceDirectory-Eigenschaft zugeordnete URL.

Rückgabewert

Der konvertierte URL.

Ausnahmen

Hinweise

Wenn der relativeUrl-Parameter einen absoluten URL enthält, wird dieser unverändert zurückgegeben. Wenn der relativeUrl-Parameter einen relativen URL enthält, wird dieser in einen relativen URL umgewandelt, der für den Pfad der aktuellen Anforderung korrekt ist, sodass der Browser den URL auflösen kann.

Betrachten Sie beispielsweise das folgende Szenario:

• Ein Client hat eine ASP.NET-Seite angefordert, die ein benutzerdefiniertes Steuerelement enthält, dem ein Bild zugeordnet ist.

• Die ASP.NET-Seite befindet sich unter /Store/page1.aspx.

• Das benutzerdefinierte Steuerelement befindet sich unter /Store/UserControls/UC1.ascx.

• Die Bilddatei befindet sich unter /UserControls/Images/Image1.jpg.

Wenn das benutzerdefinierte Steuerelement den relativen Pfad für das Bild (also //Store/UserControls/Images/Image1.jpg) an die ResolveUrl-Methode übergibt, gibt die Methode den Wert /Images/Image1.jpg zurück.

Diese Methode verwendet die TemplateSourceDirectory-Eigenschaft zum Auflösen in den absoluten URL. Der zurückgegebene URL ist für die Verwendung durch den Client bestimmt.

Weitere Informationen zu Ressourcenpfaden in einer Website finden Sie unter ASP.NET-Websitepfade.

Beispiel

Im folgenden Beispiel wird ein Image-Webserver-Steuerelementobjekt erstellt, und mithilfe der ResolveUrl-Methode wird der Pfad des Bilds festgelegt, der in der ImageUrl-Eigenschaft gespeichert wird.

Public Class MyResolveUrl
   Inherits Control
   Private _ImageUrl As String

   Public Property ImageUrl() As String
      Get
         Return _ImageUrl
      End Get
      Set
         _ImageUrl = value
      End Set
   End Property

   Protected Overrides Sub Render(output As HtmlTextWriter)
      Dim myImage As New System.Web.UI.WebControls.Image()
      ' Resolve Url.
      myImage.ImageUrl = ResolveUrl(Me.ImageUrl)
      myImage.RenderControl(output)
   End Sub
End Class

public class MyResolveUrl:Control
{
   private string _ImageUrl;     
   public string ImageUrl
   {
      get
      {
         return _ImageUrl;
      }
      set
      {
         _ImageUrl = value;
      }
   }
   protected override void Render(HtmlTextWriter output)
   {           
      Image myImage = new Image();
      // Resolve Url.
      myImage.ImageUrl = ResolveUrl(this.ImageUrl);
      myImage.RenderControl(output);         
   }     
}

public class MyResolveUrl extends Control
{
    private String _ImageUrl;

    /** @property 
     */
    public String get_ImageUrl()
    {
        return _ImageUrl;
    } //get_ImageUrl

    /** @property 
     */
    public void set_ImageUrl(String value)
    {
        _ImageUrl = value;
    } //set_ImageUrl

    protected void Render(HtmlTextWriter output)
    {
        Image myImage = new Image();

        // Resolve Url.
        myImage.set_ImageUrl(ResolveUrl(this.get_ImageUrl()));
        myImage.RenderControl(output);
    } //Render
} //MyResolveUrl

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace
TemplateSourceDirectory

Weitere Ressourcen

ASP.NET-Websitepfade