WebPartManager.IPersonalizable.IsDirty Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetim tarafından yönetilen özel kişiselleştirme durumu verilerinin WebPartManager bir Web sayfasında değişip değişmediğini gösteren bir değer alır.

property bool System::Web::UI::WebControls::WebParts::IPersonalizable::IsDirty { bool get(); };

bool System.Web.UI.WebControls.WebParts.IPersonalizable.IsDirty { get; }

member this.System.Web.UI.WebControls.WebParts.IPersonalizable.IsDirty : bool

 ReadOnly Property IsDirty As Boolean Implements IPersonalizable.IsDirty

Özellik Değeri

Boolean

Kişiselleştirme durumu verilerinin değişip değişmediğini gösteren boole değeri.

Uygulamalar

IsDirty

Örnekler

Aşağıdaki kod örneği, denetimin IPersonalizable.IsDirty kişiselleştirme verilerinin değişmesine neden olan bazı ortak sayfa kişiselleştirme örneklerini göstermek için özelliğin basit bir WebPartManager kullanımını gösterir.

Kod örneğinin dört bölümü vardır:

Web Bölümleri denetimleri içeren bir sayfada görüntüleme modlarını değiştirmenize olanak tanıyan bir kullanıcı denetimi.
Bağlanabilen iki özel WebPart denetimin kodunu içeren bir kaynak dosyası ve bir arabirim.
Tüm denetimleri barındıran bir Web sayfası.
Kod örneğinin nasıl çalıştığını gösteren bir açıklama.

Kod örneğinin ilk bölümü, görüntüleme modlarını değiştirmeye yönelik kullanıcı denetimidir. Kullanıcı denetimi için kaynak kodunu sınıfa genel bakışın Örnek bölümünden WebPartManager alabilirsiniz. Görüntüleme modları ve kullanıcı denetiminin nasıl çalıştığı hakkında bilgi için bkz. İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.

Örneğin ikinci bölümü, özel denetimlere ve arabirime sahip kaynak dosyadır. Arabirimin IZipCode bir yöntemi kullanıma sağladığına ve özel ZipCodeWebPart denetimde uygulanan bu yöntemin bir bağlantı senaryosunda sağlayıcı olarak davranmayı etkinleştirmek ZipCodeWebPart için bir geri çağırma yöntemi olarak hizmet ettiğini unutmayın. Diğer denetim olan WeatherWebPart, bir bağlantıda tüketici denetimi görevi görür; tarafından ZipCodeWebPartsağlanan belirli arabirimi kullanabilir. Gerçek bir uygulamada sağlayıcıdan WeatherWebPart kişiselleştirilmiş bir Posta Kodu değeri kullanabilir ve ardından kullanıcılara grafik hava durumu bilgileri sağlayabilir.

Kod örneğinin çalışması için bu kaynak kodu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin çalışma zamanında dinamik olarak derlenecek App_Code klasörüne yerleştirebilirsiniz. Bu kod örneği dinamik derleme kullanır; Bu nedenle, Web sayfasının en üstündeki bu bileşen için yönergesinin yalnızca ve Namespace öznitelikleri içerdiğine ve öznitelikleri Assembly içerdiğine TagPrefix dikkat edinRegister. Derlemeyi gösteren bir kılavuz için bkz. İzlenecek yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code", "ZipCodeProvider")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code", "ZipCodeConsumer")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }
  }
}

Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code", "ZipCodeProvider")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code", "ZipCodeConsumer")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
                DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

