ListControl 클래스

정의

모든 목록 형식 컨트롤의 공용 속성, 메서드 및 이벤트를 정의하는 추상적인 기본 클래스로 사용됩니다.Serves as the abstract base class that defines the properties, methods, and events common for all list-type controls.

public ref class ListControl abstract : System::Web::UI::WebControls::DataBoundControl, System::Web::UI::IEditableTextControl
[System.Web.UI.ControlValueProperty("SelectedValue")]
public abstract class ListControl : System.Web.UI.WebControls.DataBoundControl, System.Web.UI.IEditableTextControl
type ListControl = class
    inherit DataBoundControl
    interface IEditableTextControl
    interface ITextControl
Public MustInherit Class ListControl
Inherits DataBoundControl
Implements IEditableTextControl
상속
ListControl
파생
특성
구현

예제

다음 코드 예제에서 항목을 선택 하는 방법에 설명 된 ListBox 제어 합니다.The following code example demonstrates how to select items in a ListBox control. 텍스트 상자에 항목이 있으면 항목을 선택 및 선택된 된 항목의 이름을 나타내는 메시지가 표시 됩니다.If the item is found in the text box, the item is selected and a message is displayed stating the name of the selected item. 항목이 없는 경우 항목이 선택 되 고 항목을 찾지 못했음을 알리는 메시지가 표시 됩니다.If the item is not found, no item is selected and a message is displayed stating that the item was not found.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다.This example has a text box that accepts user input, which is a potential security threat. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 자세한 내용은 Script Exploits Overview를 참조하세요.For more information, see Script Exploits Overview.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" > 

<head runat="server">
    <title> ListControl SelectedValue Example </title>
<script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }
             
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> ListControl SelectedValue Example </h3>
 
      <asp:ListBox ID="List"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>

      </asp:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" > 

<head runat="server">
    <title> ListControl SelectedValue Example </title>
<script runat="server">

      Sub Button_Click(sender As Object, e As EventArgs)

         ' Perform this operation in a try-catch block in case the item is not found.
         Try
   
            List.SelectedValue = ItemTextBox.Text
            MessageLabel.Text = "You selected " & List.SelectedValue + "."
        
         Catch ex As Exception
     
            List.SelectedValue = Nothing         
            MessageLabel.Text = "Item not found in ListBox control."
     
         End Try
             
      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> ListControl SelectedValue Example </h3>
 
      <asp:ListBox ID="List"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>

      </asp:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>

설명

인스턴스는 ListControl 추상 클래스를 직접 만들 수 없습니다.An instance of the ListControl abstract class cannot be created directly. 대신이 클래스를 상속 다른 클래스와 같은 합니다 CheckBoxList, DropDownListListBox, 및 RadioButtonList 클래스와 기본 공통 기능을 제공 합니다.Instead, this class is inherited by other classes, such as the CheckBoxList, DropDownList, ListBox, and RadioButtonList classes, to provide common basic functionality.

속성을 ListControl 클래스를 허용 목록 컨트롤을 채우는 데이터의 원본을 지정할 수 있습니다.The properties of the ListControl class allow you to specify the source of the data to populate the list control. 사용 된 DataSource 속성 목록 컨트롤에 바인딩할 데이터 소스를 지정 합니다.Use the DataSource property to specify the data source to bind to the list control. 데이터 원본에 둘 이상의 테이블을 사용 하 여는 DataMember 속성을 사용 하 여 테이블을 지정 합니다.If the data source contains more than one table, use the DataMember property to specify the table to use. 데이터 원본의 다른 필드에 바인딩할 수 있습니다 합니다 ListItem.TextListItem.Value 설정 하 여 목록 컨트롤에서 항목의 속성을 DataTextFieldDataValueField 속성을 각각.You can bind different fields in the data source to the ListItem.Text and ListItem.Value properties of the items in the list control by setting the DataTextField and DataValueField properties, respectively. 설정 하 여 서식이 지정 하 여 목록 컨트롤의 각 항목 수에 대해 표시 되는 텍스트를 DataTextFormatString 속성입니다.The text displayed for each item in the list control can by formatted by setting the DataTextFormatString property.

목록 컨트롤에 표시 된 모든 항목에 저장 되는 Items 컬렉션입니다.All items displayed in the list control are stored in the Items collection. 프로그래밍 방식으로 지정 하거나 사용 하 여 목록 컨트롤에서 선택한 항목의 인덱스를 확인할 수 있습니다는 SelectedIndex 속성입니다.You can programmatically specify or determine the index of a selected item in the list control by using the SelectedIndex property. 선택한 항목의 속성을 사용 하 여 액세스할 수 있습니다는 SelectedItem 속성입니다.The properties of the selected item can be accessed by using the SelectedItem property.

합니다 ListControl 클래스를 제공 합니다 SelectedIndexChanged 목록 컨트롤에서 선택한 서버 게시물 간에 변경 될 때 발생 하는 이벤트입니다.The ListControl class provides the SelectedIndexChanged event, which is raised when the selection in the list control changes between posts to the server. 이렇게 하면이 이벤트에 대 한 사용자 지정 처리기를 제공할 수 있습니다.This allows you to provide a custom handler for this event. 이벤트를 처리 하는 방법에 대 한 자세한 내용은 참조 하세요. 이벤트 처리 및 발생합니다.For more information about how to handle events, see Handling and Raising Events.

ListControl 구현 클래스는 IEditableTextControl 다른 컨트롤의 템플릿 모드에서 사용할 수 있도록 목록 형식 컨트롤을 파생 하는 인터페이스입니다.The ListControl class implements the IEditableTextControl interface so that derived list-type controls can be used in the template mode of other controls.

생성자

ListControl()

ListControl 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ListControl class.

속성

AccessKey

웹 서버 컨트롤을 빠르게 탐색할 수 있는 선택키를 가져오거나 설정합니다.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(다음에서 상속됨 WebControl)
Adapter

컨트롤에 대한 브라우저별 어댑터를 가져옵니다.Gets the browser-specific adapter for the control.

(다음에서 상속됨 Control)
AppendDataBoundItems

데이터 바인딩 전에 목록 항목이 지워지는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether list items are cleared before data binding.

AppRelativeTemplateSourceDirectory

이 컨트롤이 포함된 Page 또는 UserControl 개체의 애플리케이션 상대 가상 디렉터리를 가져오거나 설정합니다.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(다음에서 상속됨 Control)
Attributes

컨트롤의 속성과 일치하지 않는 임의의 특성(렌더링하는 경우에만 해당)의 컬렉션을 가져옵니다.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(다음에서 상속됨 WebControl)
AutoPostBack

사용자가 목록 선택을 변경할 때 해당 내용을 서버에 자동으로 게시할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.

BackColor

웹 서버 컨트롤의 배경색을 가져오거나 설정합니다.Gets or sets the background color of the Web server control.

(다음에서 상속됨 WebControl)
BindingContainer

이 컨트롤의 데이터 바인딩이 포함된 컨트롤을 가져옵니다.Gets the control that contains this control's data binding.

(다음에서 상속됨 Control)
BorderColor

웹 컨트롤의 테두리 색을 가져오거나 설정합니다.Gets or sets the border color of the Web control.

(다음에서 상속됨 WebControl)
BorderStyle

웹 서버 컨트롤의 테두리 스타일을 가져오거나 설정합니다.Gets or sets the border style of the Web server control.

(다음에서 상속됨 WebControl)
BorderWidth

웹 서버 컨트롤의 테두리 너비를 가져오거나 설정합니다.Gets or sets the border width of the Web server control.

(다음에서 상속됨 WebControl)
CausesValidation

ListControl 클래스에서 파생된 컨트롤을 클릭할 때 유효성 검사를 수행할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether validation is performed when a control that is derived from the ListControl class is clicked.

ChildControlsCreated

서버 컨트롤의 자식 컨트롤이 만들어졌는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the server control's child controls have been created.

(다음에서 상속됨 Control)
ClientID

ASP.NET에서 생성하는 HTML 태그의 컨트롤 ID를 가져옵니다.Gets the control ID for HTML markup that is generated by ASP.NET.

(다음에서 상속됨 Control)
ClientIDMode

ClientID 속성의 값을 생성하는 데 사용되는 알고리즘을 가져오거나 설정합니다.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(다음에서 상속됨 Control)
ClientIDSeparator

ClientID 속성에 사용된 구분 문자를 나타내는 문자 값을 가져옵니다.Gets a character value representing the separator character used in the ClientID property.

(다음에서 상속됨 Control)
Context

현재 웹 요청에 대한 서버 컨트롤과 관련된 HttpContext 개체를 가져옵니다.Gets the HttpContext object associated with the server control for the current Web request.

(다음에서 상속됨 Control)
Controls

UI 계층 구조에서 지정된 서버 컨트롤의 자식 컨트롤을 나타내는 ControlCollection 개체를 가져옵니다.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(다음에서 상속됨 Control)
ControlStyle

웹 서버 컨트롤의 스타일을 가져옵니다.Gets the style of the Web server control. 이 속성은 주로 컨트롤 개발자가 사용합니다.This property is used primarily by control developers.

(다음에서 상속됨 WebControl)
ControlStyleCreated

Style 개체가 ControlStyle 속성에 대해 만들어졌는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether a Style object has been created for the ControlStyle property. 이 속성은 주로 컨트롤 개발자가 사용합니다.This property is primarily used by control developers.

(다음에서 상속됨 WebControl)
CssClass

클라이언트의 웹 서버 컨트롤에서 렌더링한 CSS 스타일시트 클래스를 가져오거나 설정합니다.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(다음에서 상속됨 WebControl)
DataItemContainer

