WebPartZoneBase.CloseVerb 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls.WebParts
어셈블리:
System.Web.dll

최종 사용자가 영역의 WebPartVerb 컨트롤을 닫을 수 있도록 하는 WebPart 개체에 대한 참조를 가져옵니다.

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

속성 값

WebPartVerb

최종 사용자가 WebPartVerb 컨트롤을 닫을 수 있도록 하는 WebPart입니다.

특성
PersistenceModeAttribute

예제

다음 코드 예제를 사용 하는 방법을 보여 줍니다.는 CloseVerb 속성을 컨트롤입니다 WebPartZone . 코드 예제가 작동하려면 속성의 예제 섹션에 있는 모든 코드가 HelpVerb 필요합니다.

코드 예제의 다음 부분은 partial 클래스에서 온 것이며 도움말 동사를 사용하도록 설정하거나 사용하지 않도록 설정하는 코드를 포함합니다.

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

코드 예제의 다른 부분은 사용자 지정 컨트롤을 호스트하고 UI를 포함하는 웹 페이지입니다. 영역의 선언적 <CloseVerb> 요소는 컨트롤의 동사 메뉴에서 WebPart 가까운 동사를 나타내는 특정 텍스트를 설정합니다.

<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>

또한 코드 예제에서 사용되는 기본 사용자 지정 WebPart 컨트롤(명명된 TextDisplayWebPart)이 생성자에서 속성을 false 로 설정 AllowClose 하기 때문에 카탈로그의 <aspSample:TextDisplayPart> 요소는 다음 코드 예제에서 컨트롤을 닫을 수 있도록 속성을 true로 설정 AllowClose 해야 합니다.

<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>

브라우저에서 페이지를 로드한 후 페이지를 카탈로그 표시 모드로 전환하고 컨트롤을 TextDisplayWebPart 페이지에 추가합니다. 검사 상자를 사용하여 닫기 동사를 사용하거나 사용하지 않도록 설정할 수 있으며 동사 메뉴에서 WebPart 동사 닫기를 클릭하여 컨트롤을 닫을 수 있습니다. 컨트롤을 닫은 후 페이지를 카탈로그 표시 모드로 되돌리면 페이지 카탈로그를 클릭하고 닫은 컨트롤의 TextDisplayWebPart 원래 instance 선택한 다음 페이지에서 다시 열 수 있습니다.

설명

속성에서 참조하는 CloseVerb 닫기 동사는 영역에 있는 각 WebPart 컨트롤의 동사 메뉴에 나타납니다.

컨트롤을 닫으면 페이지의 상호 작용에서 제거되지만 개발자가 컨트롤이 포함된 PageCatalogPart 영역과 같은 CatalogZone 적절한 UI(사용자 인터페이스)를 제공하는 경우 사용자는 페이지를 로 CatalogDisplayMode 전환하고 이전에 닫힌 컨트롤 instance 페이지에 다시 추가할 수 있습니다.

적용 대상

추가 정보