ConnectionsZone.ConnectVerb Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene un riferimento a un oggetto WebPartVerb che consente a due controlli WebPart di stabilire una connessione.

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

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

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

Public Overridable ReadOnly Property ConnectVerb As WebPartVerb

Valore della proprietà

WebPartVerb

Oggetto WebPartVerb che consente a due controlli di stabilire una connessione.

Attributi: PersistenceModeAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso ConnectVerb della proprietà con un ConnectionsZone controllo. L'esempio contiene solo il codice per la pagina Web che illustra l'uso della proprietà; per gli altri due file di codice necessari per eseguire l'esempio, vedere la sezione Esempio della panoramica della ConnectionsZone classe. L'esempio di codice include quattro parti:

Controllo utente che consente di cambiare le modalità di visualizzazione nella pagina Web. Ottenere questo codice dalla panoramica della ConnectionsZone classe.
Un file di origine contenente il codice per un'interfaccia di codice POSTALE e due WebPart controlli che agiscono come provider e il consumer per una connessione. Ottenere questo codice dalla panoramica della ConnectionsZone classe.
Una pagina Web che ospita tutti i controlli, dichiara un <asp:connectionszone> elemento e mostra come usare la proprietà dichiarativamente e a livello di codice.
Spiegazione del funzionamento dell'esempio in un browser.

La pagina Web dichiara un elemento e, all'interno dei tag di elemento, dichiara un <asp:connectionszone> <connectverb> elemento e imposta alcune proprietà usando attributi. Inoltre, nel Page_PreRender metodo, il codice imposta alcune proprietà nel verbo di connessione per il ConnectionsZone controllo.

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

Caricare la pagina in un browser. Passare alla modalità di connessione usando il controllo Modalità di visualizzazione . Fare clic sulla freccia del menu verbi nel controllo Provider di codice POSTALE e fare clic sul verbo di connessione. Fare clic sul pulsante Termina connessione per disconnettere i controlli già connessi a causa della connessione dichiarativa nella pagina. Fare clic su Seleziona un consumer per il provider per connettersi con il collegamento ipertestuale e notare l'effetto dell'impostazione delle varie proprietà. Se si posiziona il puntatore del mouse sul pulsante Connessione Controls, il testo della descrizione personalizzata viene visualizzato in una descrizione comando.

Commenti

Il verbo di connessione, usato con un controllo, è un ConnectionsZone verbo a livello di zona visualizzato nell'interfaccia utente della connessione come parte della visualizzazione in cui gli utenti finalizzano una connessione tra due controlli. Nella parte dell'interfaccia utente in cui gli utenti possono selezionare i punti di connessione, se due controlli sono in grado di connettersi, il verbo di connessione è abilitato nella parte inferiore dell'interfaccia utente. Dopo che gli utenti selezionano un punto di connessione, possono fare clic sul verbo di connessione per creare la connessione.

Nota

Il verbo di connessione a livello di zona descritto in questo argomento stabilisce effettivamente una connessione tra controlli ed è diverso dal verbo visualizzato nel menu verbi di un WebPart controllo. Quando un utente passa una pagina Web per connettersi alla modalità di visualizzazione, se un controllo può formare le connessioni, viene visualizzato un WebPart verbo di connessione nel relativo menu dei verbi. Questo WebPart verbo di connessione apre semplicemente l'interfaccia ConnectionsZone utente di connessione creata dal controllo. Al contrario, il ConnectVerb verbo descritto in questo argomento, che opera a livello di zona, crea effettivamente una connessione.

Utilizzare la ConnectVerb proprietà per ottenere un riferimento all'oggetto corrispondente WebPartVerb nell'interfaccia utente. Anche se la proprietà stessa è di sola lettura, dopo avere un riferimento al verbo, è possibile modificare i relativi valori di proprietà in base alle esigenze.

È possibile impostare i valori delle proprietà del verbo connect dichiarativo dichiarando l'elemento <connectverb> tra i tag di apertura e chiusura di un <asp:connectionszone> elemento. Le proprietà del verbo possono anche essere impostate in modo dichiarativo all'interno del tag di apertura dell'elemento, aggiungendo un attributo nel formato , dove Subproperty è una proprietà dell'oggetto <asp:connectionszone> WebPartVerb , ad esempio ConnectVerb-Text.Property-Subproperty È anche possibile impostare le proprietà a livello di codice nel modulo Property.Subproperty , ad esempio ConnectVerb.Text.

Si applica a

Vedi anche

WebPartVerb