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
| Ausnahmetyp | Bedingung |
|---|---|
Tritt ein, wenn der relativeUrl-Parameter NULL (Nothing in Visual Basic) enthält. |
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