ITrackingPersonalizable Schnittstelle

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ermöglicht es, dass Webparts-Steuerelemente die spezifischen Phasen des Lade- und Speichervorgangs bei Personalisierungen nachverfolgen.

C#

public interface ITrackingPersonalizable

Abgeleitet

System.Web.UI.WebControls.WebParts.ErrorWebPart

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung von ITrackingPersonalizable Methoden und Eigenschaften zum Nachverfolgen des Ladens und Speicherns von Personalisierungsinformationen. Das Beispiel besteht aus zwei Teilen, einer .aspx Seite und einer Datei, die in einem App_Code Unterverzeichnis platziert werden soll.

Im folgenden Codebeispiel wird ein Webparts-Steuerelement erstellt, das es einem Benutzer ermöglicht, URL-Informationen einzugeben und diese Informationen für den Benutzer zu speichern.

C#

namespace PersTest
{

    using System;
    using System.Collections;
    using System.ComponentModel;
    using System.Diagnostics;
    using System.Drawing;
    using System.Web.UI;
    using System.Web.UI.WebControls;
    using System.Web.UI.WebControls.WebParts;

    public class UrlListWebPart : WebPart, IPersonalizable
    {

        private ArrayList _sharedUrls;
        private ArrayList _userUrls;
        private bool _listDirty;

        private TextBox _nameTextBox;
        private TextBox _urlTextBox;
        private Button _addButton;
        private BulletedList _list;

        public override string Subtitle
        {
            get
            {
                return Text;
            }
        }

        [Personalizable, WebBrowsable]
        public virtual string Text
        {
            get
            {
                object o = ViewState["Text"];
                return (o != null) ? (String)o : "My Links";
            }
            set
            {
                ViewState["Text"] = value;
            }
        }

        protected override void CreateChildControls()
        {
            Label nameLabel = new Label();
            Label urlLabel = new Label();
            LiteralControl breakLiteral1 = new LiteralControl("<br />");
            LiteralControl breakLiteral2 = new LiteralControl("<br />");
            LiteralControl breakLiteral3 = new LiteralControl("<br />");

            _nameTextBox = new TextBox();
            _urlTextBox = new TextBox();
            _addButton = new Button();
            _list = new BulletedList();

            nameLabel.Text = "Name: ";
            urlLabel.Text = "URL: ";
            _nameTextBox.ID = "nameTextBox";
            _urlTextBox.ID = "urlTextBox";
            _addButton.Text = "Add";
            _addButton.ID = "addButton";
            _addButton.Click += new EventHandler(this.OnClickAddButton);
            _list.DisplayMode = BulletedListDisplayMode.HyperLink;
            _list.ID = "list";

            Controls.Add(nameLabel);
            Controls.Add(_nameTextBox);
            Controls.Add(breakLiteral1);

            Controls.Add(urlLabel);
            Controls.Add(_urlTextBox);
            Controls.Add(breakLiteral2);

            Controls.Add(_addButton);
            Controls.Add(breakLiteral3);

            Controls.Add(_list);
        }

        private void OnClickAddButton(object sender, EventArgs e)
        {
            string name = _nameTextBox.Text.Trim();
            string url = _urlTextBox.Text.Trim();

            Pair p = new Pair(name, url);
            if (WebPartManager.Personalization.Scope == PersonalizationScope.Shared)
            {
                _sharedUrls ??= new ArrayList();
                _sharedUrls.Add(p);
            }
            else
            {
                _userUrls ??= new ArrayList();
                _userUrls.Add(p);
            }

            OnUrlAdded();
        }

        protected virtual void OnUrlAdded()
        {
            _listDirty = true;
            ChildControlsCreated = false;
        }

        protected override void RenderContents(HtmlTextWriter writer)
        {
            if (_sharedUrls != null)
            {
                foreach (Pair p in _sharedUrls)
                {
                    _list.Items.Add(new ListItem((string)p.First, (string)p.Second));
                }
            }
            if (_userUrls != null)
            {
                foreach (Pair p in _userUrls)
                {
                    _list.Items.Add(new ListItem((string)p.First, (string)p.Second));
                }
            }

            base.RenderContents(writer);
        }

        public virtual bool IsDirty
        {
            get
            {
                return _listDirty;
            }
        }
        public new virtual void Load(PersonalizationDictionary state)
        {
            if (state != null)
            {
                PersonalizationEntry sharedUrlsEntry = state["sharedUrls"];
                if (sharedUrlsEntry != null)
                {
                    _sharedUrls = (ArrayList)sharedUrlsEntry.Value;
                }

                PersonalizationEntry userUrlsEntry = state["userUrls"];
                if (userUrlsEntry != null)
                {
                    _userUrls = (ArrayList)userUrlsEntry.Value;
                }
            }
        }

