IWebEditable.CreateEditorParts Metode

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

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

EditorPartCollection

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.

Berlaku untuk

Bagikan melalui