Partager via


ConnectionsZone.DisconnectVerb Propriété

Définition

Obtient une référence à un objet WebPartVerb qui permet à un utilisateur de déconnecter deux contrôles WebPart connectés.

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

Valeur de propriété

WebPartVerb qui déconnecte deux contrôles WebPart connectés.

Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de la DisconnectVerb 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.

  • Une 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, dans les balises d’élément, déclare un <disconnectverb> élément et définit certaines propriétés à l’aide d’attributs. En outre, dans la Page_PreRender méthode, le code définit certaines propriétés sur le verbe de déconnexion 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 en mode de 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 de connexion. Notez l’effet des valeurs de propriété qui ont été définies sur le verbe de déconnexion. Si vous positionnez le pointeur de la souris sur le bouton Terminer la connexion , le texte de description personnalisé s’affiche dans une info-bulle. Cliquez sur le bouton Terminer la connexion pour déconnecter les contrôles qui sont déjà connectés en raison de la connexion déclarative sur la page.

Remarques

Le verbe de déconnexion, tel qu’utilisé avec un ConnectionsZone contrôle, est un verbe au niveau de la zone qui apparaît dans l’interface utilisateur de connexion dans le cadre de la vue dans laquelle les utilisateurs gèrent une connexion existante entre deux contrôles. Une fois que les utilisateurs ont cliqué sur le WebPart verbe de connexion dans le menu verbes d’un contrôle et que l’interface utilisateur de connexion s’affiche, s’il existe déjà une connexion entre deux contrôles, le verbe de déconnexion apparaît activé près du bas de l’interface utilisateur.

Utilisez la DisconnectVerb 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é si nécessaire.

Vous pouvez définir les valeurs de propriété du verbe de déconnexion de manière déclarative, en déclarant l’élément <disconnectverb> entre les balises d’ouverture et de fermeture d’un <asp:connectionszone> élément. Les propriétés du verbe peuvent également être définies de manière déclarative dans la balise d’ouverture de l’élément <asp:connectionszone> , en ajoutant un attribut sous la forme Property-Subproperty, où Subproperty est une propriété de l’objet WebPartVerb (par exemple, DisconnectVerb-Text). Vous pouvez également définir les propriétés par programmation dans la forme Property.Subproperty (par exemple, DisconnectVerb.Text).

S’applique à

Voir aussi