WebPartZoneBase.ExportVerb Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.WebPartVerbPublic Overridable ReadOnly Property ExportVerb As WebPartVerbEigenschaftswert
Ein WebPartVerb, mit dem Endbenutzer eine Definitionsdatei für WebPart-Steuerelemente exportieren können.
- Attribute
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 Abschnitt Beispiel der HelpVerb -Eigenschaft.
Der folgende Teil des Codebeispiels stammt aus der partiellen Klasse und enthält den Code, der umschalten kann, 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 hostet und die Benutzeroberfläche (UI) enthält. Beachten Sie, dass das deklarative <ExportVerb> Element in der Zone den spezifischen Text festlegt, der das Exportverb im Dropdownmenü Verben 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 ist, was bedeutet, dass alle exportierbaren Eigenschaftswerte im Steuerelement 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 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 zur Eingabe eines lokalen Pfads aufgefordert, um eine Definitionsdatei für das Steuerelement zu speichern.
Hinweise
Das Exportverb, auf das von der ExportVerb -Eigenschaft verwiesen wird, wird im Dropdownmenü Verben in der Titelleiste jedes WebPart Steuerelements in einer Zone angezeigt. Das Verb wird im Verbenmenü in allen Seitenanzeigemodi angezeigt.
Damit Benutzer eine Definitionsdatei für ein WebPart Steuerelement exportieren können, müssen Sie die ExportMode Eigenschaft eines Steuerelements auch auf einen anderen Als den Standardwert festlegen, nämlich None.
