WebPartZoneBase.CloseVerb Properti

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 referensi ke WebPartVerb objek yang memungkinkan pengguna akhir menutup WebPart kontrol di zona.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Nilai Properti

WebPartVerb

WebPartVerb yang memungkinkan pengguna akhir menutup WebPart kontrol.

Atribut: PersistenceModeAttribute

Contoh

Contoh kode berikut menunjukkan penggunaan CloseVerb properti pada WebPartZone kontrol. Agar contoh kode berfungsi, Anda memerlukan semua kode dari bagian HelpVerb Contoh properti.

Bagian berikut dari contoh kode adalah dari kelas parsial, dan berisi kode yang beralih apakah kata kerja bantuan diaktifkan atau dinonaktifkan.

protected void CheckBoxList1_SelectedItemIndexChanged(Object sender, EventArgs e)
{
  foreach (ListItem item in CheckBoxList1.Items)
  {
    WebPartVerb theVerb;
    switch (item.Value)
    {
      case "close":
        theVerb = WebPartZone1.CloseVerb;
        break;
      case "export":
        theVerb = WebPartZone1.ExportVerb;
        break;
      case "delete":
        theVerb = WebPartZone1.DeleteVerb;
        break;
      case "minimize":
        theVerb = WebPartZone1.MinimizeVerb;
        break;
      case "restore":
        theVerb = WebPartZone1.RestoreVerb;
        break;
      default:
        theVerb = null;
        break;
    }

    if (item.Selected)
      theVerb.Enabled = true;
    else
      theVerb.Enabled = false;
  }
}

Protected Sub CheckBoxList1_SelectedItemIndexChanged(ByVal sender As [Object], ByVal e As EventArgs)
  Dim item As ListItem
  For Each item In CheckBoxList1.Items
    Dim theVerb As WebPartVerb
    Select Case item.Value
      Case "close"
        theVerb = WebPartZone1.CloseVerb
      Case "export"
        theVerb = WebPartZone1.ExportVerb
      Case "delete"
        theVerb = WebPartZone1.DeleteVerb
      Case "minimize"
        theVerb = WebPartZone1.MinimizeVerb
      Case "restore"
        theVerb = WebPartZone1.RestoreVerb
      Case Else
        theVerb = Nothing
    End Select

    If item.Selected Then
      theVerb.Enabled = True
    Else
      theVerb.Enabled = False
    End If
  Next item

End Sub

Bagian lain dari contoh kode adalah halaman Web yang menghosting kontrol kustom dan berisi UI. Perhatikan bahwa elemen deklaratif <CloseVerb> di zona mengatur teks tertentu yang mewakili kata kerja tutup di menu kata kerja untuk WebPart kontrol.

<asp:WebPartZone ID="WebPartZone1" Runat="server">
  <CloseVerb Text="Close WebPart" />
  <HelpVerb Text="View Help" />
  <ExportVerb Text="Export WebPart Definition" />
  <DeleteVerb Text ="Delete WebPart" />
  <MinimizeVerb Description="Minimize the control" />
  <RestoreVerb Description="Restore the control" />
  <ZoneTemplate>
  </ZoneTemplate>  
</asp:WebPartZone>

<asp:WebPartZone ID="WebPartZone1" Runat="server">
  <CloseVerb Text="Close WebPart" />
  <HelpVerb Text="View Help" />
  <ExportVerb Text="Export WebPart Definition" />
  <DeleteVerb Text ="Delete WebPart" />
  <MinimizeVerb Description="Minimize the control" />
  <RestoreVerb Description="Restore the control" />
  <ZoneTemplate>
  </ZoneTemplate>  
</asp:WebPartZone>

Perhatikan juga bahwa, karena kontrol kustom yang mendasar WebPart AllowClose--bernama TextDisplayWebPart-- yang digunakan dalam contoh kode mengatur properti ke false dalam konstruktornya, <aspSample:TextDisplayPart> elemen dalam katalog harus mengatur AllowClose properti ke true, sehingga kontrol dapat ditutup dalam contoh kode berikut.

<asp:CatalogZone ID="CatalogZone1" Runat="server">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      Runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          width="350px" 
          AllowClose="true"
          ExportMode="All"
          HelpMode="Modal"
          HelpUrl="TextWebPartHelp.htm" />            
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
  </ZoneTemplate>
</asp:CatalogZone>

<asp:CatalogZone ID="CatalogZone1" Runat="server">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      Runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          width="350px" 
          AllowClose="true"
          ExportMode="All"
          HelpMode="Modal"
          HelpUrl="TextWebPartHelp.htm" />            
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" Runat="server" />
  </ZoneTemplate>
</asp:CatalogZone>

Setelah Anda memuat halaman di browser, alihkan halaman ke mode tampilan katalog, dan tambahkan TextDisplayWebPart kontrol ke halaman. Anda dapat menggunakan kotak centang untuk mengaktifkan dan menonaktifkan kata kerja tutup, dan Anda dapat mengklik kata kerja Tutup Bagian Web di menu kata kerja untuk menutup kontrol. Setelah Anda menutup kontrol, jika Anda mengembalikan halaman ke mode tampilan katalog, Anda dapat mengklik Katalog Halaman, memilih contoh TextDisplayWebPart asli kontrol yang Anda tutup, dan membukanya kembali di halaman.

Keterangan

Kata kerja tutup yang dirujuk CloseVerb oleh properti muncul di menu kata kerja setiap WebPart kontrol di zona.

Menutup kontrol akan menghapusnya dari interaksi di halaman, meskipun jika pengembang menyediakan antarmuka pengguna (UI) yang sesuai, seperti CatalogZone zona yang berisi PageCatalogPart kontrol, pengguna dapat mengalihkan halaman ke dalam CatalogDisplayMode dan menambahkan instans kontrol yang ditutup sebelumnya kembali ke halaman.

Berlaku untuk

Bagikan melalui