IStyleSheet.RegisterStyle(Style, IUrlResolutionService) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Wanneer deze wordt geïmplementeerd door een klasse, voegt u een nieuwe stijlregel toe aan het ingesloten opmaakmodel in de <head> sectie van een webpagina.

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)

Parameters

style
Style

De stijlregel die moet worden toegevoegd aan het ingesloten opmaakmodel.

urlResolver
IUrlResolutionService

Een IUrlResolutionService-geïmplementeerd object dat de contextinformatie voor de huidige locatie (URL) bevat.

Voorbeelden

In het volgende codevoorbeeld wordt de Header implementatie gebruikt om het maken van IStyleSheet een aangepast Style object labelStylete demonstreren en het vervolgens te registreren voor de huidige locatie (URL). Vervolgens roept het label1 label de MergeStyle methode aan, zodat de labelStyle stijl wordt toegepast op het label1 label.

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

Opmerkingen

Met deze methode voegt u een nieuwe stijlregel en RegisteredCssClass eigenschapsnaam toe aan het ingesloten opmaakmodel in de <head> sectie van een Page object en koppelt u de regel aan een automatisch gegenereerde stijlnaam. Het Style object wordt weergegeven met behulp van de opgegeven urlResolver parameter.

Als urlResolver deze optie is ingesteld null, wordt de URL van de huidige Page gebruikt.

Als een Style object al is geregistreerd, wordt het niet meerdere keren toegevoegd.

Note

Het programmatisch toevoegen of wijzigen van stijlen tijdens asynchrone postbacks wordt niet ondersteund. Wanneer u AJAX-mogelijkheden toevoegt aan een ASP.NET webpagina, worden asynchrone postbacks regio's van de pagina bijgewerkt zonder de hele pagina bij te werken. Zie Microsoft Ajax-overzicht voor meer informatie.

Van toepassing op