EditorPart.ApplyChanges Metode
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.
Menyimpan nilai dalam EditorPart kontrol ke properti terkait dalam kontrol terkait WebPart .
public:
abstract bool ApplyChanges();
public abstract bool ApplyChanges ();
abstract member ApplyChanges : unit -> bool
Public MustOverride Function ApplyChanges () As Boolean
Mengembalikan
true
jika tindakan menyimpan nilai dari EditorPart kontrol ke WebPart kontrol berhasil; jika tidak (jika terjadi kesalahan), false
.
Contoh
Contoh kode berikut menunjukkan cara menerapkan ApplyChanges metode dalam kontrol kustom EditorPart . Untuk kode lengkap yang diperlukan untuk menjalankan contoh, lihat bagian Contoh dari EditorPart gambaran umum kelas.
Bagian pertama dari contoh kode menunjukkan implementasi ApplyChanges metode di kelas kustom EditorPart bernama TextDisplayEditorPart
. Metode ini mendapatkan referensi ke kontrol terkait TextDisplayWebPart
menggunakan WebPartToEdit properti . Kemudian memperbarui nilai TextDisplayWebPart.FontStyle
properti .
public override bool ApplyChanges()
{
TextDisplayWebPart part =
(TextDisplayWebPart)WebPartToEdit;
// Update the custom WebPart control with the font style.
part.FontStyle = PartContentFontStyle.SelectedValue;
return true;
}
Public Overrides Function ApplyChanges() As Boolean
Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
TextDisplayWebPart)
' Update the custom WebPart control with the font style.
part.FontStyle = PartContentFontStyle.SelectedValue
Return True
End Function
Bagian kedua dari contoh kode menunjukkan bagaimana kontrol terkait WebPart , TextDisplayWebPart
, membuat kumpulan kontrol terkait EditorPart (dalam hal ini, hanya ada satu EditorPart kontrol yang dinamai TextDisplayEditorPart
dalam koleksi) dalam implementasi CreateEditorParts metode . Metode ini dijalankan ketika TextDisplayWebPart
kontrol memasuki mode edit.
public override EditorPartCollection CreateEditorParts()
{
ArrayList editorArray = new ArrayList();
TextDisplayEditorPart edPart = new TextDisplayEditorPart();
edPart.ID = this.ID + "_editorPart1";
editorArray.Add(edPart);
EditorPartCollection editorParts =
new EditorPartCollection(editorArray);
return editorParts;
}
public override object WebBrowsableObject
{
get { return this; }
}
Public Overrides Function CreateEditorParts() _
As EditorPartCollection
Dim editorArray As New ArrayList()
Dim edPart as New TextDisplayEditorPart()
edPart.ID = Me.ID & "_editorPart1"
editorArray.Add(edPart)
Dim editorParts As New EditorPartCollection(editorArray)
Return editorParts
End Function
Public Overrides ReadOnly Property WebBrowsableObject() _
As Object
Get
Return Me
End Get
End Property
Keterangan
Metode ApplyChanges ini adalah metode penting pada EditorPart kontrol. Ini didefinisikan sebagai metode abstrak di EditorPart kelas , dan harus diimplementasikan oleh kontrol yang diwariskan. Tujuan metode ini adalah untuk menyimpan nilai yang telah dimasukkan pengguna ke EditorPart kontrol ke properti yang sesuai dalam WebPart kontrol yang direferensikan dalam WebPartToEdit properti .
Metode ApplyChanges ini dipanggil ketika pengguna mengklik tombol yang mewakili OK atau kata kerja terapkan di antarmuka pengguna pengeditan (UI).
Catatan Bagi Implementer
Kelas yang berasal dari EditorPart kelas harus menerapkan ApplyChanges() metode . Metode yang diimplementasikan mendapatkan referensi ke kontrol terkait menggunakan WebPartToEdit properti , lalu memperbarui properti kontrol tersebut dengan nilai saat ini dalam EditorPart kontrol.