ListViewDataItem Klasa

Definicja

Reprezentuje pojedynczy element danych w ListView kontrolce.Represents an individual data item in a ListView control.

public ref class ListViewDataItem : System::Web::UI::WebControls::ListViewItem, System::Web::UI::IDataItemContainer
public ref class ListViewDataItem : System::Web::UI::WebControls::ListViewItem
public class ListViewDataItem : System.Web.UI.WebControls.ListViewItem, System.Web.UI.IDataItemContainer
public class ListViewDataItem : System.Web.UI.WebControls.ListViewItem
type ListViewDataItem = class
    inherit ListViewItem
    interface IDataItemContainer
    interface INamingContainer
type ListViewDataItem = class
    inherit ListViewItem
Public Class ListViewDataItem
Inherits ListViewItem
Implements IDataItemContainer
Public Class ListViewDataItem
Inherits ListViewItem
Dziedziczenie
ListViewDataItem
Implementuje

Przykłady

Poniższy przykład pokazuje, jak używać ListViewDataItem obiektu do pobierania wartości pola z elementu w ListView formancie.The following example shows how to use a ListViewDataItem object to retrieve a field value from an item in the ListView control.

Ważne

Ten przykład zawiera pole tekstowe akceptujące dane wejściowe użytkownika, które jest potencjalnym zagrożeniem bezpieczeństwa.This example has a text box that accepts user input, which is a potential security threat. Domyślnie strony sieci Web ASP.NET sprawdzają, czy dane wejściowe użytkownika nie obejmują elementów skryptu ani HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach.For more information, see Script Exploits Overview.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Data" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<script runat="server">

  //<Snippet2>
  protected void ContactsListView_ItemDataBound(object sender, ListViewItemEventArgs e)
  {

    //Verify there is an item being edited.
    if (ContactsListView.EditIndex >= 0)
    {

      //Get the item object.
      ListViewDataItem dataItem = (ListViewDataItem)e.Item;

      // Check for an item in edit mode.
      if (dataItem.DisplayIndex == ContactsListView.EditIndex)
      {

        // Preselect the DropDownList control with the Title value
        // for the current item.

        // Retrieve the underlying data item. In this example
        // the underlying data item is a DataRowView object.        
        DataRowView rowView = (DataRowView)dataItem.DataItem;

        // Retrieve the Title value for the current item. 
        String title = rowView["Title"].ToString();

        // Retrieve the DropDownList control from the current row. 
        DropDownList list = (DropDownList)dataItem.FindControl("TitlesList");

        // Find the ListItem object in the DropDownList control with the 
        // title value and select the item.
        ListItem item = list.Items.FindByText(title);
        list.SelectedIndex = list.Items.IndexOf(item);
                        
      }
    }
  }
  //</Snippet2>

  void ContactsListView_ItemUpdating(Object sender, ListViewUpdateEventArgs e)
  {
      // Retrieve the row being edited.
      ListViewItem item = ContactsListView.Items[ContactsListView.EditIndex];

      // Retrieve the DropDownList control from the row.
      DropDownList list = (DropDownList)item.FindControl("TitlesList");

      // Add the selected value of the DropDownList control to 
      // the NewValues collection. The NewValues collection is
      // passed to the data source control, which then updates the 
      // data source.
      e.NewValues["Title"] = list.SelectedValue;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView DataItem Example</title>
    <link type="text/css" rel="stylesheet" href="StyleSheet.css" />
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListViewDataItem Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        OnItemUpdating="ContactsListView_ItemUpdating"         
        OnItemDataBound="ContactsListView_ItemDataBound"
        runat="server" >
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblContacts" width="640px">
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="ContactsDataPager" PageSize="12">
            <Fields>
              <asp:NextPreviousPagerField 
                ShowFirstPageButton="true" ShowLastPageButton="true"
                FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                NextPageText=" &gt; " PreviousPageText=" &lt; " />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr class="DataItem" runat="server">
            <td>
              <asp:LinkButton ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
            <td>
              <asp:Label ID="TitleLabel" runat="server" Text='<%#Eval("Title", "{0:d}") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:LinkButton ID="UpdateButton" runat="server" 
                CommandName="Update" Text="Update" /><br />
              <asp:LinkButton ID="CancelButton" runat="server" 
                CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="FirstNameLabel" 
                AssociatedControlID="FirstNameTextBox" Text="First Name:"/>
              <asp:TextBox ID="FirstNameTextBox" runat="server" 
                Text='<%#Bind("FirstName") %>' MaxLength="50" />
            </td>
            <td>
              <asp:Label runat="server" ID="LastNameLabel" 
                AssociatedControlID="LastNameTextBox" Text="Last Name:" />
              <asp:TextBox ID="LastNameTextBox" runat="server" 
                Text='<%#Bind("LastName") %>' MaxLength="50" /><br />
            </td>              
            <td>
              <asp:Label runat="server" ID="TitleLabel" 
                AssociatedControlID="TitlesList" Text="Title:"/>
              <asp:DropDownList ID="TitlesList" 
                DataSourceID="TitlesSqlDataSource" 
                DataTextField="Title"
                runat="server">
              </asp:DropDownList>
            </td>
          </tr>
        </EditItemTemplate>
      </asp:ListView>
            
      <asp:SqlDataSource ID="TitlesSqlDataSource"  
        SelectCommand="SELECT Distinct [Title] FROM Person.Contact ORDER BY [Title]"
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        runat="server">
      </asp:SqlDataSource>
              
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT [ContactID], [FirstName], [LastName], [Title] FROM Person.Contact"
            UpdateCommand="UPDATE Person.Contact
                             SET FirstName = @FirstName, LastName = @LastName, Title = @Title
                             WHERE ContactID = @ContactID">
        <UpdateParameters>
          <asp:Parameter ConvertEmptyStringToNull="true" Name="Title" />
        </UpdateParameters>                             
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Data" %>
    
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<script runat="server">
        
  '<Snippet2>
  Protected Sub ContactsListView_ItemDataBound(ByVal sender As Object, ByVal e As ListViewItemEventArgs) 
      
    'Verify there is an item being edited.
    If ContactsListView.EditIndex >= 0 Then
      
      'Get the item object.
      Dim dataItem As ListViewDataItem = CType(e.Item, ListViewDataItem)
      
      ' Check for an item in edit mode.
      If dataItem.DisplayIndex = ContactsListView.EditIndex Then
          
        ' Preselect the DropDownList control with the Title value
        ' for the current item.
        ' Retrieve the underlying data item. In this example
        ' the underlying data item is a DataRowView object.        
        Dim rowView As DataRowView = CType(dataItem.DataItem, DataRowView)
        
        ' Retrieve the Title value for the current item. 
        Dim title As String = rowView("Title").ToString()
        
        ' Retrieve the DropDownList control from the current row. 
        Dim list As DropDownList = CType(dataItem.FindControl("TitlesList"), DropDownList)
        
        ' Find the ListItem object in the DropDownList control with the 
        ' title value and select the item.
        Dim item As ListItem = list.Items.FindByText(title)
        list.SelectedIndex = list.Items.IndexOf(item)
      End If 
    End If

  End Sub
  '</Snippet2>
  
  Sub ContactsListView_ItemUpdating(ByVal sender As Object, ByVal e As ListViewUpdateEventArgs) 
  
    ' Retrieve the row being edited.
    Dim item As ListViewItem = ContactsListView.Items(ContactsListView.EditIndex)
    
    ' Retrieve the DropDownList control from the row.
    Dim list As DropDownList = CType(item.FindControl("TitlesList"), DropDownList)
    
    ' Add the selected value of the DropDownList control to 
    ' the NewValues collection. The NewValues collection is
    ' passed to the data source control, which then updates the 
    ' data source.
    e.NewValues("Title") = list.SelectedValue

  End Sub 'ContactsListView_ItemUpdating
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>ListView DataItem Example</title>
    <link type="text/css" rel="stylesheet" href="StyleSheet.css" />
  </head>
  <body>
    <form id="form1" runat="server">
        
      <h3>ListViewDataItem Example</h3>

      <asp:ListView ID="ContactsListView" 
        DataSourceID="ContactsDataSource" 
        DataKeyNames="ContactID"
        OnItemUpdating="ContactsListView_ItemUpdating"         
        OnItemDataBound="ContactsListView_ItemDataBound"
        runat="server" >
        <LayoutTemplate>
          <table cellpadding="2" runat="server" id="tblContacts" width="640px">
            <tr runat="server" id="itemPlaceholder" />
          </table>
          <asp:DataPager runat="server" ID="ContactsDataPager" PageSize="12">
            <Fields>
              <asp:NextPreviousPagerField 
                ShowFirstPageButton="true" ShowLastPageButton="true"
                FirstPageText="|&lt;&lt; " LastPageText=" &gt;&gt;|"
                NextPageText=" &gt; " PreviousPageText=" &lt; " />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr class="DataItem" runat="server">
            <td>
              <asp:LinkButton ID="EditButton" runat="server" Text="Edit" CommandName="Edit" />
            </td>
            <td>
              <asp:Label ID="FirstNameLabel" runat="server" Text='<%#Eval("FirstName") %>' />
            </td>
            <td>
              <asp:Label ID="LastNameLabel" runat="server" Text='<%#Eval("LastName") %>' />
            </td>
            <td>
              <asp:Label ID="TitleLabel" runat="server" Text='<%#Eval("Title", "{0:d}") %>' />
            </td>
          </tr>
        </ItemTemplate>
        <EditItemTemplate>
          <tr class="EditItem">
            <td>
              <asp:LinkButton ID="UpdateButton" runat="server" 
                CommandName="Update" Text="Update" /><br />
              <asp:LinkButton ID="CancelButton" runat="server" 
                CommandName="Cancel" Text="Cancel" />
            </td>
            <td>
              <asp:Label runat="server" ID="FirstNameLabel" 
                AssociatedControlID="FirstNameTextBox" Text="First Name:"/>
              <asp:TextBox ID="FirstNameTextBox" runat="server" 
                Text='<%#Bind("FirstName") %>' MaxLength="50" />
            </td>
            <td>
              <asp:Label runat="server" ID="LastNameLabel" 
                AssociatedControlID="LastNameTextBox" Text="Last Name:" />
              <asp:TextBox ID="LastNameTextBox" runat="server" 
                Text='<%#Bind("LastName") %>' MaxLength="50" /><br />
            </td>              
            <td>
              <asp:Label runat="server" ID="TitleLabel" 
                AssociatedControlID="TitlesList" Text="Title:"/>
              <asp:DropDownList ID="TitlesList" 
                DataSourceID="TitlesSqlDataSource" 
                DataTextField="Title"
                runat="server">
              </asp:DropDownList>
            </td>
          </tr>
        </EditItemTemplate>
      </asp:ListView>
            
      <asp:SqlDataSource ID="TitlesSqlDataSource"  
        SelectCommand="SELECT Distinct [Title] FROM Person.Contact ORDER BY [Title]"
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        runat="server">
      </asp:SqlDataSource>
              
      <asp:SqlDataSource ID="ContactsDataSource" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
            SelectCommand="SELECT [ContactID], [FirstName], [LastName], [Title] FROM Person.Contact"
            UpdateCommand="UPDATE Person.Contact
                             SET FirstName = @FirstName, LastName = @LastName, Title = @Title
                             WHERE ContactID = @ContactID">
        <UpdateParameters>
          <asp:Parameter ConvertEmptyStringToNull="true" Name="Title" />
        </UpdateParameters>                             
      </asp:SqlDataSource>
      
    </form>
  </body>
</html>

Uwagi

ListViewDataItemKlasa reprezentuje pojedynczy element danych w ListView kontrolce.The ListViewDataItem class represents an individual data item in a ListView control. Element danych zazwyczaj odpowiada rekordowi w obiekcie źródła danych.A data item usually corresponds to a record in a data source object. Klasa pochodzi od ListViewItem klasy.The class derives from the ListViewItem class.

Każdy element w ListView kontrolce ma wydzielony typ elementu, który jest reprezentowany przez ItemType Właściwość.Each item in the ListView control has a designated item type that is represented by the ItemType property. Gdy typ elementu to ListViewItemType.DataItem , można użyć ListViewDataItem klasy, aby uzyskać więcej informacji na temat elementu.When the item type is ListViewItemType.DataItem, you can use the ListViewDataItem class to get more information about the item.

ListViewKontrolka przechowuje elementy danych w Items kolekcji.The ListView control stores data items in the Items collection. Aby określić indeks ListViewDataItem obiektu w Items kolekcji, użyj DisplayIndex właściwości.To determine the index of a ListViewDataItem object in the Items collection, use the DisplayIndex property. Aby określić indeks elementu danych w bazowym źródle danych, należy użyć DataItemIndex właściwości.To determine the index of the data item in the underlying data source, use the DataItemIndex property. Różnica między tymi właściwościami indeksu jest DisplayIndex reprezentująca położenie elementu danych na bieżącej stronie, natomiast DataItemIndex jest oparta na przesunięciu strony.The difference between these index properties is that DisplayIndex represents the position of the data item in the current page, whereas DataItemIndex is based on the page offset. Jeśli funkcja stronicowania nie jest włączona w ListView formancie przy użyciu DataPager kontrolki, te dwie właściwości będą zawierać tę samą wartość.If the paging functionality is not enabled in the ListView control by using a DataPager control, these two properties will contain the same value.

Można uzyskać dostęp do właściwości bazowego obiektu danych przy użyciu DataItem właściwości.You can access the properties of the underlying data object by using the DataItem property.

DataItemWłaściwość jest dostępna tylko podczas i po ItemDataBound zdarzeniu ListView formantu.The DataItem property is available only during and after the ItemDataBound event of a ListView control.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia ListViewDataItem klasy, zobacz ListViewDataItem Konstruktor.For a list of initial property values for an instance of the ListViewDataItem class, see the ListViewDataItem constructor.

Konstruktory

ListViewDataItem(Int32, Int32)

Inicjuje nowe wystąpienie klasy ListViewDataItem.Initializes a new instance of the ListViewDataItem class.

Właściwości

Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.Gets the browser-specific adapter for the control.

(Odziedziczone po Control)
AppRelativeTemplateSourceDirectory

Pobiera lub ustawia katalog wirtualny względem aplikacji Page lub UserControl obiekt, który zawiera tę kontrolkę.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Odziedziczone po Control)
BindingContainer

Pobiera formant, który zawiera powiązanie danych tego formantu.Gets the control that contains this control's data binding.

(Odziedziczone po Control)
ChildControlsCreated

Pobiera wartość wskazującą, czy zostały utworzone formanty podrzędne kontrolki serwera.Gets a value that indicates whether the server control's child controls have been created.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator formantu dla znacznika HTML, który jest generowany przez ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora używany we ClientID właściwości.Gets a character value representing the separator character used in the ClientID property.

(Odziedziczone po Control)
Context

Pobiera HttpContext obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.Gets the HttpContext object associated with the server control for the current Web request.

(Odziedziczone po Control)
Controls

Pobiera ControlCollection obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Odziedziczone po Control)
DataItem

Pobiera lub ustawia obiekt danych źródłowych, z którym ListViewItem jest powiązany obiekt.Gets or sets the underlying data object that the ListViewItem object is bound to.

DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataItemContainer .Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Odziedziczone po Control)
DataItemIndex

Pobiera indeks DataItem w źródłowym obiekcie źródła danych.Gets the index of the DataItem in the underlying data source object.

DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataKeysControl .Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Odziedziczone po Control)
DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.Gets a value indicating whether a control is being used on a design surface.

(Odziedziczone po Control)
DisplayIndex

Pobiera pozycję elementu danych w postaci, w jakiej jest wyświetlany w ListView kontrolce.Gets the position of the data item as displayed in the ListView control.

EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy stosują się do tej kontrolki.Gets or sets a value indicating whether themes apply to this control.

(Odziedziczone po Control)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy formant serwera utrzymuje stan widoku, oraz stan widoku wszystkich formantów podrzędnych, które zawiera, do żądającego klienta.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.

(Odziedziczone po Control)
Events

Pobiera listę delegatów obsługi zdarzeń dla formantu.Gets a list of event handler delegates for the control. Ta właściwość jest tylko do odczytu.This property is read-only.

(Odziedziczone po Control)
HasChildViewState

Pobiera wartość wskazującą, czy bieżące kontrolki formantu serwera mają jakiekolwiek zapisane ustawienia stanu widoku.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Odziedziczone po Control)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwerowej.Gets or sets the programmatic identifier assigned to the server control.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontroli.Gets the character used to separate control identifiers.

(Odziedziczone po Control)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tym formancie mają stan kontroli.Gets a value indicating whether controls contained within this control have control state.

(Odziedziczone po Control)
IsTrackingViewState

Pobiera wartość wskazującą, czy formant serwera zapisuje zmiany w stanie widoku.Gets a value that indicates whether the server control is saving changes to its view state.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy stan widoku jest włączony dla tego formantu.Gets a value indicating whether view state is enabled for this control.

(Odziedziczone po Control)
ItemType

Pobiera typ elementu ListViewItem obiektu.Gets the item type of the ListViewItem object.

(Odziedziczone po ListViewItem)
LoadViewStateByID

Pobiera wartość wskazującą, czy formant uczestniczy w ładowaniu stanu widoku przez ID zamianę na indeks.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazw kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera z tą samą ID wartością właściwości.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.

(Odziedziczone po Control)
Page

Pobiera odwołanie do Page wystąpienia, które zawiera formant serwera.Gets a reference to the Page instance that contains the server control.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii formantów strony.Gets a reference to the server control's parent control in the page control hierarchy.

(Odziedziczone po Control)
RenderingCompatibility

Pobiera wartość określającą ASP.NET wersję, która będzie zgodna z językiem HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Odziedziczone po Control)
Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę, gdy jest renderowany na powierzchni projektowej.Gets information about the container that hosts the current control when rendered on a design surface.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórkę, która ma zostać zastosowana do kontrolki.Gets or sets the skin to apply to the control.

(Odziedziczone po Control)
TemplateControl

Pobiera lub ustawia odwołanie do szablonu, który zawiera tę kontrolkę.Gets or sets a reference to the template that contains this control.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny Page lub zawierający UserControl bieżącą kontrolkę serwerową.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Odziedziczone po Control)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator dla kontrolki serwerowej.Gets the unique, hierarchically qualified identifier for the server control.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy formant sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Odziedziczone po Control)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach na tej samej stronie.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.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy w StateBag obiekcie nie jest rozróżniana wielkość liter.Gets a value that indicates whether the StateBag object is case-insensitive.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb widoku stanu tego formantu.Gets or sets the view-state mode of this control.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Odziedziczone po Control)

Metody

AddedControl(Control, Int32)

Wywołuje się po dodaniu formantu podrzędnego do Controls kolekcji Control obiektu.Called after a child control is added to the Controls collection of the Control object.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia formant serwera o przeanalizowaniu elementu, XML lub HTML, a następnie dodaje element do obiektu formantu serwera 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.

(Odziedziczone po Control)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.Applies the style properties defined in the page style sheet to the control.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.Begins design-time tracing of rendering data.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o formancie serwera i dostarcza go do Trace właściwości, która będzie wyświetlana po włączeniu śledzenia dla strony.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość w pamięci podręcznej ClientID na null .Sets the cached ClientID value to null.

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie formantu dla kontrolek podrzędnych kontrolki serwerowej.Deletes the control-state information for the server control's child controls.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i kontroli dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state and control-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

Ustawia ClientIDMode Właściwość bieżącego wystąpienia kontrolki i wszystkich formantów podrzędnych na Inherit .Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Odziedziczone po Control)
CreateChildControls()

Wywoływane przez platformę strony ASP.NET w celu powiadomienia formantów serwera, które używają implementacji opartej na kompozycjach, do tworzenia wszelkich formantów podrzędnych, które zawierają w przygotowaniu do ponownego ogłaszania lub renderowania.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.

(Odziedziczone po Control)
CreateControlCollection()

Tworzy nowy ControlCollection obiekt do przechowywania formantów podrzędnych (zarówno literału, jak i serwera) formantu serwera.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Odziedziczone po Control)
DataBind()

Tworzy powiązanie źródła danych z wywołaną kontrolką serwera i wszystkimi jego kontrolkami podrzędnymi.Binds a data source to the invoked server control and all its child controls.

(Odziedziczone po Control)
DataBind(Boolean)

Tworzy powiązanie źródła danych z wywoływanym formantem serwera i wszystkimi jego kontrolkami podrzędnymi z opcją podniesienia poziomu DataBinding zdarzenia.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Odziedziczone po Control)
DataBindChildren()

Tworzy powiązanie źródła danych z kontrolkami podrzędnymi formantu serwera.Binds a data source to the server control's child controls.

(Odziedziczone po Control)
Dispose()

Umożliwia formantowi serwera przeprowadzenie końcowego oczyszczania przed jego zwolnieniem z pamięci.Enables a server control to perform final clean up before it is released from memory.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Przerywa śledzenie danych renderowania w czasie projektowania.Ends design-time tracing of rendering data.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy formant serwera zawiera kontrolki podrzędne.Determines whether the server control contains child controls. Jeśli tak nie jest, tworzy kontrolki podrzędne.If it does not, it creates child controls.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator dla kontrolek, które nie mają przypisanego identyfikatora.Creates an identifier for controls that do not have an identifier assigned.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określonym id parametrem.Searches the current naming container for a server control with the specified id parameter.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określoną id i liczbą całkowitą, która jest określona w pathOffset parametrze, który ułatwia wyszukiwanie.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. Nie należy przesłaniać tej wersji FindControl metody.You should not override this version of the FindControl method.

(Odziedziczone po Control)
Focus()

Ustawia fokus wprowadzania dla kontrolki.Sets input focus to a control.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.Gets design-time data for a control.

(Odziedziczone po Control)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca przedznaczoną część UniqueID właściwości określonej kontrolki.Returns the prefixed portion of the UniqueID property of the specified control.

(Odziedziczone po Control)
HasControls()

Określa, czy formant serwera zawiera wszystkie kontrolki podrzędne.Determines if the server control contains any child controls.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą czy zdarzenia są rejestrowane dla kontrolki lub wszelkich formantów podrzędnych.Returns a value indicating whether events are registered for the control or any child controls.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy formant serwera przechowuje tylko zawartość literału.Determines if the server control holds only literal content.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez SaveControlState() metodę.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Odziedziczone po Control)
LoadViewState(Object)

Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez SaveViewState() metodę.Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Odziedziczone po Control)
MapPathSecure(String)

Pobiera ścieżkę fizyczną, do której jest mapowana ścieżka wirtualna (absolutna lub względna).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnBubbleEvent(Object, EventArgs)

Określa, czy należy przekazać zdarzenie do hierarchii formantów serwera ASP.NET.Determines whether to pass an event up the page's ASP.NET server control hierarchy.

OnDataBinding(EventArgs)

Podnosi DataBinding zdarzenie.Raises the DataBinding event.

(Odziedziczone po Control)
OnInit(EventArgs)

Podnosi Init zdarzenie.Raises the Init event.

(Odziedziczone po Control)
OnLoad(EventArgs)

Podnosi Load zdarzenie.Raises the Load event.

(Odziedziczone po Control)
OnPreRender(EventArgs)

Podnosi PreRender zdarzenie.Raises the PreRender event.

(Odziedziczone po Control)
OnUnload(EventArgs)

Podnosi Unload zdarzenie.Raises the Unload event.

(Odziedziczone po Control)
OpenFile(String)

Pobiera informacje Stream używane do odczytu pliku.Gets a Stream used to read a file.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i informacje do elementu nadrzędnego formantu.Assigns any sources of the event and its information to the control's parent.

(Odziedziczone po Control)
RemovedControl(Control)

Wywoływana po usunięciu formantu podrzędnego z Controls kolekcji Control obiektu.Called after a child control is removed from the Controls collection of the Control object.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wysyła zawartość kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementu podrzędnego kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu i przechowuje informacje o śledzeniu dla kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu za pomocą podanego ControlAdapter obiektu.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Odziedziczone po Control)
ResolveAdapter()

Pobiera adapter sterowania odpowiedzialny za renderowanie określonego formantu.Gets the control adapter responsible for rendering the specified control.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.Gets a URL that can be used by the browser.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na taki, który jest używany na żądającym klienta.Converts a URL into one that is usable on the requesting client.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany stanu formantu serwera, które wystąpiły od momentu, gdy strona została opublikowana na serwerze.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Odziedziczone po Control)
SaveViewState()

Zapisuje dowolny widok kontroli serwera — zmiany stanu, które wystąpiły od momentu, gdy strona została opublikowana na serwerze.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Odziedziczone po Control)
SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.Sets design-time data for a control.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń, aby renderować formant serwera i jego zawartość w jego formancie nadrzędnym.Assigns an event handler delegate to render the server control and its content into its parent control.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TrackViewState()

Powoduje śledzenie zmian stanu widoku w formancie serwera, aby mogły być przechowywane w obiekcie formantu serwera StateBag .Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Ten obiekt jest dostępny za pomocą ViewState właściwości.This object is accessible through the ViewState property.

(Odziedziczone po Control)

Zdarzenia

DataBinding

Występuje, gdy formant serwera wiąże się ze źródłem danych.Occurs when the server control binds to a data source.

(Odziedziczone po Control)
Disposed

Występuje, gdy formant serwera zostanie wystawiony z pamięci, który jest ostatnim etapem cyklu życia formantu serwera, gdy zażądano strony 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.

(Odziedziczone po Control)
Init

Występuje po zainicjowaniu formantu serwera, który jest pierwszym krokiem w jego cyklu życia.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest załadowana do Page obiektu.Occurs when the server control is loaded into the Page object.

(Odziedziczone po Control)
PreRender

Występuje po Control załadowaniu obiektu, ale przed renderowaniem.Occurs after the Control object is loaded but prior to rendering.

(Odziedziczone po Control)
Unload

Występuje, gdy formant serwera zostanie zwolniony z pamięci.Occurs when the server control is unloaded from memory.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder .For a description of this member, see ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState() .For a description of this member, see GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary) .For a description of this member, see SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control) .For a description of this member, see SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData .For a description of this member, see UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings .For a description of this member, see DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings .For a description of this member, see HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions .For a description of this member, see Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions .For a description of this member, see HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object) .For a description of this member, see AddParsedSubObject(Object).

(Odziedziczone po Control)

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonego formantu.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Zwraca obiekt obiektu z tabeli dla kontrolki zawierającej dane.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Pobiera metadane tabeli dla określonej kontrolki danych.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Ustawia metadane tabeli dla określonej kontrolki danych.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Ustawia metadane tabeli i mapowanie wartości domyślnej dla określonej kontrolki danych.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Ustawia metadane tabeli i mapowanie wartości domyślnej dla określonej kontrolki danych.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Określa, czy metadane tabeli są dostępne.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

Dotyczy

Zobacz też