ConnectionsZone.ConfigureVerb Eigenschaft

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Verweis auf ein WebPartVerb Objekt ab, das zum Öffnen der Konfigurationsansicht in der Verbindungsbenutzeroberfläche (UI) verwendet wird.

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

Eigenschaftswert

WebPartVerb

Ein WebPartVerb Verwendeter Zum Öffnen des Abschnitts "Verbindungen konfigurieren" in der Verbindungs-UI.

Attribute: PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der ConfigureVerb Eigenschaft mit einem ConnectionsZone Steuerelement veranschaulicht. Das Beispiel enthält nur den Code für die Webseite, der die Verwendung der Eigenschaft veranschaulicht. die anderen beiden Codedateien, die zum Ausführen des Beispiels erforderlich sind, finden Sie im Abschnitt "Beispiel" der ConnectionsZone Klassenübersicht. Das Codebeispiel enthält vier Teile:

Ein Benutzersteuerelement, mit dem Sie anzeigemodi auf der Webseite wechseln können. Rufen Sie diesen Code aus der ConnectionsZone Klassenübersicht ab.
Eine Quelldatei, die den Code für eine PLZ-Schnittstelle enthält, und zwei WebPart Steuerelemente, die als Anbieter und Consumer für eine Verbindung fungieren. Rufen Sie diesen Code aus der ConnectionsZone Klassenübersicht ab.
Eine Webseite, die alle Steuerelemente hostet, ein <asp:connectionszone> Element deklariert und zeigt, wie die Eigenschaft deklarativ und programmgesteuert verwendet wird.
Eine Erläuterung der Funktionsweise des Beispiels in einem Browser.

Die Webseite deklariert ein <asp:connectionszone> Element, und innerhalb des Elements deklariert es ein <configureverb> Element und legt eine Eigenschaft mithilfe von Attributen fest. Außerdem legt der Code in der Page_PreRender Methode eine Eigenschaft für das Configure-Verb für das ConnectionsZone Steuerelement fest.

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

Laden Sie die Seite in einem Browser. Wechseln Sie zum Verbindungsmodus mithilfe des Anzeigemodus-Steuerelements . Klicken Sie im Steuerelement " PLZ-Anbieter " auf den Menüpfeil "Verben", und klicken Sie auf das Verb "Verbinden". Beachten Sie, dass es eine Schaltfläche " Verbindung beenden " gibt, um die steuerelemente zu trennen, die bereits verbunden sind, und eine deaktivierte Schaltfläche " Konfigurieren ". Wenn Ihr Codebeispiel einen Transformator verwendet hat, der einen Konfigurations-Assistenten enthält, würde die Schaltfläche " Konfigurieren " aktiviert, und Benutzer könnten darauf klicken, um die Verbindung zu konfigurieren. Wenn Sie den Mauszeiger über die Schaltfläche " Konfigurieren " in der Verbindungs-UI positionieren, wird der benutzerdefinierte Beschreibungstext in einer QuickInfo angezeigt.

Hinweise

Das Verb "Konfigurieren" wird im Abschnitt "Verbindungen verwalten" der Verbindungs-UI angezeigt, wenn bereits eine Verbindung vorhanden ist und ein Benutzer die Verbindungs-UI geöffnet hat. Die Benutzeroberfläche zeigt Benutzern eine Schaltfläche " Verbindung beenden" an, um die Verbindung zu beenden, und eine Schaltfläche " Konfigurieren" (die das Configure-Verb darstellt), um die Verbindung zu konfigurieren. Wenn ein Benutzer auf die Schaltfläche " Konfigurieren " klickt, wird der Abschnitt "Verbindungen konfigurieren" der Benutzeroberfläche angezeigt, sodass Benutzer die Verbindung konfigurieren können. Diese Option zum Konfigurieren einer Verbindung (und damit die Schaltfläche " Konfigurieren ") ist nur aktiviert, wenn die Verbindung einen Transformator verwendet, und der Transformator enthält ein Konfigurationsassistenten-Steuerelement (Wizard), mit dem es von Benutzern konfiguriert werden kann. Ausführliche Informationen finden Sie in der WebPartTransformer Klasse.

Verwenden Sie die ConfigureVerb Eigenschaft, um einen Verweis auf das entsprechende WebPartVerb Objekt in der Benutzeroberfläche abzurufen. Obwohl die Eigenschaft selbst schreibgeschützt ist, können Sie die Eigenschaftswerte nach Bedarf ändern, nachdem Sie einen Verweis auf das Verb haben.

Sie können die Eigenschaftswerte des configure-Verbs deklarativ festlegen, indem Sie das <configureverb> Element innerhalb der Tags eines <asp:connectionszone> Elements deklarieren. Die Eigenschaften des Verbs können deklarativ in der Form Property-Subpropertyfestgelegt werden, wobei Subproperty es sich um eine Eigenschaft des WebPartVerb Objekts handelt (z. B ConfigureVerb-Text. ). Sie können die Eigenschaften auch programmgesteuert im Formular Property.Subproperty festlegen (z. B ConfigureVerb.Text. ).

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?