(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Control.ResolveUrl-Methode

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.

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

public string ResolveUrl(
	string relativeUrl
)

Parameter

relativeUrl
Typ: System.String
Die der TemplateSourceDirectory-Eigenschaft zugeordnete URL.

Rückgabewert

Typ: System.String
Die konvertierte URL.

AusnahmeBedingung
ArgumentNullException

Tritt ein, wenn der relativeUrl-Parameter null enthält.

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

Beispiel:

  • 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 die absolute URL. Die zurückgegebene URL ist für die Verwendung durch den Client bestimmt.

Weitere Informationen zu Ressourcenpfaden in einer Website finden Sie unter ASP.NET Web Site Paths.

HinweisHinweis

Bei mobilen Webseiten und wenn die Anwendung Sitzungen ohne Cookies verwendet oder Anforderungen von mobilen Browsern erhalten kann, für die Sitzungen ohne Cookies erforderlich sind, kann die Verwendung einer Tilde ("~") in einem Pfad dazu führen, dass unbeabsichtigt eine neue Sitzung erstellt wird und Sitzungsdaten verloren gehen. Wenn Sie für eine Eigenschaft einen Pfad wie "~/path" festlegen möchten, lösen Sie den Pfad auf, indem Sie ResolveUrl mit einem Argument wie "~/path" aufrufen, bevor Sie ihn der Eigenschaft zuweisen.

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


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft