IStyleSheet.RegisterStyle(Style, IUrlResolutionService) Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

En cas d'implémentation dans une classe, ajoute une nouvelle règle de style à la feuille de style incorporée dans la section <head> d'une page Web.

public:
 void RegisterStyle(System::Web::UI::WebControls::Style ^ style, System::Web::UI::IUrlResolutionService ^ urlResolver);

public void RegisterStyle (System.Web.UI.WebControls.Style style, System.Web.UI.IUrlResolutionService urlResolver);

abstract member RegisterStyle : System.Web.UI.WebControls.Style * System.Web.UI.IUrlResolutionService -> unit

Public Sub RegisterStyle (style As Style, urlResolver As IUrlResolutionService)

Paramètres

style: Style

Règle de style à ajouter à la feuille de style incorporée.

urlResolver: IUrlResolutionService

Objet implémentant IUrlResolutionService qui contient les informations de contexte relatives à l'emplacement (URL) actuel.

Exemples

L’exemple de code suivant utilise l’implémentation Header de IStyleSheet pour illustrer la création d’un objet personnalisé Style , labelStyle, puis son inscription à l’emplacement actuel (URL). Ensuite, l’étiquette label1 appelle la MergeStyle méthode afin que le labelStyle style soit appliqué à l’étiquette label1 .

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(object sender, EventArgs e)
  {
    if (Page.Header != null)
    {
      // Create a Style object to hold style rules to apply to a Label control.
      Style labelStyle = new Style();

      labelStyle.ForeColor = System.Drawing.Color.DarkRed;
      labelStyle.BorderColor = System.Drawing.Color.DarkBlue;
      labelStyle.BorderWidth = 2;

      // Register the Style object so that it can be merged with 
      // the Style object of the controls that use it.
      Page.Header.StyleSheet.RegisterStyle(labelStyle, null);

      // Merge the labelCssStyle style with the label1 control's
      // style settings.
      label1.MergeStyle(labelStyle);
      label1.Text = "This is what the labelCssStyle looks like.";
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
    <title>IStyleSheet Example</title>
</head>    
<body>
    <form id="form1" runat="server">
        <h1>IStyleSheet Example</h1>
        <asp:Label 
          id="label1" 
          runat="server">
        </asp:Label>
    </form>
  </body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
  
    If Not Page.Header Is Nothing Then
    
      ' Create a Style object to hold style rules to apply to a Label control.
      Dim labelStyle As Style = New Style()

      labelStyle.ForeColor = System.Drawing.Color.DarkRed
      labelStyle.BorderColor = System.Drawing.Color.DarkBlue
      labelStyle.BorderWidth = 2

      ' Register the Style object so that it can be merged with 
      ' the Style object of the controls that use it.
      Page.Header.StyleSheet.RegisterStyle(labelStyle, Nothing)

      ' Merge the labelCssStyle style with the label1 control's
      ' style settings.
      label1.MergeStyle(labelStyle)
      label1.Text = "This is what the labelCssStyle looks like."
      
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
    <title>IStyleSheet Example</title>
</head>    
<body>
    <form id="form1" runat="server">
        <h1>IStyleSheet Example</h1>
        <asp:Label 
          id="label1" 
          runat="server">
        </asp:Label>
    </form>
  </body>
</html>

Remarques

Cette méthode ajoute une nouvelle règle de style et RegisteredCssClass un nouveau nom de propriété à la feuille de style incorporée dans la <head> section d’un Page objet, et associe la règle à un nom de style généré automatiquement. L’objet Style est rendu à l’aide du paramètre spécifié urlResolver .

Si urlResolver a la valeur null, l’URL du actuel Page est utilisée.

Si un Style objet est déjà inscrit, il n’est pas ajouté plusieurs fois.

Notes

L’ajout ou la modification de styles par programmation pendant les publications asynchrones n’est pas pris en charge. Lorsque vous ajoutez des fonctionnalités AJAX à une page web ASP.NET, les publications asynchrones mettent à jour les régions de la page sans mettre à jour la page entière. Pour plus d’informations, consultez Vue d’ensemble de Microsoft Ajax.

S’applique à

Partager via