WebPartZoneBase.ExportVerb Proprietà

Definizione

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di esportare un file di definizione XML per ogni controllo WebPart di una zona.

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

Valore della proprietà

Oggetto WebPartVerb che consente agli utenti finali di esportare un file di definizione per i controlli WebPart.

Attributi

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della ExportVerb proprietà in un WebPartZone controllo . Per il funzionamento dell'esempio di codice, è necessario tutto il codice della sezione Example della HelpVerb proprietà .

La parte seguente dell'esempio di codice proviene dalla classe parziale e contiene il codice che attiva o disattiva se il verbo di esportazione è abilitato o disabilitato.

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

L'altra parte dell'esempio di codice è la pagina Web che ospita il controllo personalizzato e contiene l'interfaccia utente. Si noti che l'elemento dichiarativo <ExportVerb> nella zona imposta il testo specifico che rappresenta il verbo di esportazione nel menu a discesa verbi per il WebPart controllo .

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

Si noti infine che nell'esempio di codice seguente il valore della proprietà dichiarativa ExportMode nell'elemento <asp:TextDisplayWebPart> è impostato sul valore All, vale a dire che tutti i valori delle proprietà esportabili nel controllo verranno esportati.

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

Dopo aver caricato la pagina in un browser, passare alla modalità di visualizzazione del catalogo e aggiungere il TextDisplayWebPart controllo alla pagina. È possibile utilizzare le caselle di controllo per abilitare e disabilitare il verbo di esportazione nel TextDisplayWebPart controllo . Se si fa clic sul verbo di esportazione, viene richiesto un percorso locale per salvare un file di definizione per il controllo.

Commenti

Il verbo di esportazione a cui fa riferimento la ExportVerb proprietà viene visualizzato nel menu a discesa verbi all'interno della barra del titolo di ogni WebPart controllo in una zona. Il verbo viene visualizzato nel menu dei verbi in tutte le modalità di visualizzazione della pagina.

Per consentire agli utenti di esportare un file di definizione per un WebPart controllo, è inoltre necessario impostare la ExportMode proprietà su un controllo su un valore diverso dal valore predefinito, ovvero None.

Si applica a

Vedi anche