IStyleSheet IStyleSheet IStyleSheet IStyleSheet Interface

Definition

Definiert die Methoden, die eine Klasse implementieren muss, um das Erstellen von Formatierungsregeln zu unterstützen.Defines the methods that a class must implement in order to support the creation of style rules.

public interface class IStyleSheet
public interface IStyleSheet
type IStyleSheet = interface
Public Interface IStyleSheet

Beispiele

Im folgenden Codebeispiel wird die Header Implementierung von IStyleSheet verwendet, um das programmgesteuerte Erstellen einer neuen Stilregel und das Style Registrieren des benutzerdefinierten Objekts zu veranschaulichen.The following code example uses the Header implementation of IStyleSheet to demonstrate programmatically creating a new style rule and registering the custom Style object.

Im ersten Teil des Beispiels wird ein benutzerdefiniertes Style - labelStyleObjekt erstellt und dann für den aktuellen Speicherort (URL) registriert.In the first part of the example, a custom Style object, labelStyle, is created and then registered for the current location (URL). Die label1 Bezeichnung ruft dann die MergeStyle -Methode auf, labelStyle sodass der Stil auf die label1 Bezeichnung angewendet wird.Then the label1 label calls the MergeStyle method so that the labelStyle style is applied to the label1 label.

Im zweiten Teil des Beispiels wird ein anderes Benutzer Style definiertes bodyStyleObjekt definiert, und seine Eigenschaften werden festgelegt, um eine neue Stilregel zu erstellen.The second part of the example defines another custom Style object, bodyStyle,and sets its properties to create a new style rule.

Hinweis

Diese Klasse ist hauptsächlich für Entwickler gedacht, die eine benutzerdefinierte Implementierung erstellen möchten.This class is intended primarily for developers that want to create a custom implementation. Dieses Beispiel veranschaulicht die Implementierung, die vom .NET Framework bereitgestellt wird.This example demonstrates the implementation provided by the .NET Framework.

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="istylesheetcs.aspx.cs" Inherits="istylesheetcs" %>

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

<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>
        <br /><br />
        <asp:Label 
          id="label2" 
          runat="server">
        </asp:Label>
    </form>
  </body>
</html>
<%@ Page Language="VB" AutoEventWireup="true" CodeFile="istylesheetvb.aspx.vb" Inherits="istylesheetvb" %>

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

<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>
        <br /><br />
        <asp:Label 
          id="label2" 
          runat="server">
        </asp:Label>
    </form>
  </body>
</html>

Im folgenden Beispiel wird die Code Behind-Datei für die Webseite angezeigt.The following is the code-behind file for the Web page in the preceding example.

public partial class istylesheetcs : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        // 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.";


        // Create a Style object for the <BODY> section of the Web page.
        Style bodyStyle = new Style();

        bodyStyle.ForeColor = System.Drawing.Color.Blue;
        bodyStyle.BackColor = System.Drawing.Color.LightGray;

        // Add the style to the header of the current page.
        Page.Header.StyleSheet.CreateStyleRule(bodyStyle, null, "BODY");

        // Add text to the label2 control to see the label without 
        // the labelStyle applied to it.  
        label2.Text = "This is what the bodyStyle looks like.";
    }
}

Hinweise

Klassen, die diese Schnittstelle implementieren, können Sie verwenden, um die Erstellung von Stilregeln zu unterstützen.Classes that implement this interface can use it to support the creation of style rules.

Zum Anpassen der Art und Weise, wie Cascading Stylesheets erstellt und registriert werden, müssen Sie eine Klasse erstellen, die diese Schnittstelle implementiert.To customize the way cascading style sheets are created and registered, you must create a class that implements this interface.

Die HtmlHead -Klasse implementiert diese Schnittstelle für die Verwendung durch Header ASP.net durch die-Eigenschaft.The HtmlHead class implements this interface for use by ASP.NET through the Header property.

Hinweis

Das Hinzufügen oder Ändern von Stilen oder Stilregeln bei asynchronen Postbacks wird nicht unterstützt.Adding or modifying styles or style rules programmatically during asynchronous postbacks is not supported. Wenn Sie einer ASP.NET-Webseite AJAX-Funktionen hinzufügen, werden die Bereiche der Seite durch asynchrone Postbacks aktualisiert, ohne dass die gesamte Seite aktualisiert wird.When you add AJAX capabilities to an ASP.NET Web page, asynchronous postbacks update regions of the page without updating the whole page. Weitere Informationen finden Sie unter Übersicht über Microsoft AJAX.For more information, see Microsoft Ajax Overview.

Methoden

CreateStyleRule(Style, IUrlResolutionService, String) CreateStyleRule(Style, IUrlResolutionService, String) CreateStyleRule(Style, IUrlResolutionService, String) CreateStyleRule(Style, IUrlResolutionService, String)

Bei Implementierung durch eine Klasse wird für den angegebenen Dokumentsprachelementtyp bzw. die entsprechende Auswahl eine Formatierungsregel erstellt.When implemented by a class, creates a style rule for the specified document language element type, or selector.

RegisterStyle(Style, IUrlResolutionService) RegisterStyle(Style, IUrlResolutionService) RegisterStyle(Style, IUrlResolutionService) RegisterStyle(Style, IUrlResolutionService)

Bei Implementierung durch eine Klasse wird dem eingebetteten Stylesheet im <head>-Abschnitt einer Webseite eine neue Formatierungsregel hinzugefügt.When implemented by a class, adds a new style rule to the embedded style sheet in the <head> section of a Web page.

Gilt für:

Siehe auch