WebPartManager.IPersonalizable.IsDirty Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan nilai yang menunjukkan apakah data status personalisasi kustom yang dikelola oleh WebPartManager kontrol telah berubah pada halaman Web.
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.IsDirtyNilai Properti
Nilai Boolean yang menunjukkan apakah data status personalisasi telah berubah.
Penerapan
Contoh
Contoh kode berikut menunjukkan penggunaan IPersonalizable.IsDirty properti sederhana, untuk menunjukkan beberapa instans personalisasi halaman umum yang menyebabkan WebPartManager data personalisasi kontrol berubah.
Contoh kode memiliki empat bagian:
Kontrol pengguna yang memungkinkan Anda mengubah mode tampilan pada halaman yang berisi kontrol Komponen Web.
File sumber yang berisi kode untuk dua kontrol kustom WebPart yang dapat dihubungkan, dan antarmuka.
Halaman Web yang menghosting semua kontrol.
Penjelasan tentang cara kerja contoh kode.
Bagian pertama dari contoh kode adalah kontrol pengguna untuk mengubah mode tampilan. Anda dapat memperoleh kode sumber untuk kontrol pengguna dari bagian Contoh dari WebPartManager gambaran umum kelas. Untuk informasi tentang mode tampilan dan cara kerja kontrol pengguna, lihat Panduan: Mengubah Mode Tampilan pada Halaman Bagian Web.
Bagian kedua dari contoh adalah file sumber dengan kontrol kustom dan antarmuka. Perhatikan bahwa IZipCode antarmuka mengekspos satu metode, dan bahwa metode ini seperti yang diterapkan dalam kontrol kustom ZipCodeWebPart berfungsi sebagai metode panggilan balik untuk memungkinkan ZipCodeWebPart bertindak sebagai penyedia dalam skenario koneksi. Kontrol lainnya, WeatherWebPart, bertindak sebagai kontrol konsumen dalam koneksi; dapat menggunakan antarmuka tertentu yang disediakan oleh ZipCodeWebPart. Dalam aplikasi nyata, WeatherWebPart dapat menggunakan nilai Kode Pos yang dipersonalisasi dari penyedia, dan kemudian memberikan informasi cuaca grafis kepada pengguna.
Agar contoh kode berjalan, Anda harus mengkompilasi kode sumber ini. Anda dapat mengkompilasinya secara eksplisit dan meletakkan rakitan yang dihasilkan di folder Bin situs Web Anda atau cache perakitan global. Atau, Anda dapat meletakkan kode sumber di folder App_Code situs Anda, di mana kode tersebut akan dikompilasi secara dinamis pada durasi. Contoh kode ini menggunakan kompilasi dinamis; oleh karena itu, perhatikan bahwa direktif Register untuk komponen ini di bagian atas halaman Web hanya TagPrefix berisi atribut dan Namespace , tanpa Assembly atribut . Untuk panduan yang menunjukkan cara mengkompilasi, lihat Panduan: Mengembangkan dan Menggunakan Kontrol Server Web Kustom.
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
Bagian ketiga dari contoh kode adalah halaman Web. Perhatikan bahwa ia berisi dua WebPartZone zona, dengan yang pertama berisi dua kontrol kustom WebPart . Ada juga CatalogZone zona, yang berisi kontrol standar Calendar yang dapat ditambahkan pengguna ke halaman. Elemen ini <asp:connectionszone> menyediakan antarmuka pengguna koneksi bagi pengguna untuk membuat koneksi antar kontrol. Dalam metode , Page_PreRender perhatikan bahwa ia memeriksa untuk melihat apakah data personalisasi telah berubah dan, jika demikian, memperbarui teks Label1.
<%@ 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>
Setelah Anda memuat halaman di browser, coba buat beberapa skenario yang tercantum di bagian Keterangan dari topik ini yang akan mengubah data personalisasi. Saat Anda membuat berbagai perubahan, ketika perubahan melibatkan salah satu skenario personalisasi yang dilacak oleh WebPartManager kontrol, teks Label1 kontrol ditampilkan untuk menunjukkan bahwa data personalisasi telah berubah. Sebagai contoh, Anda dapat:
Buat koneksi antar kontrol dengan mengklik tombol Sambungkan Kontrol WebPart .
Gunakan kontrol daftar drop-down Mode Tampilan untuk mengalihkan halaman ke mode katalog, dan tambahkan kontrol Kalender Saya ke zona kedua WebPartZone .
Ubah kembali halaman untuk menelusuri mode, klik menu kata kerja (diperlihatkan dengan simbol panah di bilah judul) untuk kontrol Kalender Saya , dan pilih Tutup untuk menutupnya dan menambahkannya ke katalog halaman.
Kembalikan halaman ke mode katalog, dan tambahkan kontrol Kalender Saya kembali ke halaman.
Gunakan kontrol Mode Tampilan untuk mengalihkan halaman ke mode desain, dan mengatur ulang tata letak kontrol dengan menyeret satu atau beberapa kontrol ke zona lain, atau ke posisi yang berbeda di zona yang sama.
Keterangan
Properti IPersonalizable.IsDirty menyediakan cara bagi penelepon untuk menentukan apakah data status personalisasi yang dikelola oleh WebPartManager kontrol telah berubah. Saat pengguna mempersonalisasi detail tingkat halaman, misalnya dengan mengubah tata letak halaman, membuat atau menghapus koneksi, dan menambahkan atau menghapus kontrol, data personalisasi yang WebPartManager dikelola oleh kontrol berubah. Ini adalah metode pass-through yang kembali ke penelepon nilai properti yang dilindungi IsCustomPersonalizationStateDirty , yang tidak dapat diakses langsung oleh penelepon.
Catatan
Properti IPersonalizable.IsDirty tidak menunjukkan apakah nilai properti yang dapat dipersonalisasi, atau properti individual yang memengaruhi tampilan kontrol individual WebPart , telah berubah. Personalisasi tingkat kontrol dilacak untuk setiap kontrol satu per satu. Properti IPersonalizable.IsDirty hanya menunjukkan apakah data personalisasi yang berada di tingkat halaman dan dikelola oleh WebPartManager kontrol telah berubah.
Daftar berikut ini menjelaskan beberapa contoh umum personalisasi yang akan menyebabkan IPersonalizable.IsDirty properti mengembalikan nilai true, yang menunjukkan bahwa kontrol memiliki beberapa data personalisasi yang WebPartManager berubah:
Menutup kontrol statis WebPart (atau kontrol server atau pengguna) pada halaman.
Memulihkan kontrol statis WebPart tertutup dari katalog halaman kembali ke halaman.
Memindahkan kontrol apa pun dalam zonanya atau ke zona lain.
Menambahkan kontrol dari katalog WebPart atau kontrol server, atau menambahkan kontrol secara terprogram.
Membuat koneksi antara dua WebPart kontrol, baik secara terprogram atau dengan menggunakan antarmuka pengguna koneksi (UI).
Menghapus koneksi antara dua WebPart kontrol, baik secara terprogram atau dengan menggunakan antarmuka pengguna koneksi.
Untuk mengakses nilai properti ini, Anda harus mentransmisikan WebPartManager instans kontrol ke IPersonalizable antarmuka; Anda kemudian dapat membaca IsDirty nilai properti.
Berlaku untuk
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk