Partager via


ConnectionsZone.ConfigureVerb Propriété

Définition

Apporte une référence à un objet WebPartVerb utilisé pour ouvrir l'affichage de configuration dans l'interface utilisateur de connexion.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ ConfigureVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb ConfigureVerb { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.ConfigureVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property ConfigureVerb As WebPartVerb

Valeur de propriété

WebPartVerb utilisé pour ouvrir la section Configurer les connexions dans l'interface utilisateur de connexion.

Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de la ConfigureVerb propriété avec un ConnectionsZone contrôle . L’exemple contient uniquement le code de la page Web qui illustre l’utilisation de la propriété ; Pour les deux autres fichiers de code nécessaires à l’exécution de l’exemple, consultez la section Exemple de la vue d’ensemble de la ConnectionsZone classe. L’exemple de code comporte quatre parties :

  • Contrôle utilisateur qui vous permet de changer de mode d’affichage sur la page Web. Obtenez ce code à partir de la vue d’ensemble de la ConnectionsZone classe.

  • Fichier source qui contient le code d’une interface de code postal et deux WebPart contrôles agissant en tant que fournisseur et consommateur pour une connexion. Obtenez ce code à partir de la vue d’ensemble de la ConnectionsZone classe.

  • Page Web qui héberge tous les contrôles, déclare un <asp:connectionszone> élément et montre comment utiliser la propriété de manière déclarative et programmatique.

  • Explication du fonctionnement de l’exemple dans un navigateur.

La page Web déclare un <asp:connectionszone> élément, et au sein de l’élément, elle déclare un <configureverb> élément et définit une propriété à l’aide d’attributs. En outre, dans la Page_PreRender méthode , le code définit une propriété sur le verbe configurer pour le ConnectionsZone contrôle .

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuCS"
    src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_PreRender(object sender, EventArgs e)
  {
     // Set properties on verbs.
     connectionsZone1.CancelVerb.Description = 
       "Terminates the connection process";
     connectionsZone1.CloseVerb.Description = 
       "Closes the connections UI";
     connectionsZone1.ConfigureVerb.Description =
       "Configure the transformer for the connection";
     connectionsZone1.ConnectVerb.Description =
       "Connect two WebPart controls";
     connectionsZone1.DisconnectVerb.Description =
       "End the connection between two controls";
    
     // Set properties for UI text strings.
     connectionsZone1.ConfigureConnectionTitle = 
       "Configure";
     connectionsZone1.ConnectToConsumerInstructionText = 
       "Choose a consumer connection point";
     connectionsZone1.ConnectToConsumerText = 
       "Select a consumer for the provider to connect with";
     connectionsZone1.ConnectToConsumerTitle = 
       "Send data to this consumer";
     connectionsZone1.ConnectToProviderInstructionText =
       "Choose a provider connection point";
     connectionsZone1.ConnectToProviderText =
       "Select a provider for the consumer to connect with";
     connectionsZone1.ConnectToProviderTitle =
       "Get data from this provider";
     connectionsZone1.ConsumersInstructionText = 
       "WebPart controls that receive data from providers";
     connectionsZone1.ConsumersTitle = "Consumer Controls";
     connectionsZone1.GetFromText = "Receive from";
     connectionsZone1.GetText = "Retrieve";
     connectionsZone1.HeaderText = 
      "Create and Manage Connections";
     connectionsZone1.InstructionText = 
      "Manage connections for the selected WebPart control";
     connectionsZone1.InstructionTitle = 
       "Manage connections for consumers or providers";
     connectionsZone1.NoExistingConnectionInstructionText = 
       "No connections exist. Click the above link to create "
       + "a connection.";
     connectionsZone1.NoExistingConnectionTitle = 
       "No current connections";
     connectionsZone1.ProvidersInstructionText =
       "WebPart controls that send data to consumers";
     connectionsZone1.ProvidersTitle = "Provider controls";
     
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenucs id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider"  />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ register tagprefix="uc1" 
    tagname="DisplayModeMenuVB"
    src="~/displaymodemenuvb.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_PreRender(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    ' Set properties for verbs.
    connectionsZone1.CancelVerb.Description = _
      "Terminates the connection process"
    connectionsZone1.CloseVerb.Description = _
      "Closes the connections UI"
    connectionsZone1.ConfigureVerb.Description = _
      "Configure the transformer for the connection"
    connectionsZone1.ConnectVerb.Description = _
      "Connect two WebPart controls"
    connectionsZone1.DisconnectVerb.Description = _
      "End the connection between two controls"
    
    ' Set properties for UI text strings.
    connectionsZone1.ConfigureConnectionTitle = _
      "Configure a new connection"
    connectionsZone1.ConnectToConsumerInstructionText = _
      "Choose a consumer connection point"
    connectionsZone1.ConnectToConsumerText = _
      "Select a consumer for the provider to connect with"
    connectionsZone1.ConnectToConsumerTitle = _
      "Send data to this consumer"
    connectionsZone1.ConnectToProviderInstructionText = _
      "Choose a provider connection point"
    connectionsZone1.ConnectToProviderText = _
      "Select a provider for the consumer to connect with"
    connectionsZone1.ConnectToProviderTitle = _
      "Get data from this provider"
    connectionsZone1.ConsumersInstructionText = _
      "WebPart controls that receive data from providers"
    connectionsZone1.ConsumersTitle = "Consumer Controls"
    connectionsZone1.GetFromText = "Receive from"
    connectionsZone1.GetText = "Retrieve"
    connectionsZone1.HeaderText = _
      "Create and Manage Connections"
    connectionsZone1.InstructionText = _
      "Manage connections for the selected WebPart control"
    connectionsZone1.InstructionTitle = _
      "Manage connections for consumers or providers"
    connectionsZone1.NoExistingConnectionInstructionText = _
      "No connections exist. Click the above link to create " _
      & "a connection."
    connectionsZone1.NoExistingConnectionTitle = _
      "No current connections"
    connectionsZone1.ProvidersInstructionText = _
      "WebPart controls that send data to consumers"
    connectionsZone1.ProvidersTitle = "Provider controls"

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Connection Zone Sample</title>
</head>
<body>
  <form id="form1" runat="server">
  <asp:webpartmanager runat="server" id="mgr">
    <staticconnections>
      <asp:webpartconnection id="connection1" 
        consumerconnectionpointid="ZipCodeConsumer"
        consumerid="zipConsumer"
        providerconnectionpointid="ZipCodeProvider" 
        providerid="zipProvider" />
    </staticconnections>
  </asp:webpartmanager>
  <uc1:displaymodemenuvb id="menu1" runat="server" />
  <div>
  <asp:webpartzone id="WebPartZone1" runat="server">
    <zonetemplate>
      <aspsample:zipcodewebpart id="zipProvider" runat="server" 
        Title="Zip Code Provider" />
      <aspsample:weatherwebpart id="zipConsumer" runat="server" 
        Title="Zip Code Consumer" />
    </zonetemplate>
  </asp:webpartzone>
  <asp:connectionszone id="connectionsZone1" runat="server" >
    <cancelverb text="Terminate" />
    <closeverb text="Close Zone" />
    <configureverb text="Configure" />
    <connectverb text="Connect Controls" />
    <disconnectverb text="End Connection" />
  </asp:connectionszone>
  </div>
  </form>
</body>
</html>

Chargez la page dans un navigateur. Basculez vers le mode connexion à l’aide du contrôle Mode d’affichage . Cliquez sur la flèche du menu verbes dans le contrôle Fournisseur de code postal , puis cliquez sur le verbe connecter. Notez qu’il existe un bouton Terminer la connexion pour déconnecter les contrôles déjà connectés et un bouton Configurer désactivé. Si votre exemple de code utilisait un transformateur incluant un Assistant Configuration, le bouton Configurer est activé et les utilisateurs peuvent cliquer dessus pour configurer la connexion. Si vous positionnez le pointeur de la souris sur le bouton Configurer dans l’interface utilisateur de connexion, le texte de description personnalisée s’affiche dans une info-bulle.

Remarques

Le verbe configurer apparaît dans la section Gérer les connexions de l’interface utilisateur de connexion, lorsqu’une connexion existe déjà et qu’un utilisateur a ouvert l’interface utilisateur de connexion. L’interface utilisateur présente aux utilisateurs un bouton Terminer la connexion pour mettre fin à la connexion, et un bouton Configurer (qui représente le verbe configurer) pour configurer la connexion. Si un utilisateur clique sur le bouton Configurer , la section Configurer les connexions de l’interface utilisateur s’affiche, ce qui permet aux utilisateurs de configurer la connexion. Cette option de configuration d’une connexion (et par conséquent le bouton Configurer ) est activée uniquement lorsque la connexion utilise un transformateur et que le transformateur inclut un contrôle d’Assistant Configuration (Wizard) qui lui permet d’être configuré par les utilisateurs. Pour plus d’informations, consultez la WebPartTransformer classe .

Utilisez la ConfigureVerb propriété pour obtenir une référence à l’objet correspondant WebPartVerb dans l’interface utilisateur. Bien que la propriété elle-même soit en lecture seule, une fois que vous avez une référence au verbe, vous pouvez modifier ses valeurs de propriété en fonction des besoins.

Vous pouvez définir les valeurs de propriété du verbe configurer de manière déclarative, en déclarant l’élément <configureverb> dans les balises d’un <asp:connectionszone> élément. Les propriétés du verbe peuvent être définies de manière déclarative sous la forme , où Subproperty est une propriété de l’objet WebPartVerb (par exemple, ConfigureVerb-Text).Property-Subproperty Vous pouvez également définir les propriétés par programmation dans le formulaire Property.Subproperty (par exemple, ConfigureVerb.Text).

S’applique à

Voir aussi