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 ID 표시 단추를 클릭하여 속성 값을 표시합니다. 속성 값은 영역에 대해 선언적으로 설정된 값입니다. 영역에서 다른 CatalogPart 컨트롤을 선택하면 동일한 값이 선택될 때 각 컨트롤의 SelectedCatalogPartID 속성 값이 됩니다. 속성 값을 SelectedCatalogPartID 설정하지 않으면 기본값은 항상 현재 선택한 컨트롤에 ID 대한 속성 값입니다.

설명

SelectedCatalogPartID 속성을 사용하면 현재 선택한 CatalogPart 컨트롤에 대해 선택한 식별자를 설정할 수 있습니다. 이렇게 하면 컨트롤의 ID 속성 값이 변경되지 않으므로 이 속성을 프로그래밍 방식으로 사용할 수 있습니다. 예를 들어 현재 선택한 CatalogPart 컨트롤에서 항상 프로그래밍 방식으로 작업을 수행하려는 경우 이 속성을 사용하면 미리 설정한 알려진 값을 통해 해당 컨트롤에 액세스할 수 있습니다.

이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.

추가 정보

• ASP.NET 웹 파트 컨트롤