명명 컨테이너가 IDataItemContainer를 구현할 경우 명명 컨테이너에 대한 참조를 가져옵니다.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(다음에서 상속됨 Control)
DataKeysContainer

명명 컨테이너가 IDataKeysControl를 구현할 경우 명명 컨테이너에 대한 참조를 가져옵니다.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(다음에서 상속됨 Control)
DataMember

컨트롤에 바인딩할 DataSource의 특정 테이블을 가져오거나 설정합니다.Gets or sets the specific table in the DataSource to bind to the control.

DataSource

목록 컨트롤의 항목을 채울 데이터 소스를 가져오거나 설정합니다.Gets or sets the data source that populates the items of the list control.

DataTextField

목록 항목의 텍스트 내용을 제공하는 데이터 소스 필드를 가져오거나 설정합니다.Gets or sets the field of the data source that provides the text content of the list items.

DataTextFormatString

목록 컨트롤에 바인딩된 데이터를 표시하는 방법을 제어하는 데 사용되는 서식 지정 문자열을 가져오거나 설정합니다.Gets or sets the formatting string used to control how data bound to the list control is displayed.

DataValueField

각 목록 항목의 값을 제공하는 데이터 소스 필드를 가져오거나 설정합니다.Gets or sets the field of the data source that provides the value of each list item.

DesignMode

디자인 화면에서 컨트롤이 사용 중인지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether a control is being used on a design surface.

(다음에서 상속됨 Control)
Enabled

웹 서버 컨트롤이 활성화되어 있는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the Web server control is enabled.

(다음에서 상속됨 WebControl)
EnableTheming

이 컨트롤에 테마를 적용할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether themes apply to this control.

(다음에서 상속됨 WebControl)
EnableViewState

서버 컨트롤이 해당 뷰 상태와 포함하고 있는 모든 자식 컨트롤의 뷰 상태를, 요청하는 클라이언트까지 유지하는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(다음에서 상속됨 Control)
Events

컨트롤에 대한 이벤트 처리기 대리자의 목록을 가져옵니다.Gets a list of event handler delegates for the control. 이 속성은 읽기 전용입니다.This property is read-only.

(다음에서 상속됨 Control)
Font

웹 서버 컨트롤과 연결된 글꼴 속성을 가져옵니다.Gets the font properties associated with the Web server control.

(다음에서 상속됨 WebControl)
ForeColor

웹 서버 컨트롤의 전경색(보통 텍스트 색)을 가져오거나 설정합니다.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(다음에서 상속됨 WebControl)
HasAttributes

컨트롤에 특성 집합이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the control has attributes set.

(다음에서 상속됨 WebControl)
HasChildViewState

현재 서버 컨트롤의 자식 컨트롤에 저장된 뷰 상태 설정 값이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(다음에서 상속됨 Control)
Height

웹 서버 컨트롤의 높이를 가져오거나 설정합니다.Gets or sets the height of the Web server control.

(다음에서 상속됨 WebControl)
ID

서버 컨트롤에 할당된 프로그래밍 ID를 가져오거나 설정합니다.Gets or sets the programmatic identifier assigned to the server control.

(다음에서 상속됨 Control)
IdSeparator

컨트롤 식별자를 구분하는 데 사용되는 문자를 가져옵니다.Gets the character used to separate control identifiers.

(다음에서 상속됨 Control)
IsChildControlStateCleared

이 컨트롤에 포함된 컨트롤이 컨트롤 상태를 가지는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether controls contained within this control have control state.

(다음에서 상속됨 Control)
IsEnabled

컨트롤을 사용할 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the control is enabled.

(다음에서 상속됨 WebControl)
IsTrackingViewState

서버 컨트롤에서 해당 뷰 상태의 변경 사항을 저장하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the server control is saving changes to its view state.

(다음에서 상속됨 Control)
IsViewStateEnabled

이 컨트롤의 뷰 상태를 사용할 수 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether view state is enabled for this control.

(다음에서 상속됨 Control)
Items

목록 컨트롤에 있는 항목의 컬렉션을 가져옵니다.Gets the collection of items in the list control.

LoadViewStateByID

인덱스 대신 ID별로 뷰 상태를 로드할 때 컨트롤이 참여하는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(다음에서 상속됨 Control)
NamingContainer

동일한 ID 속성 값을 사용하는 서버 컨트롤을 구별하기 위해 고유의 네임스페이스를 만드는 서버 컨트롤의 명명 컨테이너에 대한 참조를 가져옵니다.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(다음에서 상속됨 Control)
Page

서버 컨트롤이 들어 있는 Page 인스턴스에 대한 참조를 가져옵니다.Gets a reference to the Page instance that contains the server control.

(다음에서 상속됨 Control)
Parent

페이지 컨트롤 계층 구조에서 서버 컨트롤의 부모 컨트롤에 대한 참조를 가져옵니다.Gets a reference to the server control's parent control in the page control hierarchy.

(다음에서 상속됨 Control)
RenderingCompatibility

