CatalogZoneBase.SelectedCatalogPartID Свойство

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Получает или задает строку в качестве идентификатора текущего выбранного элемента управления CatalogPart в зоне.

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

[System.Web.UI.Themeable(false)]
public string SelectedCatalogPartID { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.SelectedCatalogPartID : string with get, set

Public Property SelectedCatalogPartID As String

Значение свойства

String

Строка, которая служит в качестве идентификатора для текущего выбранного элемента управления. По умолчанию используется значение свойства ID элемента управления.

Атрибуты

ThemeableAttribute

Примеры

В следующем примере кода показано, как использовать SelectedCatalogPartID свойство декларативно и программно. Полный код, необходимый для выполнения примера, см. в разделе CatalogZoneBase Пример обзора класса.

Обратите внимание, что в первой части примера кода объявляется два <asp:catalogzone> элемента, а в первом — значение для SelectedCatalogPartID свойства .

<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." />

Во второй части примера кода отображается текстовое SelectedCatalogPartID значение свойства выбранного элемента управления.

protected void Button4_Click(object sender, EventArgs e)
{
  Label1.Text = CatalogZone1.SelectedCatalogPartID;
}

Protected Sub Button4_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  Label1.Text = CatalogZone1.SelectedCatalogPartID
End Sub

При загрузке страницы в браузере можно выбрать Каталог из раскрывающегося списка, чтобы переключиться в режим отображения каталога. Когда каталог отображается, щелкните одну из ссылок на CatalogPart элемент управления, чтобы выбрать его. Затем нажмите кнопку Показать выбранный каталогИД элемента , чтобы отобразить значение свойства. Обратите внимание, что значение свойства является значением, которое было задано декларативно для зоны. При выборе других CatalogPart элементов управления в зоне то же значение становится значением SelectedCatalogPartID свойства для каждого элемента управления при его выборе. Если значение SelectedCatalogPartID свойства не задано, значением по умолчанию всегда будет значение ID свойства для выбранного в данный момент элемента управления.

Комментарии

Свойство SelectedCatalogPartID позволяет задать идентификатор выбранного CatalogPart вами элемента управления. Это не изменяет значение свойства элемента управления ID , поэтому это свойство можно использовать в собственных программных целях. Например, если вы хотите всегда выполнять некоторые программные действия с текущим выбранным CatalogPart элементом управления, это свойство позволяет получить доступ к этому элементу управления с помощью известного значения, которое вы задали заранее.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделах ThemeableAttribute и ASP.NET Темы и обложки.

См. также раздел

• элементы управления веб-частей ASP.NET