Aracılığıyla paylaş

DetailsView.Fields Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Bir denetimde DataControlField açıkça bildirilen satır alanlarını temsil eden bir DetailsView nesne koleksiyonu 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
PersistenceModeAttribute

Örnekler

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


<%@ 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.

Uyarı

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, ardından otomatik olarak oluşturulan satır alanları gelir. Otomatik olarak oluşturulan satır alanları koleksiyona Fields eklenmez.

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

Satır alanı türü Açıklama
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ında 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 Fields göre görüntülenir.

Koleksiyona program aracılığıyla satır alanları ekleyebilmenize Fields rağmen, denetimde DetailsView satır alanlarını bildirimli olarak listelemek ve ardından 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, denetimde DetailsView satır görüntülenmez ve satıra ilişkin veriler 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ı özelliğine DataKeyNames ekleyin.

Şunlara uygulanır

Ayrıca bkz.