WebPartChrome.GetWebPartVerbs(WebPart) 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.

Mendapatkan kumpulan kata kerja yang harus dirender dengan WebPart kontrol.

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ GetWebPartVerbs(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection GetWebPartVerbs (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection
override this.GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection

Protected Overridable Function GetWebPartVerbs (webPart As WebPart) As WebPartVerbCollection

Parameter

webPart: WebPart

Kontrol saat ini sedang dirender.

Mengembalikan

WebPartVerbCollection

yang WebPartVerbCollection berisi semua kata kerja yang harus dirender dengan webPart.

Pengecualian

ArgumentNullException

webPartadalah null.

Contoh

Contoh kode berikut menunjukkan penggunaan GetWebPartVerbs metode . Untuk kode lengkap yang diperlukan untuk menjalankan contoh, lihat bagian WebPartChrome Contoh topik gambaran umum kelas.

Bagian berikut dari contoh kode menunjukkan cara mengambil GetWebPartVerbs alih metode . Metode yang ditimpa menggunakan metode dasar untuk mengambil semua kata kerja dari webPart kontrol, kemudian melakukan iterasi melalui koleksi kata kerja, menambahkan semua kata kerja kecuali kata kerja tutup ke ArrayList objek. Kumpulan kata kerja yang dikurangi ini kemudian ditetapkan ke yang baru WebPartVerbCollection, yang dikembalikan ke pemanggil.

protected override WebPartVerbCollection GetWebPartVerbs(WebPart webPart)
{
  ArrayList verbSet = new ArrayList();
  foreach (WebPartVerb verb in base.GetWebPartVerbs(webPart))
  {
    if (verb.Text != "Close")
      verbSet.Add(verb);
  }
  WebPartVerbCollection reducedVerbSet = 
    new WebPartVerbCollection(verbSet);
  return reducedVerbSet;
}

Protected Overrides Function GetWebPartVerbs _
  (ByVal webPart As WebPart) As WebPartVerbCollection

  Dim verbSet As New ArrayList()
  Dim verb As WebPartVerb
  For Each verb In MyBase.GetWebPartVerbs(webPart)
    If verb.Text <> "Close" Then
      verbSet.Add(verb)
    End If
  Next verb

  Dim reducedVerbSet As WebPartVerbCollection = _
    New WebPartVerbCollection(verbSet)

  Return reducedVerbSet
End Function

Jika Anda memuat halaman Web di browser dan mengklik menu kata kerja (diperlihatkan dengan panah ke bawah di bilah judul) dari setiap WebPart kontrol, Anda dapat melihat bahwa kata kerja tutup tidak dirender untuk kontrol apa pun.

Keterangan

Metode ini GetWebPartVerbs memberi pengembang kesempatan untuk mengambil alih metode dan mengecualikan kata kerja tertentu agar tidak dirender. Ini mirip FilterWebPartVerbs dengan metode , yang juga dapat mengecualikan kata kerja agar tidak dirender.

Namun, GetWebPartVerbs metode ini tidak dimaksudkan untuk kasus di mana Anda ingin memeriksa beberapa kriteria untuk memutuskan apakah akan merender kata kerja. Sebaliknya, metode ini berguna ketika Anda tahu sebelumnya bahwa Anda selalu ingin mengecualikan kata kerja tertentu. Misalnya, jika Anda mengembangkan kelas kustom WebPartChrome , Anda mungkin memutuskan bahwa Anda selalu ingin mengecualikan kata kerja tutup pada WebPart kontrol, sehingga pengguna tidak pernah dapat menutup kontrol. Daripada mengatur AllowClose properti ke false pada semua kontrol, Anda cukup mengambil GetWebPartVerbs alih metode dan mengecualikan kata kerja tutup agar tidak dirender pada kontrol apa pun yang WebPart dirender dengan objek kustom WebPartChrome Anda.

Berlaku untuk

Lihat juga

ASP.NET Kontrol Bagian Web

Bagikan melalui