ConnectionsZone.InstructionTitle Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Mevcut bağlantıları yönetmek için bağlantı kullanıcı arabiriminde (UI) tüketici veya sağlayıcı denetiminde gerçekleştirilebilecek eylemin genel açıklaması için kullanılan metni alır veya ayarlar.

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

Özellik Değeri

String

Bağlantı kullanıcı arabirimi için yönerge başlığını içeren bir dize. Varsayılan metin, .NET Framework tarafından sağlanan kültüre özgü bir dizedir.

Örnekler

Aşağıdaki kod örneği, özelliğinin InstructionTitle bir ConnectionsZone denetimle kullanımını gösterir. Örnek yalnızca web sayfasının özelliğinin kullanımını gösteren kodu içerir; örneği çalıştırmak için gereken diğer iki kod dosyası için, sınıfa genel bakışın ConnectionsZone Örnek bölümüne bakın. Kod örneğinin dört bölümü vardır:

  • Web sayfasında görüntüleme modlarını değiştirmenizi sağlayan bir kullanıcı denetimi. Bu kodu sınıfa genel bakış sayfasından ConnectionsZone alın.

  • Posta Kodu arabiriminin kodunu içeren bir kaynak dosya ve bağlantı için sağlayıcı ve tüketici olarak davranan iki WebPart denetim. Bu kodu sınıfa genel bakış sayfasından ConnectionsZone alın.

  • Tüm denetimleri barındıran, bir öğe bildiren ve özelliğin program aracılığıyla nasıl kullanılacağını gösteren bir <asp:connectionszone> Web sayfası.

  • Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.

Web sayfası bir <asp:connectionszone> öğe bildirir ve yönteminde Page_PreRender kod özelliğine InstructionTitle bir değer atar.

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

Sayfayı bir tarayıcıda yükleyin. Görüntü Modu denetimini kullanarak bağlantı moduna geçin. Posta Kodu Tüketici denetiminde fiiller menü okuna tıklayın ve bağlan fiiline tıklayın. Var olan bağlantı için açılan görünümde, bağlantı bölgesinin üst kısmındaki üst bilgi metninin hemen altındaki yönerge başlığının kod örneğindeki özelliğe atanan InstructionTitle değer olduğuna dikkat edin.

Açıklamalar

Bağlantı kullanıcı arabirimi görüntülendiğinde ve bir bağlantı zaten mevcut olduğunda özelliğinde InstructionTitle yer alan metin görünür. Yönerge başlığı metni, bağlantı kullanıcı arabiriminin en üstünde bulunan üst bilgi metninin (özelliğinde yer alır HeaderText ) hemen altındadır. Yönerge başlığı, kullanıcılara mevcut bir bağlantıya katılan tüketici veya sağlayıcı WebPart denetiminde ne tür eylemler gerçekleştirilebileceğini bildiren genel bir açıklamadır. Varsayılan olarak, yönerge başlığı Bağlantıları yönet ile başlar ve fiil menüsündeki bağlantı fiiline tıklayarak kullanıcının seçtiği tüketici veya sağlayıcı denetiminin adıyla biter.

Not

Bu özelliğe özel bir değer atadığınızda, tasarım zamanında kullanıcının bağlantıyı yöneteceği sağlayıcıyı mı yoksa tüketici denetimini mi seçeceğini bilmediğinizi unutmayın; bu nedenle özel yönerge başlığı bir tüketiciye veya sağlayıcı denetimine başvuracak kadar genel olmalıdır. Buna karşılık, özelliğin varsayılan değeri, kullanıcının seçtiği tüketici veya sağlayıcı denetiminin adını dinamik olarak ekleyebilecek şekilde işlenir. Bu davranışı taklit eden özellik için özel bir değer sağlamak istiyorsanız, sınıfından ConnectionsZone devralmanız ve bu özelliği veya RenderBody yöntemini geçersiz kılmanız gerekir.

adlı InstructionTitle bir öznitelik ekleyerek ve ona bir değer atayarak, bu özelliğin <asp:connectionszone> değerini öğenin açılış etiketi içinde bildirimli olarak ayarlayabilirsiniz. Özellik değerini program aracılığıyla da ayarlayabilirsiniz.

Şunlara uygulanır

Ayrıca bkz.