렌더링된 HTML이 호환될 ASP.NET 버전을 지정하는 값을 가져옵니다.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(다음에서 상속됨 Control)
SelectedIndex

목록에서 선택한 항목의 최저 서수 인덱스를 가져오거나 설정합니다.Gets or sets the lowest ordinal index of the selected items in the list.

SelectedItem

목록 컨트롤에서 선택한 최저 인덱스 항목을 가져옵니다.Gets the selected item with the lowest index in the list control.

SelectedValue

목록 컨트롤에서 선택한 항목의 값을 가져오거나, 지정된 값이 포함된 목록 컨트롤에서 항목을 선택합니다.Gets the value of the selected item in the list control, or selects the item in the list control that contains the specified value.

Site

디자인 화면에서 렌더링될 때 현재 컨트롤을 호스팅하는 컨테이너 관련 정보를 가져옵니다.Gets information about the container that hosts the current control when rendered on a design surface.

(다음에서 상속됨 Control)
SkinID

컨트롤에 적용할 스킨을 가져오거나 설정합니다.Gets or sets the skin to apply to the control.

(다음에서 상속됨 WebControl)
Style

웹 서버 컨트롤의 외부 태그에서 스타일 특성으로 렌더링할 텍스트 특성의 컬렉션을 가져옵니다.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(다음에서 상속됨 WebControl)
SupportsDisabledAttribute

컨트롤의 IsEnabled 속성이 false인 경우 컨트롤이 렌더링된 HTML 요소의 disabled 특성을 "disabled"로 설정할지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(다음에서 상속됨 WebControl)
TabIndex

웹 서버 컨트롤의 탭 인덱스를 가져오거나 설정합니다.Gets or sets the tab index of the Web server control.

(다음에서 상속됨 WebControl)
TagKey

HtmlTextWriterTag 컨트롤에 대한 ListControl 값을 가져옵니다.Gets the HtmlTextWriterTag value for the ListControl control.

TagName

컨트롤 태그의 이름을 가져옵니다.Gets the name of the control tag. 이 속성은 주로 컨트롤 개발자가 사용합니다.This property is used primarily by control developers.

(다음에서 상속됨 WebControl)
TemplateControl

이 컨트롤이 포함된 템플릿의 참조를 가져오거나 설정합니다.Gets or sets a reference to the template that contains this control.

(다음에서 상속됨 Control)
TemplateSourceDirectory

Page 또는 현재 서버 컨트롤이 들어 있는 UserControl의 가상 디렉터리를 가져옵니다.Gets the virtual directory of the Page or UserControl that contains the current server control.

(다음에서 상속됨 Control)
Text

ListControl 컨트롤의 SelectedValue 속성을 가져오거나 설정합니다.Gets or sets the SelectedValue property of the ListControl control.

ToolTip

마우스 포인터를 웹 서버 컨트롤 위로 가져갈 때 표시되는 텍스트를 가져오거나 설정합니다.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(다음에서 상속됨 WebControl)
UniqueID

서버 컨트롤에 대해 계층적으로 정규화된 고유 식별자를 가져옵니다.Gets the unique, hierarchically qualified identifier for the server control.

(다음에서 상속됨 Control)
ValidateRequestMode

잠재적으로 위험한 값이 있는지 확인하기 위해 컨트롤에서 브라우저의 클라이언트 입력을 검사하는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(다음에서 상속됨 Control)
ValidationGroup

서버에 포스트백될 때 ListControl 클래스에서 파생된 컨트롤에서 유효성 검사를 수행할 컨트롤 그룹을 가져오거나 설정합니다.Gets or sets the group of controls for which the control that is derived from the ListControl class causes validation when it posts back to the server.

ViewState

같은 페이지에 대한 여러 개의 요청 전반에 서버 컨트롤의 뷰 상태를 저장하고 복원할 수 있도록 하는 상태 정보 사전을 가져옵니다.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(다음에서 상속됨 Control)
ViewStateIgnoresCase

StateBag 개체가 대/소문자를 구분하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the StateBag object is case-insensitive.

(다음에서 상속됨 Control)
ViewStateMode

이 컨트롤의 뷰 상태 모드를 가져오거나 설정합니다.Gets or sets the view-state mode of this control.

(다음에서 상속됨 Control)
Visible

페이지에서 서버 컨트롤이 UI로 렌더링되는지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(다음에서 상속됨 Control)
Width

웹 서버 컨트롤의 너비를 가져오거나 설정합니다.Gets or sets the width of the Web server control.

(다음에서 상속됨 WebControl)

메서드

AddAttributesToRender(HtmlTextWriter)

렌더링할 HTML 특성 및 스타일을 지정된 HtmlTextWriter 개체에 적용합니다.Applies HTML attributes and styles to render to the specified HtmlTextWriter object.

AddedControl(Control, Int32)

