WebPartZoneBase.ExportVerb 属性

定义

获取对 WebPartVerb 对象的引用,该对象使最终用户能够导出区域中每个 WebPart 控件的 XML 定义文件。Gets a reference to a WebPartVerb object that enables end users to export an XML definition file for each WebPart control in a zone.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ ExportVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb ExportVerb { get; }
member this.ExportVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property ExportVerb As WebPartVerb

属性值

使最终用户能够导出 WebPartVerb 控件的定义文件的 WebPartA WebPartVerb that enables end users to export a definition file for WebPart controls.

属性

示例

下面的代码示例演示如何使用 WebPartZone 控件上的 ExportVerb 属性。The following code example demonstrates the use of the ExportVerb property on a WebPartZone control. 要使代码示例正常运行,您需要 HelpVerb 属性的 "示例" 部分中的所有代码。For the code example to work, you need all the code from the Example section of the HelpVerb property.

下面的代码示例部分来自分部类,并包含用于切换是启用还是禁用导出谓词的代码。The following part of the code example is from the partial class, and contains the code that toggles whether the export verb is enabled or disabled.

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)的网页。The other part of the code example is the Web page that hosts the custom control and contains the user interface (UI). 请注意,区域中的声明性 <ExportVerb> 元素将在 WebPart 控件的谓词下拉菜单中设置表示导出谓词的特定文本。Notice that the declarative <ExportVerb> element in the zone sets the specific text that represents the export verb in the verbs drop-down menu for the WebPart control.

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

最后请注意,在下面的代码示例中,<asp:TextDisplayWebPart> 元素上的声明性 ExportMode 属性值设置为值 All,这意味着将导出控件上的所有可导出属性值。Finally, notice that in the following code example, the declarative ExportMode property value on the <asp:TextDisplayWebPart> element is set to the value All, meaning that all exportable property values on the control will be exported.

<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 控件添加到页面。After you load the page in a browser, switch the page into catalog display mode, and add the TextDisplayWebPart control to the page. 您可以使用此复选框来启用和禁用 TextDisplayWebPart 控件上的导出谓词。You can use the check boxes to enable and disable the export verb on the TextDisplayWebPart control. 如果单击导出谓词,系统将提示你输入本地路径以保存控件的定义文件。If you click the export verb, you are prompted for a local path to save a definition file for the control.

注解

ExportVerb 属性引用的导出谓词将显示在区域中每个 WebPart 控件的标题栏中的谓词下拉菜单中。The export verb referenced by the ExportVerb property appears in the verbs drop-down menu within the title bar of each WebPart control in a zone. 谓词出现在所有页面显示模式下的谓词菜单中。The verb appears in the verbs menu in all page display modes.

若要允许用户导出 WebPart 控件的定义文件,还必须将控件的 ExportMode 属性设置为其默认值 None之外的值。To enable users to export a definition file for a WebPart control, you must also set the ExportMode property on a control to something other than its default value, which is None.

适用于

另请参阅