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