Control.ResolveUrl(String) Méthode

Définition

Convertit une URL en une URL que le client soit en mesure d'utiliser.Converts a URL into one that is usable on the requesting client.

public:
 System::String ^ ResolveUrl(System::String ^ relativeUrl);
public string ResolveUrl (string relativeUrl);
member this.ResolveUrl : string -> string
Public Function ResolveUrl (relativeUrl As String) As String

Paramètres

relativeUrl
String

URL associée à la propriété TemplateSourceDirectory.The URL associated with the TemplateSourceDirectory property.

Retours

URL convertie.The converted URL.

Exceptions

Se produit si le paramètre relativeUrl contient null.Occurs if the relativeUrl parameter contains null.

Exemples

L’exemple suivant crée un objet de contrôle de serveur Web Image et utilise la méthode ResolveUrl pour définir le chemin d’accès à l’image, qui est stockée par la propriété ImageUrl.The following example creates an Image Web server control object and uses the ResolveUrl method to set the path to the image, which is stored by the ImageUrl property.

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

Remarques

Si le paramètre relativeUrl contient une URL absolue, l’URL est retournée inchangée.If the relativeUrl parameter contains an absolute URL, the URL is returned unchanged. Si le paramètre relativeUrl contient une URL relative, cette URL est remplacée par une URL relative qui est correcte pour le chemin d’accès de la requête actuelle, afin que le navigateur puisse résoudre l’URL.If the relativeUrl parameter contains a relative URL, that URL is changed to a relative URL that is correct for the current request path, so that the browser can resolve the URL.

Par exemple, examinez le scénario suivant :For example, consider the following scenario:

  • Un client a demandé une page ASP.NET qui contient un contrôle utilisateur auquel une image est associée.A client has requested an ASP.NET page that contains a user control that has an image associated with it.

  • La page ASP.NET se trouve dans/Store/Page1.aspx.The ASP.NET page is located at /Store/page1.aspx.

  • Le contrôle utilisateur se trouve dans/Store/UserControls/UC1.ascx.The user control is located at /Store/UserControls/UC1.ascx.

  • Le fichier image se trouve dans/UserControls/Images/Image1.jpg.The image file is located at /UserControls/Images/Image1.jpg.

Si le contrôle utilisateur passe le chemin d’accès relatif à l’image (autrement dit,/Store/UserControls/Images/Image1.jpg) à la méthode ResolveUrl, la méthode retourne la valeur/Images/Image1.jpg.If the user control passes the relative path to the image (that is, /Store/UserControls/Images/Image1.jpg) to the ResolveUrl method, the method will return the value /Images/Image1.jpg.

Cette méthode utilise la propriété TemplateSourceDirectory pour résoudre l’URL absolue.This method uses the TemplateSourceDirectory property to resolve to the absolute URL. L’URL retournée est destinée à être utilisée par le client.The returned URL is for client use.

Pour plus d’informations sur les chemins d’accès aux ressources d’un site Web, consultez chemins d’accès aux projets web ASP.net.For more information on resource paths in a Web site, see ASP.NET Web Project Paths.

Notes

Pour les pages Web mobiles uniquement, si votre application s’appuie sur des sessions sans cookies ou peut recevoir des demandes de navigateurs mobiles qui requièrent des sessions sans cookies, l’utilisation d’un tilde («~») dans un chemin d’accès peut entraîner la création par inadvertance d’une nouvelle session et éventuellement perte des données de session.For mobile Web pages only, if your application relies on cookieless sessions or might receive requests from mobile browsers that require cookieless sessions, using a tilde ("~") in a path can result in inadvertently creating a new session and potentially losing session data. Pour définir une propriété avec un chemin d’accès tel que «~/chemin d’accès », résolvez le chemin d’accès en appelant la ResolveUrl avec un argument tel que «~/chemin d’accès » avant de l’assigner à la propriété.To set a property with a path such as "~/path", resolve the path by calling the ResolveUrl with an argument such as "~/path" before assigning it to the property.

S’applique à

Voir aussi