Kod örneğinin üçüncü bölümü Web sayfasıdır. İlki iki özel WebPart denetimi içeren iki WebPartZone bölge içerdiğine dikkat edin. Ayrıca, kullanıcıların sayfaya ekleyebilecekleri standart Calendar bir denetim içeren bir bölge de CatalogZone vardır. <asp:connectionszone> öğesi, kullanıcıların denetimler arasında bağlantı oluşturması için bir bağlantı kullanıcı arabirimi sağlar. yönteminde Page_PreRender , kişiselleştirme verilerinin değişip değişmediğini denetlediğine ve değiştiyse metnini Label1güncelleştirdiğine dikkat edin.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuCS"
    Src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_PreRender(object sender, EventArgs e)
  {
    // Clear the label if it has a previously set value.
    Label1.Text = String.Empty;
    
    // Cast the WebPartManager to the IPersonalizable interface 
    // so that you can access the property.  
    IPersonalizable stateData = (IPersonalizable)mgr1;
    if (stateData.IsDirty)
      Label1.Text = "WebPartManager personalization data is dirty.";
  }
    
  protected void Button1_Click(object sender, EventArgs e)
  {
    ProviderConnectionPoint provPoint = 
      mgr1.GetProviderConnectionPoints(zip1)["ZipCodeProvider"];
    ConsumerConnectionPoint connPoint = 
      mgr1.GetConsumerConnectionPoints(weather1)["ZipCodeConsumer"];
    WebPartConnection conn1 = mgr1.ConnectWebParts(zip1, provPoint,
      weather1, connPoint);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <uc1:DisplayModeMenuCS ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" />
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart>
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" />
      <hr />
      <asp:Label ID="Label1" runat="server" 
        Text="" 
        Font-Bold="true" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuVB"
    Src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_PreRender(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    ' Clear the label if it has a previously set value.
    Label1.Text = String.Empty
    
    ' Cast the WebPartManager to the IPersonalizable interface 
    ' so that you can access the property.
    Dim stateData As IPersonalizable = CType(mgr1, IPersonalizable)
    If stateData.IsDirty Then
      Label1.Text = "WebPartManager personalization data is dirty."
    End If
    
  End Sub
    
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)

    Dim provPoint As ProviderConnectionPoint = _
      mgr1.GetProviderConnectionPoints(zip1)("ZipCodeProvider")
    Dim connPoint As ConsumerConnectionPoint = _
      mgr1.GetConsumerConnectionPoints(weather1)("ZipCodeConsumer")
    Dim conn1 As WebPartConnection = _
      mgr1.ConnectWebParts(zip1, provPoint, weather1, connPoint)
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <uc1:DisplayModeMenuVB ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" />
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart>
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" />
      <hr />
      <asp:Label ID="Label1" runat="server" 
        Text="" 
        Font-Bold="true" />
    </div>
    </form>
</body>
</html>

Sayfayı bir tarayıcıya yükledikten sonra, bu konunun Açıklamalar bölümünde listelenen ve kişiselleştirme verilerini değiştirecek senaryolardan bazılarını oluşturmayı deneyin. Çeşitli değişiklikler yaptığınızda, bir değişiklik denetim tarafından izlenen kişiselleştirme senaryolarından birini içerdiğinde WebPartManager , kişiselleştirme verilerinin Label1 değiştiğini belirtmek için denetimin metni görüntülenir. Örneğin, şunları yapabilirsiniz:

Web Bölümü Denetimlerini Bağla düğmesine tıklayarak denetimler arasında bağlantı oluşturun.
Sayfayı katalog moduna geçirip Takvimim denetimini ikinci WebPartZone bölgeye eklemek için Görüntü Modu açılan liste denetimini kullanın.
Sayfayı göz atma moduna geri döndürerek Takvimim denetiminin fiiller menüsüne (başlık çubuğunda ok simgesiyle gösterilir) tıklayın ve kapatmak ve sayfa kataloğuna eklemek için Kapat'ı seçin.
Sayfayı katalog moduna döndürerek Takvimim denetimini sayfaya geri ekleyin.
Görüntüleme Modu denetimini kullanarak sayfayı tasarım moduna geçirin ve bir veya daha fazlasını başka bir bölgeye veya aynı bölgede farklı bir konuma sürükleyerek denetimlerin düzenini yeniden düzenleyin.

Açıklamalar

özelliği, IPersonalizable.IsDirty arayanların denetim tarafından yönetilen kişiselleştirme durumu verilerinin değişip değişmediğini saptaması WebPartManager için bir yol sağlar. Kullanıcılar sayfa düzenini değiştirerek, bağlantıları oluşturarak veya silerek ve denetimleri ekleyerek veya silerek sayfa düzeyi ayrıntılarını kişiselleştirdiğinde, denetim tarafından WebPartManager yönetilen kişiselleştirme verileri değişir. Bu, çağıranlara çağıranlar tarafından doğrudan erişilemeyen korumalı IsCustomPersonalizationStateDirty özelliğin değerini döndüren bir geçiş yöntemidir.

Not

özelliği, IPersonalizable.IsDirty kişiselleştirilebilir özellik değerlerinin veya tek tek denetimlerin görünümünü etkileyen tek tek WebPart özelliklerin değişip değişmediğini belirtmez. Denetim düzeyi kişiselleştirme, her denetim için ayrı ayrı izlenir. IPersonalizable.IsDirty özelliği yalnızca sayfa düzeyinde olan ve denetim tarafından yönetilen kişiselleştirme verilerinin WebPartManager değişip değişmediğini gösterir.

Aşağıdaki listede, özelliğinin değerini truedöndürmesine neden olan ve denetimin IPersonalizable.IsDirty bazı kişiselleştirme verilerini değiştirdiğini WebPartManager belirten bazı yaygın kişiselleştirme örnekleri açıklanmaktadır:

Sayfadaki statik WebPart denetimi (veya sunucu veya kullanıcı denetimini) kapatma.
Kapalı statik WebPart denetimi sayfa kataloğundan sayfaya geri yükleme.
Herhangi bir denetimi kendi bölgesi içinde veya başka bir bölgeye taşıma.
Veya sunucu denetimleri kataloğundan WebPart denetim ekleme veya program aracılığıyla denetim ekleme.
Program aracılığıyla veya bağlantı kullanıcı arabirimini (UI) kullanarak iki WebPart denetim arasında bağlantı oluşturma.
Program aracılığıyla veya bağlantı kullanıcı arabirimini kullanarak iki WebPart denetim arasındaki bağlantıyı silme.

Bu özellik değerine erişmek için denetim örneğini WebPartManager arabirime IPersonalizable atamanız gerekir; daha sonra özellik değerini okuyabilirsiniz IsDirty .

Şunlara uygulanır

Aracılığıyla paylaş