ConnectionsZone.CloseVerb 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 de fermer l'interface utilisateur de connexion créée par le contrôle ConnectionsZone.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CloseVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CloseVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CloseVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property CloseVerb As WebPartVerb

Valeur de propriété

WebPartVerb

WebPartVerb qui permet à un utilisateur final de fermer l'interface utilisateur de connexion.

Attributs: PersistenceModeAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la CloseVerb 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 <closeverb> é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 de fermeture 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. Cliquez sur le bouton Terminer la connexion pour déconnecter les contrôles déjà connectés en raison de la connexion déclarative sur la page. Cliquez sur le lien hypertexte Sélectionner un consommateur pour que le fournisseur se connecte avec , et notez l’effet de la définition des différentes propriétés. Si vous placez le pointeur de la souris sur le bouton Fermer la zone en bas de l’interface utilisateur de connexion, le texte de description personnalisée s’affiche dans une info-bulle. Notez que le verbe de fermeture d’en-tête en haut de la zone connexions est représenté par un lien hypertexte, et que vos affectations de propriétés sur le verbe de fermeture n’ont aucun effet sur le verbe de fermeture d’en-tête.

Remarques

Le verbe proche, tel qu’il est utilisé avec un ConnectionsZone contrôle, est un verbe au niveau de la zone qui apparaît en bas (le pied de page) de l’interface utilisateur de connexion. Lorsque les utilisateurs cliquent sur le verbe de fermeture, cela annule le processus de connexion et ferme l’interface utilisateur de connexion, mais laisse la page en mode d’affichage de connexion. À ce stade, l’utilisateur peut retourner la page en mode de navigation ou cliquer sur le verbe de connexion sur un autre contrôle serveur pour rouvrir l’interface utilisateur de connexion.

Le verbe de fermeture doit être distingué du verbe de fermeture d’en-tête (pour plus d’informations, consultez la HeaderCloseVerb propriété ). Les deux verbes effectuent l’action identique de fermeture de l’interface utilisateur de connexion, mais le verbe de fermeture d’en-tête apparaît en haut de l’interface utilisateur et est représenté par un lien hypertexte par défaut, tandis que le verbe fermer apparaît en bas de l’interface utilisateur et est représenté par un bouton par défaut.

Utilisez la CloseVerb 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 de fermeture de manière déclarative, en déclarant l’élément <closeverb> 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, CloseVerb-Text).Property-Subproperty Vous pouvez également définir les propriétés par programmation dans le formulaire Property.Subproperty (par exemple, CloseVerb.Text).

S’applique à

Partager via