Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

PartialCachingAttribute-Klasse

Definiert die Metadatenattribute, die Web Forms-Benutzersteuerelemente (ASCX-Dateien) verwenden, um anzugeben, ob und wie ihre Ausgabe zwischengespeichert wird. Die Klasse erlaubt keine Vererbung.

System.Object
  System.Attribute
    System.Web.UI.PartialCachingAttribute

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

[AttributeUsageAttribute(AttributeTargets.Class)]
public sealed class PartialCachingAttribute : Attribute

Der PartialCachingAttribute-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodePartialCachingAttribute(Int32)Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse mit der angegebenen Dauer, die dem Benutzersteuerelement zugewiesen ist, das zwischengespeichert werden soll.
Öffentliche MethodePartialCachingAttribute(Int32, String, String, String)Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches angibt.
Öffentliche MethodePartialCachingAttribute(Int32, String, String, String, Boolean)Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen und benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches sowie die Möglichkeit der gemeinsamen Verwendung der Ausgabe von Benutzersteuerelementen durch mehrere Seiten angibt.
Öffentliche MethodePartialCachingAttribute(Int32, String, String, String, String, Boolean)Initialisiert eine neue Instanz der PartialCachingAttribute-Klasse, die die Dauer der Zwischenspeicherung, ggf. GET- und POST-Werte, Steuerelementnamen, benutzerdefinierte Anforderungen zum Ändern des Ausgabecaches und Datenbankabhängigkeiten sowie die Möglichkeit der gemeinsamen Verwendung der Ausgabe von Benutzersteuerelementen durch mehrere Seiten angibt.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftDurationRuft die Zeitspanne in Sekunden ab, über die zwischengespeicherte Elemente im Ausgabecache verbleiben.
Öffentliche EigenschaftProviderNameRuft den Namen des Anbieters ab, mit dem die im Ausgabecache zwischengespeicherten Daten für das zugeordnete Steuerelement gespeichert werden, oder legt diesen fest.
Öffentliche EigenschaftSharedRuft einen Wert ab, der angibt, ob die Ausgabe von Benutzersteuerelementen von mehreren Seiten gemeinsam verwendet werden kann.
Öffentliche EigenschaftSqlDependencyRuft eine durch Trennzeichen getrennte Zeichenfolge ab, die ein oder mehrere Paare aus Datenbank- und Tabellennamen angibt, von denen das zwischengespeicherte Benutzersteuerelement abhängig ist.
Öffentliche EigenschaftTypeId Bei Implementierung in einer abgeleiteten Klasse wird ein eindeutiger Bezeichner für dieses Attribute abgerufen. (Von Attribute geerbt.)
Öffentliche EigenschaftVaryByControlsRuft eine Liste von Benutzersteuerelementeigenschaften ab, die vom Ausgabecache zum Variieren des Benutzersteuerelements verwendet werden.
Öffentliche EigenschaftVaryByCustomRuft eine Liste der benutzerdefinierten Zeichenfolgen ab, die vom Ausgabecache zum Variieren des Benutzersteuerelements verwendet werden.
Öffentliche EigenschaftVaryByParamsRuft eine Liste von Abfragezeichenfolgen oder Formular-POST-Parametern ab, die vom Ausgabecache zum Variieren des Benutzersteuerelements verwendet werden.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEqualsInfrastruktur. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Von Attribute geerbt.)
Öffentliche MethodeGetHashCodeGibt den Hashcode für diese Instanz zurück. (Von Attribute geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIsDefaultAttributeBeim Überschreiben in einer abgeleiteten Klasse wird angegeben, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Von Attribute geerbt.)
Öffentliche MethodeMatchBeim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Von Attribute geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetIDsOfNamesOrdnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoRuft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.GetTypeInfoCountRuft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Von Attribute geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode_Attribute.InvokeStellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Von Attribute geerbt.)
Zum Seitenanfang

Die PartialCachingAttribute-Attributklasse kennzeichnet Benutzersteuerelemente (ASCX-Dateien), die das Zwischenspeichern von Fragmenten unterstützen, und kapselt die Cacheeinstellungen, die von ASP.NET beim Zwischenspeichern des Steuerelements verwendet werden. Mit dem PartialCachingAttribute-Attribut können Seiten- und Steuerelemententwickler Ausgabecaches für ein Benutzersteuerelement in einer CodeBehind-Datei aktivieren.

Das PartialCachingAttribute stellt nur eine von mehreren Möglichkeit dar, um Ausgabecaches zu aktivieren. Die folgende Liste beschreibt Methoden, mit denen Sie Ausgabecaches aktivieren können.

  • Verwenden Sie die @ OutputCache-Direktive, um Ausgabecaches in Deklarationen zu aktivieren.

  • Mit PartialCachingAttribute können Sie Caches für ein Benutzersteuerelement in einer CodeBehind-Datei aktivieren.

  • Geben Sie mit der ControlCachePolicy-Klasse die Cacheeinstellungen programmgesteuert in programmgesteuerten Szenarien an, bei denen Sie BasePartialCachingControl-Instanzen verwenden.

Wenn ein Benutzersteuerelement eine @ OutputCache-Direktive enthält oder das PartialCachingAttribute-Attribut auf dieses angewendet wurde, generiert der ASP.NET-Parser eine Instanz der PartialCachingControl-Klasse, um das Benutzersteuerelement zu umschließen.

Weitere Informationen über ASP.NET-Caches finden Sie unter ASP.NET Caching Features. Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Im folgenden Codebeispiel wird die Verwendung des PartialCachingAttribute veranschaulicht. Dieses Beispiel besteht aus drei Teilen:

  • Einer partiellen Klasse ctlMine, die von der UserControl-Basisklasse abgeleitet wird und auf die das PartialCachingAttribute-Attribut angewendet wird.

  • Einem Benutzersteuerelement, das mit der partiellen ctlMine-Klasse verwendet wird.

  • Einer Web Forms-Seite, die als Host für das Benutzersteuerelement verwendet wird.

Im ersten Teil des Beispiels wird eine partielle Klasse veranschaulicht, die von der UserControl-Basisklasse geerbt ist und auf die das PartialCachingAttribute-Attribut angewendet wird. In diesem Beispiel gibt das Attribut an, dass das Benutzersteuerelement für 20 Sekunden zwischengespeichert werden soll.


// [filename partialcache.cs]
// Create a code-behind user control that is cached
// for 20 seconds using the PartialCachingAttribute class.
// This control uses a DataGrid server control to display
// XML data.
using System;
using System.IO;
using System.Data;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{

    // Set the PartialCachingAttribute.Duration property to 20 seconds.
    [PartialCaching(20)]
    public partial class ctlMine : UserControl
    {

        protected void Page_Load(Object Src, EventArgs E)
        {
            DataSet ds = new DataSet();

            FileStream fs = new FileStream(Server.MapPath("schemadata.xml"), FileMode.Open, FileAccess.Read);
            StreamReader reader = new StreamReader(fs);
            ds.ReadXml(reader);
            fs.Close();

            DataView Source = new DataView(ds.Tables[0]);
            // Use the LiteralControl constructor to create a new
            // instance of the class.
            LiteralControl myLiteral = new LiteralControl();
            // Set the LiteralControl.Text property to an HTML
            // string and the TableName value of a data source.
            myLiteral.Text = "<h6><font face=verdana>Caching an XML Table: " + Source.Table.TableName + " </font></h6>";
            MyDataGrid.DataSource = Source;
            MyDataGrid.DataBind();

            TimeMsg.Text = DateTime.Now.ToString("G");

        }
    }
}


Der zweite Teil des Beispiels zeigt ein Benutzersteuerelement, das zusammen mit dem vorherigen Beispiel verwendet wird, um die Zwischenspeicherung bei Benutzersteuerelementen zu veranschaulichen.


<!-- The mark-up .ascx file that displays the output of
     the partialcache.cs user control code-behind file. -->
<%@ Control language="C#" inherits="Samples.AspNet.CS.Controls.ctlMine" CodeFile="partialcache.cs.ascx.cs" %>

  <ASP:DataGrid id="MyDataGrid" runat="server"
    Width="900"
    BackColor="#ccccff"
    BorderColor="black"
    ShowFooter="false"
    CellPadding="3"
    CellSpacing="0"
    Font-Names="Verdana"
    Font-Size="8pt"
    HeaderStyle-BackColor="#aaaadd"
    EnableViewState="false"
  />

  <br />

  <i>Control last generated on:</i> <asp:label id="TimeMsg" runat="server" />


Im dritten Teil des Beispiels wird eine Web Forms-Seite veranschaulicht, die als Host für das Benutzersteuerelement verwendet wird.


<!-- The WebForms page that contains the user control generated
     by partialcache.cs. -->
<%@ Register TagPrefix="Acme" TagName="Cache" Src="partialcache.cs.ascx" %>

<!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" >
<script language="C#" runat="server">

      void Page_Load(Object Src, EventArgs E ) {

          TimeMsg.Text = DateTime.Now.ToString("G");
      }

  </script>

<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>

  <form id="form1" runat="server">
    <Acme:Cache runat="server"/>
    <br />

    <i>Page last generated on:</i> <asp:label id="TimeMsg" runat="server" />

  </form>
</body>
</html>


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft