Freigeben über

ConnectionsZone.GetText Eigenschaft

  • Referenz

Definition

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

Ruft den im Abschnitt der Benutzeroberfläche für Verbindungen angezeigten Text ab, der dem benannten Consumer vorangestellt ist, von dem ein Anbieter Daten abruft, oder legt diesen Text fest.

public:
 virtual property System::String ^ GetText { System::String ^ get(); void set(System::String ^ value); };
public virtual string GetText { get; set; }
member this.GetText : string with get, set
Public Overridable Property GetText As String

Eigenschaftswert

String

Eine Zeichenfolge, die dem benannten Consumer in der Verbindung vorangestellt ist. Der Standardtext ist eine von .NET Framework bereitgestellte kulturspezifische Zeichenfolge.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetText 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 programmgesteuert verwenden.

  • Eine Erklärung darüber, wie das Beispiel in einem Browser funktioniert.

Die Webseite deklariert ein Element und weist dem Code in der Page_PreRender GetText Methode einen <asp:connectionszone> 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 einem Browser. Wechseln Sie zum Verbindungsmodus mithilfe des Anzeigemodus-Steuerelements . Klicken Sie auf den Menüpfeil "Verben" im POSTLEITZAHL-Verbrauchersteuerelement , und klicken Sie auf das Verbindungsverb. Suchen Sie in der Ansicht, die für die vorhandene Verbindung geöffnet wird, im Abschnitt "Anbieter" nach dem Text, der dem benannten Consumer vorangeht. Dies ist der Text, der der GetText Eigenschaft zugewiesen ist.

Hinweise

Die GetText Eigenschaft wird in einem bestimmten Verbindungsszenario wirksam. Wenn ein Benutzer auf das Connect-Verb eines Verbrauchersteuerelements klickt, zeigt das Steuerelement eine Ansicht an, mit der ConnectionsZone Benutzer eine Verbindung mit einem Anbieter herstellen können. Im Teil der Benutzeroberfläche, die Benutzern die Auswahl eines Anbieterverbindungspunkts angibt, gibt es einen Text, der dem benannten Verbraucher vorausgeht, der an der Verbindung teilnimmt. Dieser Text, der dem Verbraucher vorausgeht, ist der Text in der GetText Eigenschaft. Standardmäßig ist der Textwert "Get".

Sie können den Wert dieser Eigenschaft deklarativ innerhalb des <asp:connectionszone> Öffnentags des Elements festlegen, indem Sie ein Attribut GetText namens hinzufügen und ihm einen Wert zuweisen. Sie können auch den Eigenschaftswert programmgesteuert festlegen.

Gilt für

Siehe auch