        public virtual void Save(PersonalizationDictionary state)
        {
            if ((_sharedUrls != null) && (_sharedUrls.Count != 0))
            {
                state["sharedUrls"] = new PersonalizationEntry(_sharedUrls, PersonalizationScope.Shared);
            }
            if ((_userUrls != null) && (_userUrls.Count != 0))
            {
                state["userUrls"] = new PersonalizationEntry(_userUrls, PersonalizationScope.User);
            }
        }
    }

    public class UrlListExWebPart : UrlListWebPart, ITrackingPersonalizable
    {

        private string _trackingLog = String.Empty;
        private bool _loading;
        private bool _saving;

        public override string Text
        {
            get
            {
                return base.Text;
            }
            set
            {
                if (!base.Text.Equals(value))
                {
                    base.Text = value;
                    SetPersonalizationDirty();
                }
            }
        }
        protected override void OnUrlAdded()
        {
            base.OnUrlAdded();
            SetPersonalizationDirty();
        }
        protected override void RenderContents(HtmlTextWriter writer)
        {
            base.RenderContents(writer);

            writer.Write("<br />");
            writer.Write("<pre id=\"" + ClientID + "$log" + "\">");
            writer.Write(_trackingLog);
            writer.Write("</pre>");
        }

        public override void Load(PersonalizationDictionary state)
        {
            if (!_loading)
            {
                throw new InvalidOperationException();
            }
        }

        public override void Save(PersonalizationDictionary state)
        {
            if (!_saving)
            {
                throw new InvalidOperationException();
            }
            base.Save(state);
        }
        bool ITrackingPersonalizable.TracksChanges
        {
            get
            {
                return true;
            }
        }
        void ITrackingPersonalizable.BeginLoad()
        {
            _loading = true;
            _trackingLog = "1. BeginLoad\r\n";
        }
        void ITrackingPersonalizable.BeginSave()
        {
            _saving = true;
            _trackingLog += "3. BeginSave\r\n";
        }
        void ITrackingPersonalizable.EndLoad()
        {
            _loading = false;
            _trackingLog += "2. EndLoad\r\n";
        }
        void ITrackingPersonalizable.EndSave()
        {
            _saving = false;
            _trackingLog += "4. EndSave";
        }
    }
}

Die folgende .aspx Seite erstellt eine Webpartzone und fügt das Steuerelement der Zone hinzu. Die Seite verweist auch auf ein Anmeldesteuerelement, das Sie zum Anmelden einzelner Benutzer verwenden sollten, damit die Personalisierung angewendet werden kann.

ASP.NET (C#)

<%@ Page Language="C#"  %>
<%@ Register TagPrefix="dict" namespace="PersTest" %>
<!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 runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server"></asp:WebPartManager>
     <asp:LoginName ID="LoginName1" runat="server" />
         
        <asp:LoginStatus ID="LoginStatus1" runat="server" LogoutAction="RedirectToLoginPage" />
            <br />
    <div>
    <asp:WebPartZone ID="WebPartZone1" runat="server">
                 <ZoneTemplate>
        <dict:UrlListWebPart id="PersDict" title="Personalization Dictionary" runat="server" />
       
        </ZoneTemplate>
        </asp:WebPartZone>
    </div>
    </form>
</body>
</html>

Hinweise

Mit dieser Schnittstelle können Steuerungsentwickler verschiedene Phasen des Personalisierungslebenszyklus nachverfolgen, einschließlich des Ladens und Speicherns von Personalisierungsdaten. In den meisten Fällen würden Sie für die Verwendung dieser Schnittstelle eine benutzerdefinierte WebPart oder WebPartManager erstellen und diese Schnittstelle implementieren. Darüber hinaus sollten Steuerelemente, die ihre eigene Änderungsnachverfolgung ("dirty") verwalten müssen, diese Schnittstelle implementieren. Steuerelemente, die ihre eigene Änderungsnachverfolgung verwalten, sollten von der TracksChanges -Eigenschaft zurückgegeben true werden.

Wenn false zurückgegeben wird, ist ASP.NET für die Bestimmung von Änderungen verantwortlich, indem die geladenen Eigenschafteninformationen mit den gespeicherten Eigenschafteninformationen verglichen werden.

Eigenschaften

TracksChanges

Gibt an, ob das Steuerelement den Status seiner Änderungen nachverfolgt.

Methoden

BeginLoad()	Stellt den Anfang der Ladephase für Personalisierungsinformationen dar.
BeginSave()	Stellt die Phase vor dem Extrahieren von Personalisierungsdaten aus einem Steuerelement dar.
EndLoad()	Stellt die Phase nach dem Anwenden der Personalisierungsdaten auf ein Steuerelement dar.
EndSave()	Stellt die Phase nach dem Extrahieren der Personalisierungsdaten aus einem Steuerelement dar.

Gilt für:

Weitere Informationen

• ASP.NET Webpart-Steuerelemente
• Übersicht über die Personalisierung von Webparts
• Exemplarische Vorgehensweise: Implementieren der Webpart-Personalisierung mit einem Benutzersteuerelement
• Personalisierung von Webparts