Aracılığıyla paylaş


DetailsView.Fields Özellik

Tanım

Bir denetimde DataControlField açıkça bildirilen satır alanlarını temsil eden bir DetailsView nesne koleksiyonunu alır.

public:
 virtual property System::Web::UI::WebControls::DataControlFieldCollection ^ Fields { System::Web::UI::WebControls::DataControlFieldCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.DataControlFieldCollection Fields { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Fields : System.Web.UI.WebControls.DataControlFieldCollection
Public Overridable ReadOnly Property Fields As DataControlFieldCollection

Özellik Değeri

DataControlFieldCollection

DataControlFieldCollection Denetimde DetailsView açıkça bildirilen tüm satır alanlarını içeren bir.

Öznitelikler

Örnekler

Aşağıdaki kod örneği, bir DetailsView denetimin koleksiyonuna bildirim temelli olarak satır alanlarının Fields nasıl ekleneceğini gösterir.


<%@ Page language="C#" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView Fields Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Fields Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          AutoGenerateRows="false"
          allowpaging="true"
          runat="server">
               
        <Fields>
         <asp:BoundField 
           DataField="CompanyName" 
           HeaderText="Company Name"/>
         <asp:BoundField 
           DataField="City" 
           HeaderText="City"/>
        </Fields>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

<%@ Page language="VB" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView Fields Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView Fields Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          AutoGenerateRows="false"
          allowpaging="true"
          runat="server">
               
        <Fields>
         <asp:BoundField 
           DataField="CompanyName" 
           HeaderText="Company Name"/>
         <asp:BoundField 
           DataField="City" 
           HeaderText="City"/>
        </Fields>
                    
        </asp:detailsview>
        
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the web.config file.                            -->
        <asp:SqlDataSource ID="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Açıklamalar

Bir DetailsView denetimin satır alanlarını açıkça bildirdiğinizde, bu satır alanları özelliğinde Fields (koleksiyon) depolanır. Koleksiyon Fields ayrıca açıkça bildirilen satırların koleksiyonunu program aracılığıyla yönetmenize de olanak tanır.

Not

Açıkça bildirilen satır alanları, otomatik olarak oluşturulan satır alanlarıyla birlikte kullanılabilir. Her ikisi de kullanıldığında, açıkça bildirilen satır alanları önce işlenir ve ardından otomatik olarak oluşturulan satır alanları gelir. Otomatik olarak oluşturulan satır alanları koleksiyona Fields eklenmez.

Denetimdeki satırların davranışını farklı satır alanı türleri belirler. Aşağıdaki tabloda, koleksiyonda Fields kullanılabilecek farklı satır alanı türleri gösterilmektedir.

Satır alanı türü Description
BoundField Veri kaynağındaki bir alanın değerini metin olarak görüntüler.
ButtonField Denetimde DetailsView bir komut düğmesi görüntüler. Bu, Ekle veya Kaldır düğmesi gibi özel düğme denetimine sahip bir satır görüntülemenizi sağlar.
CheckBoxField Denetimde DetailsView bir onay kutusu görüntüler. Bu satır alanı türü genellikle Boole değeri olan alanları görüntülemek için kullanılır.
CommandField Denetimde düzenleme, ekleme veya silme işlemlerini DetailsView gerçekleştirmek için yerleşik komut düğmelerini görüntüler.
HyperLinkField Veri kaynağındaki bir alanın değerini köprü olarak görüntüler. Bu satır alanı türü, köprü url'sine ikinci bir alan bağlamanızı sağlar.
ImageField Denetimde DetailsView bir görüntü görüntüler.
TemplateField Denetimdeki bir satırın DetailsView kullanıcı tanımlı içeriğini belirtilen şablona göre görüntüler. Bu satır alanı türü, özel bir satır alanı oluşturmanıza olanak tanır.

Bir DetailsView denetimin satır alanlarını açıkça bildirmek için önce özelliğini olarak falseayarlayınAutoGenerateRows. Ardından, denetimin açma ve kapatma <Fields> etiketleri arasına açma ve kapatma etiketleri DetailsView ekleyin. Son olarak, açma ve kapatma <Fields> etiketleri arasına eklemek istediğiniz satır alanlarını listeleyin. Satır alanları denetimde DetailsView , satır alanlarının koleksiyonda görünme sırasına göre Fields görüntülenir.

Koleksiyona program aracılığıyla satır alanları ekleyebilmenize Fields rağmen, satır alanlarını denetimde DetailsView bildirimli olarak listelemek ve sonra satır alanını göstermek veya gizlemek için her satır alanının özelliğini kullanmak Visible daha kolaydır.

Visible Satır alanının özelliği olarak falseayarlanırsa, satır denetimde DetailsView görüntülenmez ve satır verileri istemciye gidiş dönüş yapmaz. Görünür olmayan bir satırın verilerinin gidiş dönüş yapmasını istiyorsanız, alan adını DataKeyNames özelliğe ekleyin.

Şunlara uygulanır

Ayrıca bkz.