ConnectionsZone.ConnectToConsumerInstructionText Eigenschap

Definitie

Naamruimte:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt de instructietekst opgehaald of ingesteld die wordt weergegeven in de sectie van de gebruikersinterface van de verbinding waar gebruikers een consumentenaansluitpunt selecteren waarmee de provider verbinding maakt.

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

public virtual string ConnectToConsumerInstructionText { get; set; }

member this.ConnectToConsumerInstructionText : string with get, set

Public Overridable Property ConnectToConsumerInstructionText As String

Waarde van eigenschap

String

Een tekenreeks met de instructies voor het maken van een consumentenverbinding met de provider. De standaardtekst is een cultuurspecifieke tekenreeks die wordt geleverd door het .NET Framework.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de ConnectToConsumerInstructionText eigenschap met een ConnectionsZone besturingselement. Het voorbeeld bevat alleen de code voor de webpagina die het gebruik van de eigenschap demonstreert; zie de sectie Voorbeeld van het ConnectionsZone klassenoverzicht voor de andere twee codebestanden die nodig zijn om het voorbeeld uit te voeren. Het codevoorbeeld heeft vier delen:

Een gebruikersbeheer waarmee u kunt schakelen tussen weergavemodi op de webpagina. Haal deze code op uit het ConnectionsZone klassenoverzicht.
Een bronbestand dat de code voor een postcode-interface bevat en twee WebPart besturingselementen die fungeren als de provider en de consument voor een verbinding. Haal deze code op uit het ConnectionsZone klassenoverzicht.
Een webpagina waarop alle besturingselementen worden gehost, een <asp:connectionszone> element declareert en laat zien hoe u de eigenschap programmatisch gebruikt.
Een uitleg van hoe het voorbeeld werkt in een browser.

De webpagina declareert een <asp:connectionszone> element en in de Page_PreRender methode wijst de code een waarde toe aan de ConnectToConsumerInstructionText eigenschap.

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

Laad de pagina in een browser. Schakel over naar de verbindingsmodus met behulp van het besturingselement Weergavemodus . Klik op de menupijl voor werkwoorden in het besturingselement Postcodeprovider en klik op het verbindingswerkwoord. Klik op de knop Verbinding beëindigen om de verbinding te beëindigen en klik vervolgens op de knop Een consument selecteren voor de provider om verbinding te maken met de hyperlink. De gebruikersinterface voor de consumentenverbinding wordt weergegeven en de aangepaste tekst die aan de ConnectToConsumerInstructionText eigenschap is toegewezen, wordt net boven het gebied weergegeven met het besturingselement waarmee u een verbindingspunt voor de consument kunt selecteren om verbinding te maken met de provider.

Opmerkingen

De ConnectToConsumerInstructionText eigenschap wordt van kracht in een specifiek verbindingsscenario. Wanneer een gebruiker op het verbindingswerkwoord op een besturingselement van een provider klikt, wordt in het ConnectionsZone besturingselement een deel van de verbindingsinterface weergegeven waarmee gebruikers een consument kunnen selecteren. Als de gebruiker op een verbindingswerkwoord voor de consument heeft geklikt, zou de verbindingsinterface het omgekeerde doen en informatie weergeven over het maken van verbinding met een provider.

De tekst in de ConnectToConsumerInstructionText eigenschap wordt net boven de vervolgkeuzelijstbesturingselementen weergegeven die de beschikbare consumentenverbindingspunten bevatten waarmee een provider kan worden verbonden.

U kunt deze eigenschap declaratief instellen met behulp van het ConnectToConsumerInstructionText kenmerk in de openingstag van het <asp:connectionszone> element op een pagina of u kunt de eigenschap programmatisch instellen.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?