ConnectionsZone.InstructionTitle Eigenschap

Definitie

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

Hiermee haalt u de tekst op die wordt gebruikt voor een algemene beschrijving van de actie die kan worden uitgevoerd op het besturingselement consument of provider, binnen de gebruikersinterface (UI) voor het beheren van bestaande verbindingen.

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

Waarde van eigenschap

String

Een tekenreeks die de instructietitel voor de verbindingsinterface bevat. De standaardtekst is een cultuurspecifieke tekenreeks die wordt geleverd door het .NET Framework.

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van de InstructionTitle 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 InstructionTitle 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 PostcodeConsumenten en klik op het verbindingswerkwoord. In de weergave die wordt geopend voor de bestaande verbinding, moet u er rekening mee houden dat de instructietitel net onder de koptekst, boven aan de zone verbindingen, de waarde is die is toegewezen aan de InstructionTitle eigenschap in het codevoorbeeld.

Opmerkingen

De tekst in de InstructionTitle eigenschap is zichtbaar wanneer de verbindingsinterface wordt weergegeven en er al een verbinding bestaat. De tekst van de instructietitel bevindt zich net onder de koptekst (opgenomen in de HeaderText eigenschap), die boven aan de verbindingsinterface wordt gevonden. De instructietitel is een algemene beschrijving die gebruikers informeert welk type actie kan worden uitgevoerd op het besturingselement consument of provider WebPart dat deelneemt aan een bestaande verbinding. De instructietitel begint standaard met De verbindingen beheren en eindigt met de naam van het besturingselement consument of provider dat de gebruiker heeft geselecteerd door te klikken op het verbindingswoord in het menu werkwoorden.

Note

Wanneer u een aangepaste waarde aan deze eigenschap toewijst, moet u er rekening mee houden dat u tijdens het ontwerp niet weet of de gebruiker een provider of consumentenbesturingselement selecteert waarop de verbinding moet worden beheerd, zodat de titel van de aangepaste instructie algemeen genoeg moet zijn om te verwijzen naar een consument of een providerbesturingselement. De standaardwaarde van de eigenschap wordt daarentegen zodanig weergegeven dat de gebruiker dynamisch de naam toevoegt van het besturingselement consument of provider dat de gebruiker selecteert. Als u een aangepaste waarde wilt opgeven voor de eigenschap die dit gedrag nabootst, moet u deze eigenschap of methode overnemen van de ConnectionsZone klasse en deze RenderBody methode overschrijven.

U kunt de waarde van deze eigenschap declaratief instellen binnen de openingstag van het <asp:connectionszone> element door een kenmerk met de naam InstructionTitle toe te voegen en een waarde toe te wijzen. U kunt de eigenschapswaarde ook programmatisch instellen.

Van toepassing op

Zie ook