WebPartZoneBase.ExportVerb Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům exportovat soubor definice XML pro každý WebPart ovládací prvek v zóně.

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

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

Public Overridable ReadOnly Property ExportVerb As WebPartVerb

Hodnota vlastnosti

WebPartVerb

A WebPartVerb , který umožňuje koncovým uživatelům exportovat soubor definice ovládacích WebPart prvků.

Atributy

PersistenceModeAttribute

Příklady

Následující příklad kódu ukazuje použití ExportVerb vlastnosti WebPartZone ovládacího prvku. Aby příklad kódu fungoval, potřebujete veškerý kód z části HelpVerb Example vlastnosti .

Následující část příkladu kódu pochází z částečné třídy a obsahuje kód, který přepíná, zda je příkaz exportu povolen nebo zakázán.

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

Druhou částí příkladu kódu je webová stránka, která je hostitelem vlastního ovládacího prvku a obsahuje uživatelské rozhraní (UI). Všimněte si, že deklarativní <ExportVerb> prvek v zóně nastaví konkrétní text, který představuje příkaz exportu v rozevírací nabídce sloves pro WebPart ovládací prvek.

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

Nakonec si všimněte, že v následujícím příkladu kódu je deklarativní ExportMode hodnota vlastnosti elementu <asp:TextDisplayWebPart> nastavená na hodnotu All, což znamená, že všechny exportovatelné hodnoty vlastností ovládacího prvku budou exportovány.

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

Po načtení stránky v prohlížeči přepněte stránku do režimu zobrazení katalogu a přidejte TextDisplayWebPart na stránku ovládací prvek. Pomocí zaškrtávacích políček můžete u ovládacího prvku povolit nebo zakázat příkaz exportu TextDisplayWebPart . Pokud kliknete na příkaz exportu, zobrazí se výzva k zadání místní cesty pro uložení souboru definice pro ovládací prvek.

Poznámky

Příkaz exportu ExportVerb , na který odkazuje vlastnost, se zobrazí v rozevírací nabídce sloves v záhlaví každého WebPart ovládacího prvku v zóně. Příkaz se zobrazí v nabídce sloves ve všech režimech zobrazení stránky.

Pokud chcete uživatelům povolit export definičního souboru WebPart ovládacího prvku, musíte vlastnost ovládacího prvku nastavit ExportMode na jinou než jeho výchozí hodnotu, což je None.

Viz také

• ExportMode
• ASP.NET ovládací prvky webových částí