WebPartZoneBase.ExportVerb Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final d'exporter un fichier de définition XML pour chaque contrôle WebPart contenu dans une zone.

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

Valeur de propriété

WebPartVerb

WebPartVerb qui permet à l'utilisateur final d'exporter un fichier de définition pour les contrôles WebPart.

Attributs: PersistenceModeAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la ExportVerb propriété sur un WebPartZone contrôle. Pour que l’exemple de code fonctionne, vous avez besoin de tout le code de la section Exemple de la HelpVerb propriété .

La partie suivante de l’exemple de code provient de la classe partielle et contient le code qui bascule si le verbe d’exportation est activé ou désactivé.

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’autre partie de l’exemple de code est la page Web qui héberge le contrôle personnalisé et contient l’interface utilisateur. Notez que l’élément déclaratif <ExportVerb> de la zone définit le texte spécifique qui représente le verbe d’exportation dans le menu déroulant verbes du WebPart contrôle.

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

Enfin, notez que dans l’exemple de code suivant, la valeur de la propriété déclarative ExportMode sur l’élément <asp:TextDisplayWebPart> est définie sur la valeur All, ce qui signifie que toutes les valeurs de propriété exportables sur le contrôle seront exportées.

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

Après avoir chargé la page dans un navigateur, basculez la page en mode d’affichage catalogue et ajoutez le TextDisplayWebPart contrôle à la page. Vous pouvez utiliser les cases à cocher pour activer et désactiver le verbe d’exportation sur le TextDisplayWebPart contrôle. Si vous cliquez sur le verbe d’exportation, vous êtes invité à entrer un chemin d’accès local pour enregistrer un fichier de définition pour le contrôle.

Remarques

Le verbe d’exportation référencé par la ExportVerb propriété s’affiche dans le menu déroulant verbes de la barre de titre de chaque WebPart contrôle d’une zone. Le verbe s’affiche dans le menu verbes dans tous les modes d’affichage de page.

Pour permettre aux utilisateurs d’exporter un fichier de définition pour un WebPart contrôle, vous devez également définir la ExportMode propriété d’un contrôle sur une valeur autre que sa valeur par défaut, qui est None.

S’applique à

Partager via