자식 컨트롤이 Control 개체의 Controls 컬렉션에 추가된 후 호출됩니다.Called after a child control is added to the Controls collection of the Control object.

(다음에서 상속됨 Control)
AddParsedSubObject(Object)

XML 또는 HTML 요소가 구문 분석되었음을 서버 컨트롤에 알리고 서버 컨트롤의 ControlCollection 개체에 요소를 추가합니다.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(다음에서 상속됨 Control)
ApplyStyle(Style)

지정된 스타일의 비어 있지 않은 요소를 웹 컨트롤에 복사하고 컨트롤의 기존 스타일 요소를 덮어씁니다.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. 이 메서드는 주로 컨트롤 개발자가 사용합니다.This method is primarily used by control developers.

(다음에서 상속됨 WebControl)
ApplyStyleSheetSkin(Page)

페이지 스타일시트에 정의된 스타일 속성을 컨트롤에 적용합니다.Applies the style properties defined in the page style sheet to the control.

(다음에서 상속됨 Control)
BeginRenderTracing(TextWriter, Object)

렌더링 데이터의 디자인 타임 추적을 시작합니다.Begins design-time tracing of rendering data.

(다음에서 상속됨 Control)
BuildProfileTree(String, Boolean)

서버 컨트롤에 대한 정보를 수집하고, 페이지에 대해 추적이 활성화된 경우 표시할 Trace 속성에 이 정보를 전달합니다.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(다음에서 상속됨 Control)
ClearCachedClientID()

캐시된 ClientID 값을 null로 설정합니다.Sets the cached ClientID value to null.

(다음에서 상속됨 Control)
ClearChildControlState()

서버 컨트롤의 자식 컨트롤에 대한 컨트롤 상태 정보를 삭제합니다.Deletes the control-state information for the server control's child controls.

(다음에서 상속됨 Control)
ClearChildState()

서버 컨트롤의 모든 자식 컨트롤에 대한 뷰 상태 정보와 컨트롤 상태 정보를 삭제합니다.Deletes the view-state and control-state information for all the server control's child controls.

(다음에서 상속됨 Control)
ClearChildViewState()

서버 컨트롤의 모든 자식 컨트롤에 대한 뷰 상태 정보를 삭제합니다.Deletes the view-state information for all the server control's child controls.

(다음에서 상속됨 Control)
ClearEffectiveClientIDMode()

현재 컨트롤 인스턴스 및 자식 컨트롤의 ClientIDMode 속성을 Inherit로 설정합니다.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(다음에서 상속됨 Control)
ClearSelection()

목록 선택을 지우고 모든 항목의 Selected 속성을 false로 설정합니다.Clears out the list selection and sets the Selected property of all items to false.

CopyBaseAttributes(WebControl)

Style 개체에 캡슐화하지 않은 속성을 지정된 웹 서버 컨트롤에서 이 메서드가 호출된 원본 웹 서버 컨트롤에 복사합니다.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. 이 메서드는 주로 컨트롤 개발자에 의해 사용됩니다.This method is used primarily by control developers.

(다음에서 상속됨 WebControl)
CreateChildControls()

다시 게시 또는 렌더링하기 위한 준비 작업으로, 포함된 자식 컨트롤을 만들도록 컴퍼지션 기반 구현을 사용하는 서버 컨트롤에 알리기 위해 ASP.NET 페이지 프레임워크에 의해 호출됩니다.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(다음에서 상속됨 Control)
CreateControlCollection()

서버 컨트롤의 자식 컨트롤(리터럴 및 서버)을 보유할 새 ControlCollection 개체를 만듭니다.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(다음에서 상속됨 Control)
CreateControlStyle()

WebControl 클래스에서 모든 스타일 관련 속성을 구현하기 위해 내부적으로 사용되는 스타일 개체를 만듭니다.Creates the style object that is used internally by the WebControl class to implement all style related properties. 이 메서드는 주로 컨트롤 개발자에 의해 사용됩니다.This method is used primarily by control developers.

(다음에서 상속됨 WebControl)
DataBind()

호출된 서버 컨트롤과 그 자식 컨트롤 모두에 데이터 소스를 바인딩합니다.Binds a data source to the invoked server control and all its child controls.

(다음에서 상속됨 Control)
DataBind(Boolean)

DataBinding 이벤트를 발생시키는 옵션을 사용하여, 호출된 서버 컨트롤과 모든 자식 컨트롤에 데이터 소스를 바인딩합니다.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(다음에서 상속됨 Control)
DataBindChildren()

데이터 소스를 서버 컨트롤의 자식 컨트롤에 바인딩합니다.Binds a data source to the server control's child controls.

(다음에서 상속됨 Control)
Dispose()

서버 컨트롤이 메모리에서 해제되기 전에 해당 서버 컨트롤에서 최종 정리 작업을 수행하도록 합니다.Enables a server control to perform final clean up before it is released from memory.

(다음에서 상속됨 Control)
EndRenderTracing(TextWriter, Object)

렌더링 데이터의 디자인 타임 추적을 종료합니다.Ends design-time tracing of rendering data.

(다음에서 상속됨 Control)
EnsureChildControls()

서버 컨트롤에 자식 컨트롤이 있는지 확인합니다.Determines whether the server control contains child controls. 서버 컨트롤에 자식 컨트롤이 없으면 자식 컨트롤을 만듭니다.If it does not, it creates child controls.

(다음에서 상속됨 Control)
EnsureID()

ID가 할당되지 않은 컨트롤의 ID를 만듭니다.Creates an identifier for controls that do not have an identifier assigned.

(다음에서 상속됨 Control)
Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
FindControl(String)

지정된 id 매개 변수를 사용하여 서버 컨트롤의 현재 명명 컨테이너를 검색합니다.Searches the current naming container for a server control with the specified id parameter.

(다음에서 상속됨 Control)
FindControl(String, Int32)

현재 명명 컨테이너에서 특정 id와 함께 pathOffset 매개 변수에 지정된 검색용 정수를 사용하여 서버 컨트롤을 검색합니다.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. 이 버전의 FindControl 메서드를 재정의해서는 안됩니다.You should not override this version of the FindControl method.

(다음에서 상속됨 Control)
Focus()

컨트롤에 입력 포커스를 설정합니다.Sets input focus to a control.

(다음에서 상속됨 Control)
GetDesignModeState()

컨트롤의 디자인 타임 데이터를 가져옵니다.Gets design-time data for a control.

(다음에서 상속됨 Control)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetRouteUrl(Object)

루트 매개 변수 집합에 해당하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters.

(다음에서 상속됨 Control)
GetRouteUrl(RouteValueDictionary)

루트 매개 변수 집합에 해당하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters.

(다음에서 상속됨 Control)
GetRouteUrl(String, Object)

루트 매개 변수 집합 및 루트 이름에 해당하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters and a route name.

(다음에서 상속됨 Control)
GetRouteUrl(String, RouteValueDictionary)

루트 매개 변수 집합 및 루트 이름에 해당하는 URL을 가져옵니다.Gets the URL that corresponds to a set of route parameters and a route name.

(다음에서 상속됨 Control)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
GetUniqueIDRelativeTo(Control)

지정된 컨트롤의 UniqueID 속성에서 접두사 부분을 반환합니다.Returns the prefixed portion of the UniqueID property of the specified control.

(다음에서 상속됨 Control)
HasControls()

서버 컨트롤에 자식 컨트롤이 있는지 확인합니다.Determines if the server control contains any child controls.

(다음에서 상속됨 Control)
HasEvents()

이벤트가 컨트롤이나 자식 컨트롤에 등록되었는지 여부를 나타내는 값을 반환합니다.Returns a value indicating whether events are registered for the control or any child controls.

(다음에서 상속됨 Control)
IsLiteralContent()

서버 컨트롤에 리터럴 내용만 저장되어 있는지 확인합니다.Determines if the server control holds only literal content.

(다음에서 상속됨 Control)
LoadControlState(Object)

SaveControlState() 메서드에서 저장한 이전 페이지 요청에서 컨트롤 상태 정보를 복원합니다.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(다음에서 상속됨 Control)
LoadViewState(Object)

이전에 저장된 DetailsView 컨트롤의 뷰 상태를 로드합니다.Loads the previously saved view state of the DetailsView control.

MapPathSecure(String)

가상 경로(절대 또는 상대)가 매핑되는 실제 경로를 가져옵니다.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(다음에서 상속됨 Control)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
MergeStyle(Style)

지정된 스타일의 비어 있지 않은 요소를 웹 컨트롤에 복사하지만 컨트롤의 기존 요소를 덮어쓰지 않습니다.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. 이 메서드는 주로 컨트롤 개발자에 의해 사용됩니다.This method is used primarily by control developers.

(다음에서 상속됨 WebControl)
OnBubbleEvent(Object, EventArgs)

서버 컨트롤의 이벤트가 페이지의 UI 서버 컨트롤 계층 구조에 전달되었는지 여부를 확인합니다.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(다음에서 상속됨 Control)
OnDataBinding(EventArgs)

DataBinding 이벤트를 발생시킵니다.Raises the DataBinding event.

OnInit(EventArgs)

Init 이벤트를 발생시킵니다.Raises the Init event.

(다음에서 상속됨 Control)
OnLoad(EventArgs)

Load 이벤트를 발생시킵니다.Raises the Load event.

(다음에서 상속됨 Control)
OnPreRender(EventArgs)

PreRender 이벤트를 발생시킵니다.Raises the PreRender event.

OnSelectedIndexChanged(EventArgs)

SelectedIndexChanged 이벤트를 발생시킵니다.Raises the SelectedIndexChanged event. 이를 통해 이벤트에 대한 사용자 지정 처리기를 제공할 수 있습니다.This allows you to provide a custom handler for the event.

OnTextChanged(EventArgs)

TextChanged 이벤트를 발생시킵니다.Raises the TextChanged event.

OnUnload(EventArgs)

Unload 이벤트를 발생시킵니다.Raises the Unload event.

(다음에서 상속됨 Control)
OpenFile(String)

파일을 읽는 데 사용되는 Stream을 가져옵니다.Gets a Stream used to read a file.

(다음에서 상속됨 Control)
PerformDataBinding(IEnumerable)

지정된 데이터 소스를 ListControl 클래스에서 파생된 컨트롤에 바인딩합니다.Binds the specified data source to the control that is derived from the ListControl class.

PerformSelect()

연결된 데이터 원본에서 데이터를 검색합니다.Retrieves data from the associated data source.

RaiseBubbleEvent(Object, EventArgs)

이벤트 소스와 해당 정보를 컨트롤의 부모 컨트롤에 할당합니다.Assigns any sources of the event and its information to the control's parent.

(다음에서 상속됨 Control)
RemovedControl(Control)

자식 컨트롤이 Control 개체의 Controls 컬렉션에서 제거된 후 호출됩니다.Called after a child control is removed from the Controls collection of the Control object.

(다음에서 상속됨 Control)
Render(HtmlTextWriter)

이 컨트롤을 지정된 HTML 작성기에 렌더링합니다.Renders the control to the specified HTML writer.

(다음에서 상속됨 WebControl)
RenderBeginTag(HtmlTextWriter)

지정된 작성기에 컨트롤의 HTML 여는 태그를 렌더링합니다.Renders the HTML opening tag of the control to the specified writer. 이 메서드는 주로 컨트롤 개발자에 의해 사용됩니다.This method is used primarily by control developers.

(다음에서 상속됨 WebControl)
RenderChildren(HtmlTextWriter)

클라이언트에 렌더링할 콘텐츠를 쓰는 지정된 HtmlTextWriter 개체에 서버 컨트롤의 자식 컨트롤 콘텐츠를 출력합니다.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(다음에서 상속됨 Control)
RenderContents(HtmlTextWriter)

ListControl 컨트롤의 항목을 렌더링합니다.Renders the items in the ListControl control.

RenderControl(HtmlTextWriter)

제공된 HtmlTextWriter 개체로 서버 컨트롤 콘텐츠를 출력하고 추적을 사용하는 경우 컨트롤에 대한 추적 정보를 저장합니다.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(다음에서 상속됨 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

제공된 HtmlTextWriter 개체를 사용하여 제공된 ControlAdapter 개체에 서버 컨트롤 콘텐츠를 출력합니다.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(다음에서 상속됨 Control)
RenderEndTag(HtmlTextWriter)

지정된 작성기에 컨트롤의 HTML 닫는 태그를 렌더링합니다.Renders the HTML closing tag of the control into the specified writer. 이 메서드는 주로 컨트롤 개발자에 의해 사용됩니다.This method is used primarily by control developers.

(다음에서 상속됨 WebControl)
ResolveAdapter()

지정된 컨트롤을 렌더링하는 컨트롤 어댑터를 가져옵니다.Gets the control adapter responsible for rendering the specified control.

(다음에서 상속됨 Control)
ResolveClientUrl(String)

브라우저에 사용할 수 있는 URL을 가져옵니다.Gets a URL that can be used by the browser.

(다음에서 상속됨 Control)
ResolveUrl(String)

URL을 요청 클라이언트에서 사용할 수 있는 URL로 변환합니다.Converts a URL into one that is usable on the requesting client.

(다음에서 상속됨 Control)
SaveControlState()

페이지가 서버에 다시 게시된 후 발생한 서버 컨트롤 상태의 변경을 저장합니다.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(다음에서 상속됨 Control)
SaveViewState()

ListControl 파생 컨트롤의 현재 뷰 상태와 컨트롤에 포함된 항목을 저장합니다.Saves the current view state of the ListControl -derived control and the items it contains.

SetDesignModeState(IDictionary)

컨트롤에 대한 디자인 타임 데이터를 설정합니다.Sets design-time data for a control.

(다음에서 상속됨 Control)
SetPostDataSelection(Int32)

페이지를 게시한 후 Selected 컨트롤의 ListItem 속성을 설정합니다.Sets the Selected property of a ListItem control after a page is posted.

SetRenderMethodDelegate(RenderMethod)

이벤트 처리기 대리자를 할당하여 서버 컨트롤과 그 콘텐츠를 부모 컨트롤로 렌더링합니다.Assigns an event handler delegate to render the server control and its content into its parent control.

(다음에서 상속됨 Control)
SetTraceData(Object, Object)

추적 데이터 키와 추적 데이터 값을 사용하여 렌더링 데이터의 디자인 타임 추적을 위한 추적 데이터를 설정합니다.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(다음에서 상속됨 Control)
SetTraceData(Object, Object, Object)

추적 개체, 추적 데이터 키와 추적 데이터 값을 사용하여 렌더링 데이터의 디자인 타임 추적을 위한 추적 데이터를 설정합니다.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(다음에서 상속됨 Control)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TrackViewState()

ListControl 파생 컨트롤에 대한 변경 사항의 추적 및 저장을 시작하는 시작 지점을 표시합니다.Marks the starting point to begin tracking and saving view-state changes to a ListControl -derived control.

VerifyMultiSelect()

목록 컨트롤에서 다중 선택 모드를 지원하는지 여부를 확인합니다.Determines whether the list control supports multiselection mode.

이벤트

DataBinding

서버 컨트롤에서 데이터 소스에 바인딩할 때 발생합니다.Occurs when the server control binds to a data source.

(다음에서 상속됨 Control)
Disposed

ASP.NET 페이지가 요청될 때 서버 컨트롤 주기의 마지막 단계로 서버 컨트롤이 메모리에서 해제될 때 발생합니다.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(다음에서 상속됨 Control)
Init

서버 컨트롤 주기의 첫 단계로 서버 컨트롤을 초기화할 때 이 이벤트가 발생합니다.Occurs when the server control is initialized, which is the first step in its lifecycle.

(다음에서 상속됨 Control)
Load

Page 개체에 서버 컨트롤을 로드할 때 발생합니다.Occurs when the server control is loaded into the Page object.

(다음에서 상속됨 Control)
PreRender

Control 개체가 로드된 후, 렌더링 전에 발생합니다.Occurs after the Control object is loaded but prior to rendering.

(다음에서 상속됨 Control)
SelectedIndexChanged

서버에 게시하는 동안 목록 컨트롤의 선택 사항이 변경되면 발생합니다.Occurs when the selection from the list control changes between posts to the server.

TextChanged

TextSelectedValue 속성이 변경되면 발생합니다.Occurs when the Text and SelectedValue properties change.

Unload

서버 컨트롤이 메모리에서 언로드될 때 발생합니다.Occurs when the server control is unloaded from memory.

(다음에서 상속됨 Control)

명시적 인터페이스 구현

IAttributeAccessor.GetAttribute(String)

지정한 이름이 있는 웹 컨트롤의 특성을 가져옵니다.Gets an attribute of the Web control with the specified name.

(다음에서 상속됨 WebControl)
IAttributeAccessor.SetAttribute(String, String)

웹 컨트롤의 특성을 지정한 이름과 값으로 설정합니다.Sets an attribute of the Web control to the specified name and value.

(다음에서 상속됨 WebControl)
IControlBuilderAccessor.ControlBuilder

이 멤버에 대한 설명은 ControlBuilder를 참조하세요.For a description of this member, see ControlBuilder.

(다음에서 상속됨 Control)
IControlDesignerAccessor.GetDesignModeState()

이 멤버에 대한 설명은 GetDesignModeState()를 참조하세요.For a description of this member, see GetDesignModeState().

(다음에서 상속됨 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

이 멤버에 대한 설명은 SetDesignModeState(IDictionary)를 참조하세요.For a description of this member, see SetDesignModeState(IDictionary).

(다음에서 상속됨 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

이 멤버에 대한 설명은 SetOwnerControl(Control)를 참조하세요.For a description of this member, see SetOwnerControl(Control).

(다음에서 상속됨 Control)
IControlDesignerAccessor.UserData

이 멤버에 대한 설명은 UserData를 참조하세요.For a description of this member, see UserData.

(다음에서 상속됨 Control)
IDataBindingsAccessor.DataBindings

이 멤버에 대한 설명은 DataBindings를 참조하세요.For a description of this member, see DataBindings.

(다음에서 상속됨 Control)
IDataBindingsAccessor.HasDataBindings

이 멤버에 대한 설명은 HasDataBindings를 참조하세요.For a description of this member, see HasDataBindings.

(다음에서 상속됨 Control)
IExpressionsAccessor.Expressions

이 멤버에 대한 설명은 Expressions를 참조하세요.For a description of this member, see Expressions.

(다음에서 상속됨 Control)
IExpressionsAccessor.HasExpressions

이 멤버에 대한 설명은 HasExpressions를 참조하세요.For a description of this member, see HasExpressions.

(다음에서 상속됨 Control)
IParserAccessor.AddParsedSubObject(Object)

이 멤버에 대한 설명은 AddParsedSubObject(Object)를 참조하세요.For a description of this member, see AddParsedSubObject(Object).

(다음에서 상속됨 Control)

확장 메서드

FindDataSourceControl(Control)

지정된 컨트롤에 대한 데이터 컨트롤에 연결된 데이터 소스를 반환합니다.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

지정된 컨트롤의 명명 컨테이너에서 지정된 열에 대한 필드 템플릿을 반환합니다.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

상위 데이터 컨트롤에 대한 메타테이블 개체를 반환합니다.Returns the metatable object for the containing data control.

적용 대상

추가 정보