IWebEditable.CreateEditorParts 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.
Mengembalikan kumpulan kontrol kustom EditorPart yang terkait dengan kontrol server yang mengimplementasikan IWebEditable antarmuka.
public:
System::Web::UI::WebControls::WebParts::EditorPartCollection ^ CreateEditorParts();
public System.Web.UI.WebControls.WebParts.EditorPartCollection CreateEditorParts ();
abstract member CreateEditorParts : unit -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Function CreateEditorParts () As EditorPartCollection
Mengembalikan
Yang EditorPartCollection berisi kumpulan kontrol kustom EditorPart yang terkait dengan kontrol server.
Contoh
Contoh kode berikut menunjukkan penimpaan CreateEditorParts metode dalam kontrol kustom WebPart . Kode sumber lengkap yang diperlukan untuk menjalankan sampel ditemukan di bagian IWebEditable Contoh dari topik gambaran umum kelas.
Contoh kode berisi kedua anggota IWebEditable antarmuka. Perhatikan bahwa penimpaan CreateEditorParts metode membuat ArrayList untuk mengumpulkan satu atau beberapa kontrol kustom EditorPart , lalu menggunakan daftar untuk membuat EditorPartCollection objek.
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 ini CreateEditorParts memungkinkan Anda membuat kumpulan semua kontrol kustom EditorPart yang terkait dengan kontrol kustom, kontrol, WebPart atau kontrol pengguna Anda, dan mengembalikannya sebagai EditorPartCollection objek. Kontrol WebPartManager mengambil koleksi dan membuat instans semua EditorPart kontrol setiap kali kontrol server memasuki mode edit.
Biasanya Anda menerapkan metode ini dalam kontrol kustom WebPart dengan mengambil alih metodenya CreateEditorParts . Dalam metode , Anda membuat instans kontrol kustom EditorPart yang ingin Anda kaitkan dengan kontrol Anda, menambahkannya ke EditorPartCollection objek, lalu mengembalikan objek tersebut. Kumpulan EditorPart kontrol kemudian ditetapkan ke EditorParts properti EditorZoneBase zona.
Catatan
Setiap EditorPart yang ditambahkan ke pengumpulan EditorPart kontrol dalam implementasi CreateEditorParts metode harus memiliki nilai yang ditetapkan ke properti ID-nya, jika tidak, pengecualian akan dilemparkan ketika koleksi ditetapkan ke EditorParts properti .
Catatan Bagi Implementer
Objek EditorPartCollection yang dikembalikan CreateEditorParts() metode bersifat baca-saja dan tidak memiliki metode yang dapat diakses untuk menambahkan kontrol individual ke dalamnya. Namun, dalam penimpaan atau implementasi metode, Anda dapat membuat jenis ICollection objek lain, seperti ArrayList, untuk berisi semua kontrol kustom EditorPart , dan meneruskannya ke konstruktor saat Anda membuat objek baru EditorPartCollection . Untuk contoh kode, lihat bagian Contoh.