CatalogZoneBase.InstructionText Özellik

  • Başvuru

Tanım

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

Son kullanıcılar için yol tarifleri sağlayan bir bölgedeki metni alır veya ayarlar.

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

Özellik Değeri

String

Son kullanıcıların yol tariflerini içeren bir dize. Web Bölümleri denetim kümesi tarafından varsayılan, kültüre özgü bir dize sağlanır.

Örnekler

Aşağıdaki kod örneği, özelliğinin InstructionText bildirim temelli ve programlı olarak nasıl kullanılacağını gösterir. Örneği çalıştırmak için gereken kodun tamamı için, sınıfa genel bakışın CatalogZoneBase Örnek bölümüne bakın.

Kod örneğinin iki <asp:catalogzone> öğe bildirdiğini ve ilkinin özelliği için bir değer bildirdiğini InstructionText fark edin.

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode." 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          Title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

Kod örneğinin ikinci bölümünde, ilk bölgedeki özelliğin InstructionText değeri program aracılığıyla farklı bir değere atanır.

protected void Button3_Click(object sender, EventArgs e)
{
  CatalogZone1.SelectTargetZoneText = "Add to zone";
  CatalogZone1.EmptyZoneText = "Zone is empty";
  CatalogZone1.HeaderText = "My Updated Header";
  CatalogZone1.InstructionText = "My Updated Instructions";
}

Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  CatalogZone1.SelectTargetZoneText = "Add to zone"
  CatalogZone1.EmptyZoneText = "Zone is empty"
  CatalogZone1.HeaderText = "My Updated Header"
  CatalogZone1.InstructionText = "My Updated Instructions"
End Sub

Sayfayı bir tarayıcıya yüklediğinizde, katalog görüntüleme moduna geçmek için açılan listeden Katalog'u seçebilirsiniz. Katalog görünür olduğunda, her bölgenin üst bilgi alanında görüntülenen özelliğin değerine InstructionText dikkat edin. Bölge Metni Özelliklerini Ayarla düğmesine tıklayabilirsiniz ve InstructionText üst bölgenin özelliği kodda kendisine atanan değere ayarlanır.

Açıklamalar

özelliğinin InstructionText dize değeri, bir CatalogZoneBase bölgenin üst bilgi alanının hemen altında görüntülenir. Bir sayfa katalog moduna girdiğinde ve katalog kullanıcı arabirimi (UI) görünür hale geldiğinde özelliğin metni InstructionText görüntülenir.

özelliğinin InstructionText amacı, kullanıcıya katalog kullanıcı arabirimi görüntülendiğinde yapılması gerekenler hakkında genel yönergeler sağlamaktır.

Şunlara uygulanır

Ayrıca bkz.