ConnectionsZone.ConnectToProviderInstructionText 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 Anweisungstext ab, der im Abschnitt der Benutzeroberfläche für Verbindungen angezeigt wird, in dem ein Anbieterverbindungspunkt ausgewählt wird, mit dem der Consumer verbunden wird.

public:
 virtual property System::String ^ ConnectToProviderInstructionText { System::String ^ get(); void set(System::String ^ value); };

public virtual string ConnectToProviderInstructionText { get; set; }

member this.ConnectToProviderInstructionText : string with get, set

Public Overridable Property ConnectToProviderInstructionText As String

Eigenschaftswert

String

Eine Zeichenfolge, die die Anweisungen zum Erstellen einer Anbieterverbindung zum Consumer enthält. Der Standardtext ist eine von .NET Framework bereitgestellte kulturspezifische Zeichenfolge.

Beispiele

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

Ein Benutzersteuerelement, mit dem Sie die 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 und zwei WebPart Steuerelemente enthält, 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 programmgesteuert verwendet wird.
Eine Erläuterung der Funktionsweise des Beispiels in einem Browser.

Die Webseite deklariert ein <asp:connectionszone> Element, und in der Page_PreRender -Methode weist der Code der ConnectToProviderInstructionText -Eigenschaft einen Wert zu.

<%@ 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 einen Browser. Wechseln Sie mit dem Anzeigemodus-Steuerelement in den Verbindungsmodus. Klicken Sie auf den Menüpfeil für Verben im Steuerelement Postleitzahlverbraucher , und klicken Sie auf das Verb verbinden. Klicken Sie auf die Schaltfläche Verbindung beenden , um die Verbindung zu beenden, und klicken Sie dann auf den Link Anbieter für den Consumer auswählen, um eine Verbindung mit herzustellen . Die Benutzeroberfläche für die Anbieterverbindung wird angezeigt, und der der Eigenschaft zugewiesene ConnectToProviderInstructionText benutzerdefinierte Text wird direkt über dem Bereich mit dem Steuerelement angezeigt, mit dem Sie einen Verbindungspunkt auf dem Anbieter für die Verbindung mit dem Consumer auswählen können.

Hinweise

Die ConnectToProviderInstructionText -Eigenschaft wird in einem bestimmten Verbindungsszenario wirksam. Wenn ein Benutzer in einem Consumer-Steuerelement auf das Verbindungsverb klickt, zeigt das ConnectionsZone Steuerelement einen Teil der Verbindungsoberfläche an, über den Benutzer einen Anbieter auswählen können. Wenn der Benutzer auf ein Verbindungsverb auf dem Anbieter geklickt hat, würde die Verbindungsoberfläche das Gegenteil tun und Informationen zum Herstellen einer Verbindung mit einem Consumer anzeigen.

Der Text in der ConnectToProviderInstructionText -Eigenschaft wird direkt über den Dropdownlistensteuerelementen angezeigt, die die verfügbaren Anbieterverbindungspunkte enthalten, mit denen ein Consumer verbunden werden kann.

Sie können diese Eigenschaft deklarativ festlegen, indem Sie das ConnectToProviderInstructionText -Attribut im öffnenden Tag des <asp:connectionszone> Elements auf einer Seite verwenden, oder Sie können die Eigenschaft programmgesteuert festlegen.

Gilt für:

Freigeben über