WebPartZoneBase.ExportVerb Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft einen Verweis auf ein WebPartVerb-Objekt ab, mit dem Endbenutzer eine XML-Definitionsdatei für jedes WebPart-Steuerelement in einer Zone exportieren können.

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

Eigenschaftswert

WebPartVerb

Ein WebPartVerb, mit dem Endbenutzer eine Definitionsdatei für WebPart-Steuerelemente exportieren können.

Attribute
PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ExportVerb Eigenschaft für ein WebPartZone Steuerelement veranschaulicht. Damit das Codebeispiel funktioniert, benötigen Sie den gesamten Code aus dem Beispielabschnitt der HelpVerb Eigenschaft.

Der folgende Teil des Codebeispiels stammt aus der Teilklasse und enthält den Code, der umschaltt, ob das Exportverb aktiviert oder deaktiviert ist.

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

Der andere Teil des Codebeispiels ist die Webseite, die das benutzerdefinierte Steuerelement hostt und die Benutzeroberfläche enthält. Beachten Sie, dass das deklarative <ExportVerb> Element in der Zone den spezifischen Text festlegt, der das Exportverb im Dropdownmenü für das WebPart Steuerelement darstellt.

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

Beachten Sie schließlich, dass im folgenden Codebeispiel der deklarative ExportMode Eigenschaftswert für das <asp:TextDisplayWebPart> Element auf den Wert Allfestgelegt wird, was bedeutet, dass alle exportierbaren Eigenschaftswerte des Steuerelements exportiert werden.

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

Nachdem Sie die Seite in einem Browser geladen haben, wechseln Sie die Seite in den Kataloganzeigemodus, und fügen Sie das TextDisplayWebPart Steuerelement der Seite hinzu. Sie können die Kontrollkästchen verwenden, um das Exportverb für das TextDisplayWebPart Steuerelement zu aktivieren und zu deaktivieren. Wenn Sie auf das Exportverb klicken, werden Sie aufgefordert, einen lokalen Pfad zum Speichern einer Definitionsdatei für das Steuerelement zu erhalten.

Hinweise

Das von der ExportVerb Eigenschaft referenzierte Exportverb wird im Dropdownmenü "Verben" in der Titelleiste jedes WebPart Steuerelements in einer Zone angezeigt. Das Verb wird im Menü "Verben" in allen Seitenanzeigemodi angezeigt.

Damit Benutzer eine Definitionsdatei für ein WebPart Steuerelement exportieren können, müssen Sie auch die ExportMode Eigenschaft für ein Steuerelement auf einen anderen Wert als den Standardwert festlegen.None

Gilt für

Siehe auch