WebPartZoneBase.ExportVerb Właściwość

Definicja

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

WebPartVerb

Element WebPartVerb , który umożliwia użytkownikom końcowym eksportowanie pliku definicji dla WebPart kontrolek.

Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano użycie ExportVerb właściwości w kontrolce WebPartZone . Aby przykładowy kod działał, potrzebny jest cały kod z sekcji HelpVerb Przykład właściwości .

Poniższa część przykładu kodu pochodzi z klasy częściowej i zawiera kod, który przełącza, czy zlecenie eksportu jest włączone, czy wyłączone.

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 ścieżkę lokalną w celu zapisania pliku definicji dla kontrolki.

Uwagi

Czasownik eksportu, ExportVerb do który odwołuje się właściwość, jest wyświetlany 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ż jej wartość domyślna, czyli None.

Dotyczy

Zobacz też