IStyleSheet.RegisterStyle(Style, IUrlResolutionService) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Quando implementato da una classe, aggiunge una nuova regola di stile al foglio di stile incorporato nella sezione <head> di una pagina 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)

Parametri

style
Style

Regola di stile da aggiungere al foglio di stile incorporato.

urlResolver
IUrlResolutionService

Oggetto implementato da IUrlResolutionService contenente le informazioni contestuali relative al percorso corrente (URL).

Esempio

Nell'esempio di codice seguente viene usata l'implementazione di per illustrare la Header creazione di IStyleSheet un oggetto personalizzato Style , labelStyle, e quindi la registrazione per il percorso corrente (URL). L'etichetta chiama quindi label1 il MergeStyle metodo in modo che lo labelStyle stile venga applicato all'etichetta 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>

Commenti

Questo metodo aggiunge una nuova regola di stile e RegisteredCssClass un nuovo nome di proprietà al foglio di stile incorporato all'interno della <head> sezione di un Page oggetto e associa la regola a un nome di stile generato automaticamente. Il rendering dell'oggetto Style viene eseguito usando il parametro specificato urlResolver .

Se urlResolver è impostato su null, viene usato l'URL dell'oggetto corrente Page .

Se un Style oggetto è già registrato, non viene aggiunto più volte.

Nota

L'aggiunta o la modifica di stili a livello di codice durante i postback asincroni non è supportata. Quando si aggiungono funzionalità AJAX a una pagina Web ASP.NET, i postback asincroni aggiornano le aree della pagina senza aggiornare l'intera pagina. Per altre informazioni, vedere Panoramica di Microsoft Ajax.

Si applica a