ConnectionsZone.DisconnectVerb Eigenschaft

Referenz

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, mit dem zwei verbundene WebPart-Steuerelemente getrennt werden können.

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

Eigenschaftswert

WebPartVerb

Ein WebPartVerb, mit dem zwei verbundene WebPart-Steuerelemente getrennt werden.

Attribute: PersistenceModeAttribute

Beispiele

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

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 POSTLEITZAHL-Schnittstelle enthält, und zwei WebPart Steuerelemente, die als Anbieter und Verbraucher 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 Sie die Eigenschaft deklarativ und programmgesteuert verwenden.
Eine Erklärung darüber, wie das Beispiel in einem Browser funktioniert.

Die Webseite deklariert ein Element und deklariert innerhalb der Elementtags ein <asp:connectionszone> <disconnectverb> Element und legt einige Eigenschaften mithilfe von Attributen fest. Außerdem legt der Code in der Page_PreRender Methode einige Eigenschaften für das Trennverb 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 auf den Menüpfeil "Verben" im Steuerelement " Postleitzahlanbieter ", und klicken Sie auf das Verb "Verbinden". Beachten Sie die Auswirkung der Eigenschaftenwerte, die auf dem Trennverb festgelegt wurden. Wenn Sie den Mauszeiger über die Schaltfläche "Verbindung beenden" positionieren, wird der benutzerdefinierte Beschreibungstext in einer QuickInfo angezeigt. Klicken Sie auf die Schaltfläche "Verbindung beenden", um die Steuerelemente zu trennen, die aufgrund der deklarativen Verbindung auf der Seite bereits verbunden sind.

Hinweise

Das Verteilerverb, wie mit einem ConnectionsZone Steuerelement verwendet, ist ein Verb auf Zonenebene, das im Rahmen der Ansicht angezeigt wird, in der Benutzer eine vorhandene Verbindung zwischen zwei Steuerelementen verwalten. Nachdem Benutzer im Menü "Verben" eines Steuerelements auf das WebPart Verbindungs verben geklickt haben, wird die Verbindungsoberfläche angezeigt, wenn bereits eine Verbindung zwischen zwei Steuerelementen vorhanden ist, wird das Trennverb in der Nähe des unteren Rands der Benutzeroberfläche aktiviert.

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

Sie können die Eigenschaftenwerte des trennenden Verb deklarativ festlegen, indem Sie das <disconnectverb> Element zwischen dem Öffnen und Schließen von Tags eines <asp:connectionszone> Elements deklarieren. Die Eigenschaften des Verbs können auch deklarativ innerhalb des öffnenden Tags <asp:connectionszone> des Elements festgelegt werden, indem ein Attribut im Formular Property-Subpropertyhinzugefügt wird, wobei Subproperty eine Eigenschaft des WebPartVerb Objekts (z DisconnectVerb-Text. B. ). Sie können die Eigenschaften auch programmgesteuert im Formular Property.Subproperty festlegen (z DisconnectVerb.Text. B. ).

Gilt für

Siehe auch

CancelVerb

Freigeben über