Exporter (0) Imprimer
Développer tout

Control.ResolveUrl, méthode

Convertit une URL en une URL que le client soit en mesure d'utiliser.

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

public string ResolveUrl (
	string relativeUrl
)
public String ResolveUrl (
	String relativeUrl
)
public function ResolveUrl (
	relativeUrl : String
) : String

Paramètres

relativeUrl

URL associée à la propriété TemplateSourceDirectory.

Valeur de retour

URL convertie.

Type d'exceptionCondition

ArgumentNullException

Se produit si le paramètre relativeUrl contient référence Null (Nothing en Visual Basic).

Si le paramètre relativeUrl contient une URL absolue, l'URL est retournée telle quelle. Si le paramètre relativeUrl contient une URL relative, celle-ci est convertie en une URL relative correcte pour le chemin d'accès de la demande en cours, de sorte que le navigateur puisse résoudre l'URL.

Observez par exemple le scénario suivant :

  • Un client a demandé une page ASP.NET contenant un contrôle utilisateur auquel une image est associée.

  • La page ASP.NET figure à l'emplacement /Store/page1.aspx.

  • Le contrôle utilisateur figure, lui, à l'emplacement /Store/UserControls/UC1.ascx.

  • Enfin, le chemin d'accès au fichier image est /UserControls/Images/Image1.jpg.

Si le contrôle utilisateur passe le chemin d'accès relatif de l'image (en l'occurrence, /Store/UserControls/Images/Image1.jpg) à la méthode ResolveUrl, cette dernière retourne la valeur /Images/Image1.jpg.

Cette méthode utilise la propriété TemplateSourceDirectory pour résoudre en l'URL absolue. L'URL retournée est destinée au client.

Pour plus d'informations sur les chemins d'accès de ressources dans un site Web, consultez Chemins d'accès aux sites Web ASP.NET.

L'exemple suivant crée un objet de contrôle serveur Web Image et utilise la méthode ResolveUrl pour définir le chemin d'accès à l'image, laquelle est stockée par la propriété ImageUrl.

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft