Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

PartialCachingAttribute-Klasse

 

Veröffentlicht: Oktober 2016

Definiert das Metadatenattribut, das Web Forms-Benutzersteuerelemente (ASCX-Dateien) verwenden, um anzugeben, ob und wie ihre Ausgabe zwischengespeichert wird. Diese Klasse kann nicht vererbt werden.

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

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

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

NameBeschreibung
System_CAPS_pubmethodPartialCachingAttribute(Int32)

Initialisiert eine neue Instanz der der PartialCachingAttribute Klasse mit der angegebenen Dauer zwischengespeichert werden, die das Benutzersteuerelement zugewiesen.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String)

Initialisiert eine neue Instanz der PartialCachingAttribute -Klasse unter Angabe der Dauer, alle GET und POST Werte, Namen von Steuerelementen und benutzerdefinierte Ausgabecaching verwendet, um den Cache zu variieren.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String, Boolean)

Initialisiert eine neue Instanz von der PartialCachingAttribute -Klasse und gibt dabei die Dauer, alle GET und POST Werte Steuerelementnamen, benutzerdefinierte Ausgabe cacheanforderungen verwendet, um den Cache zu variieren, und gibt an, ob die Ausgabe Benutzersteuerelements mit mehreren Seiten freigegeben werden kann.

System_CAPS_pubmethodPartialCachingAttribute(Int32, String, String, String, String, Boolean)

Initialisiert eine neue Instanz von der PartialCachingAttribute -Klasse und gibt dabei die Dauer, alle GET und POST Werte Steuerelementnamen, benutzerdefinierte Ausgabe cacheanforderungen verwendet, um den Cache, die Abhängigkeiten Datenbank variieren und ob das Steuerelement die Ausgabe mit mehreren Seiten freigegeben werden kann.

NameBeschreibung
System_CAPS_pubpropertyDuration

Ruft der Zeitspanne in Sekunden ab, die zwischengespeicherte Elemente im Ausgabecache sollten.

System_CAPS_pubpropertyProviderName

Ruft ab oder legt den Namen des Anbieters, der zum Speichern der zwischengespeicherten Daten für das zugeordnete Steuerelement verwendet wird.

System_CAPS_pubpropertyShared

Ruft einen Wert, der angibt, ob die Ausgabe eines Benutzersteuerelements für mehrere Seiten freigegeben werden kann.

System_CAPS_pubpropertySqlDependency

Ruft eine durch Trennzeichen getrennte Zeichenfolge, die eine oder mehrere Datenbank-Tabelle-Paaren angibt, denen das zwischengespeicherte Benutzersteuerelement abhängig ist.

System_CAPS_pubpropertyTypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

System_CAPS_pubpropertyVaryByControls

Ruft eine Liste der Benutzer-Steuerelementeigenschaften, die vom Ausgabecache zum variieren des Benutzersteuerelements verwendet.

System_CAPS_pubpropertyVaryByCustom

Ruft eine Liste der benutzerdefinierten Zeichenfolgen, die vom Ausgabecache zum variieren des Benutzersteuerelements verwendet wird.

System_CAPS_pubpropertyVaryByParams

Ruft eine Liste der Abfragezeichenfolge und Formularbereitstellungsparameter POST Parameter, die vom Ausgabecache zum variieren des Benutzersteuerelements verwendet wird.

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetHashCode()

Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodIsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodMatch(Object)

Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Die PartialCachingAttribute Attributklasse Benutzersteuerelemente (ASCX-Dateien), die Unterstützung für das Zwischenspeichern von Fragment gekennzeichnet und kapselt die cacheeinstellungen, die ASP.NET verwendet, wenn das Steuerelement das Zwischenspeichern. Entwickler von Seiten und Steuerelemente verwenden die PartialCachingAttribute -Attributs aktivieren Ausgabecaches für ein Benutzersteuerelement in einer CodeBehind-Datei.

Mithilfe der PartialCachingAttribute ist eine von mehreren Möglichkeiten, Sie können, das Zwischenspeichern der Ausgabedaten. Die folgende Liste beschreibt Methoden, mit denen Sie Ausgabecaches aktivieren können.

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

  • Verwenden der PartialCachingAttribute Zwischenspeichern für ein Benutzersteuerelement in einer CodeBehind-Datei.

  • Verwenden der ControlCachePolicy Klasse, um programmgesteuert Cache-Einstellungen in programmgesteuerten Szenarien angeben, in dem Sie arbeiten mit BasePartialCachingControl Instanzen.

Wenn ein Benutzersteuerelement eine Direktive enthält oder ein PartialCachingAttribute angewendet wird, generiert der Parser ASP.NET eine Instanz der PartialCachingControl Klasse, um das Benutzersteuerelement zu umschließen.

Weitere Informationen zum Zwischenspeichern von ASP.NET finden Sie unter ASP.NET Caching. Weitere Informationen zum Verwenden von Attributen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Das folgende Codebeispiel veranschaulicht die Verwendung der PartialCachingAttribute. In diesem Beispiel besteht aus drei Teilen:

  • Eine partielle Klasse, ctlMine, erbt von der UserControl Basisklasse und auf die das PartialCachingAttribute -Attribut angewendet wird.

  • Ein Benutzersteuerelement, das mit der ctlMine partielle Klasse.

  • Eine Web Forms-Seite, die das Benutzersteuerelement hostet.

Der erste Teil des Beispiels zeigt eine partielle Klasse, die von erbt die UserControl Basisklasse 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, mit dem vorherigen Beispiel mit dem Zwischenspeichern von Benutzersteuerelementen 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" />

Der dritte Teil des Beispiels zeigt eine Web Forms-Seite, die das Benutzersteuerelement hostet.

<!-- 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
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: