WebPartZoneBase.ExportVerb Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera odwołanie do WebPartVerb obiektu, który umożliwia użytkownikom końcowym eksportowanie pliku definicji XML dla każdej WebPart kontrolki w strefie.
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
Wartość właściwości
Element WebPartVerb , który umożliwia użytkownikom końcowym eksportowanie pliku definicji dla WebPart kontrolek.
- Atrybuty
Przykłady
Poniższy przykład kodu przedstawia użycie ExportVerb właściwości w kontrolce WebPartZone . Aby przykład kodu działał, potrzebny jest cały kod z sekcji Przykład właściwości HelpVerb .
Poniższa część przykładu kodu pochodzi z klasy częściowej i zawiera kod, który przełącza się, czy czasownik eksportu jest włączony, czy wyłączony.
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
Drugą częścią przykładu kodu jest strona internetowa, która hostuje kontrolkę niestandardową i zawiera interfejs użytkownika. Zwróć uwagę, że element deklaratywny <ExportVerb>
w strefie ustawia określony tekst, który reprezentuje czasownik eksportu w menu rozwijanym czasowników dla kontrolki 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>
Na koniec zwróć uwagę, że w poniższym przykładzie kodu wartość właściwości deklaratywnej ExportMode<asp:TextDisplayWebPart>
elementu jest ustawiona na wartość All
, co oznacza, że wszystkie wartości właściwości możliwych do wyeksportowania w kontrolce zostaną wyeksportowane.
<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 załadowaniu strony w przeglądarce przełącz stronę do trybu wyświetlania wykazu i dodaj kontrolkę TextDisplayWebPart
do strony. Możesz użyć pól wyboru, aby włączyć i wyłączyć czasownik eksportu w kontrolce TextDisplayWebPart
. Po kliknięciu czasownika eksportu zostanie wyświetlony monit o zapisanie pliku definicji dla kontrolki w ścieżce lokalnej.
Uwagi
Czasownik eksportu, do który ExportVerb odwołuje się właściwość, pojawia się w menu rozwijanym czasowników na pasku tytułu każdej WebPart kontrolki w strefie. Czasownik jest wyświetlany w menu czasowników we wszystkich trybach wyświetlania strony.
Aby umożliwić użytkownikom eksportowanie pliku definicji dla WebPart kontrolki, należy również ustawić ExportMode właściwość kontrolki na inną niż jego wartość domyślna, czyli None.