Aracılığıyla paylaş


XmlDataSource Sınıf

Tanım

Veriye bağlı denetimlere yönelik bir XML veri kaynağını temsil eder.

public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
    inherit HierarchicalDataSourceControl
    interface IDataSource
    interface IListSource
Public Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource
Devralma
Öznitelikler
Uygulamalar

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod örneği, örnek XML dosyasındaki XML verilerini görüntülemek için denetimle TreeView birlikte bir denetimin nasıl kullanılacağını XmlDataSource gösterir. İkinci örnekte, XML verilerini görüntülemek için bir denetimin şablonlu Repeater denetimle nasıl kullanılacağı XmlDataSource gösterilmektedir.

Aşağıdaki kod örneği, XML verilerini görüntülemek için denetimle XmlDataSource birlikte bir TreeView denetimin nasıl kullanılacağını gösterir. özelliği XmlDataSource tarafından DataFile tanımlanan XML dosyasından XML verilerini yükler.

<%@ Page Language="C#" %>
<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:TreeView
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </asp:TreeView>

    </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">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:TreeView
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </asp:TreeView>

    </form>
  </body>
</html>

Kod örneğindeki XML dosyasında aşağıdaki veriler vardır:

<books>  
   <computerbooks>  
     <book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>  
     <book title="Straight Talk About Computers" author="Dean Straight"/>  
     <book title="You Can Combat Computer Stress!" author="Marjorie Green"/>                  
   </computerbooks>  
   <cookbooks>  
     <book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>  
   </cookbooks>  
</books>  

Aşağıdaki kod örneği, XML verilerini görüntülemek için bir denetimin şablonlu Repeater denetimle nasıl kullanılacağını XmlDataSource gösterir. Denetim, Repeater temsil ettiği XML belgesi XmlDataSource içindeki veri öğelerine bağlanmak için bir XPath veri bağlama ifadesi kullanır. ve XPathSelect veri bağlama söz dizimi hakkında XPath daha fazla bilgi için sınıfına XPathBinder bakın.

<%@ Page Language="C#" %>
<!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>Order</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </ItemTemplate>
    </asp:Repeater>

  </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">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Order</title>
</head>
<body> 
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </ItemTemplate>
    </asp:Repeater>

  </form>
  </body>
</html>

Kod örneğindeki XML dosyasında aşağıdaki veriler vardır:

<?xml version="1.0" encoding="iso-8859-1"?>  
 <orders>  
   <order>  
     <customer id="12345" />  
     <customername>  
         <firstn>John</firstn>  
         <lastn>Smith</lastn>  
     </customername>  
     <transaction id="12345" />  
     <shipaddress>  
         <address1>1234 Tenth Avenue</address1>  
         <city>Bellevue</city>  
         <state>Washington</state>  
         <zip>98001</zip>  
     </shipaddress>  
     <summary>  
         <item dept="tools">screwdriver</item>  
         <item dept="tools">hammer</item>  
         <item dept="plumbing">fixture</item>  
     </summary>  
   </order>  
</orders>  

Açıklamalar

Bu konuda:

Giriş

Denetim XmlDataSource , XML verilerini veriye bağlı denetimlere sunan bir veri kaynağı denetimidir. Denetim, XmlDataSource hem hiyerarşik hem de tablosal verileri görüntülemek için veriye bağlı denetimler tarafından kullanılabilir. Denetim XmlDataSource genellikle salt okunur senaryolarda hiyerarşik XML verilerini görüntülemek için kullanılır. XmlDataSource Denetim sınıfını HierarchicalDataSourceControl genişletdiğinden hiyerarşik verilerle çalışır. Denetim XmlDataSource ayrıca arabirimini IDataSource uygular ve tablosal veya liste stilinde verilerle çalışır.

Not

Güvenlik amacıyla, denetim özelliklerinin hiçbiri XmlDataSource görünüm durumunda depolanmaz. İstemcide görüntüleme durumunun içeriğinin kodunu çözmek teknik olarak mümkün olduğundan, veri yapısı veya içeriği hakkında hassas bilgilerin depolanması sizi bir bilginin açığa çıkması tehdidine maruz bırakabilir. Özellik gibi XPath bilgileri görüntüleme durumunda depolamanız gerekiyorsa, yönergesini ayarlayarak ViewStateEncryptionMode içeriği korumak için şifrelemeyi etkinleştirebileceğinizi @ Page unutmayın.

Sayfa geliştiricileri, veriye bağlı denetimleri kullanarak XML verilerini görüntülemek için denetimi kullanır XmlDataSource .

XML Verisi Kaynakları

genellikle XmlDataSource özelliği tarafından belirtilen xml dosyasından DataFile XML verilerini yükler. XML verileri, özelliğini kullanarak Data doğrudan dize biçimindeki veri kaynağı denetimi tarafından da depolanabilir. XML verilerini veriye bağlı denetim tarafından görüntülenmeden önce dönüştürmek istiyorsanız, dönüştürme için Genişletilebilir Stil Sayfası Dili (XSL) stil sayfası sağlayabilirsiniz. XML verilerinde olduğu gibi, stil sayfasını genellikle özelliğiyle TransformFile belirtilen bir dosyadan yüklersiniz, ancak doğrudan özelliğini kullanarak Transform dize biçiminde de depolayabilirsiniz.

XML Verilerini Güncelleştirme

Denetim XmlDataSource genellikle veriye bağlı bir denetimin XML verilerini görüntülediği salt okunur veri senaryolarında kullanılır. Ancak, XML verilerini düzenlemek için denetimini de kullanabilirsiniz XmlDataSource . XML verilerini düzenlemek için, XML verilerinin GetXmlDocument bellek içi gösterimi olan bir XmlDataDocument nesneyi almak için yöntemini çağırın. içerdiği ve XmlNode nesneleri tarafından XmlDataDocument kullanıma sunulan nesne modelini kullanabilir veya belgedeki verileri işlemek için bir XPath filtreleme ifadesi kullanabilirsiniz. XML verilerinin bellek içi gösteriminde değişiklikler yaptığınızda, yöntemini çağırarak diske Save kaydedebilirsiniz.

Denetimin düzenleme özelliklerinde XmlDataSource bazı kısıtlamalar vardır:

  • XML verileri, özelliğinde belirtilen satır içi XML'den değil, özelliğiyle DataFile belirtilen bir XML dosyasından Data yüklenmelidir.

  • veya TransformFile özelliklerinde XSLT dönüştürmesi Transform belirtilemiyor.

  • yöntemi, Save farklı istekler tarafından yapılan eşzamanlı kaydetme işlemlerini işlemez. Birden fazla kullanıcı aracılığıyla XmlDataSourcebir XML dosyasını düzenliyorsa, tüm kullanıcıların aynı verilerle çalıştığının garantisi yoktur. Aynı eşzamanlılık sorunları nedeniyle bir Save işlemin başarısız olması da mümkündür.

XSL Dönüşümü Belirtme

XML verileriyle gerçekleştirilen yaygın bir işlem, bunu bir XML veri kümesinden diğerine dönüştürmektir. DenetimXmlDataSource, veriye bağlı denetime geçirilmeden önce XML verilerine uygulanacak bir XSL stil sayfası belirten ve TransformFile özellikleriyle Transform XML dönüştürmelerini ve TransformArgumentList dönüştürme sırasında XSL stil sayfası tarafından kullanılacak dinamik XSLT stil sayfası bağımsız değişkenlerini sağlamanıza olanak tanıyan özelliğini destekler. özelliğini kullanarak XPath bir XPath filtreleme ifadesi belirtirseniz, dönüştürme gerçekleştikten sonra uygulanır.

Not

sınıfı XmlDataSource , XSL dönüştürmeleri gerçekleştirmek için kullanım dışı sınıfını XslTransform kullanır. Sınıf kullanım dışı bırakıldıktan sonra XslTransform tanıtılan stil sayfası özelliklerini kullanmak istiyorsanız, sınıfını kullanarak XslCompiledTransform dönüştürmeleri el ile uygulayın.

XPath İfadesi kullanarak filtreleme

Varsayılan olarak, XmlDataSource denetim özelliği tarafından DataFile tanımlanan veya özelliğinde satır içinde Data bulunan XML dosyasındaki tüm XML verilerini yükler, ancak bir XPath ifadesi kullanarak verileri filtreleyebilirsiniz. özelliği, XPath XML verileri yüklendikten ve dönüştürüldükten sonra uygulanan bir XPath söz dizimi filtresini destekler.

Önbelleğe Alma

Performans amacıyla önbelleğe alma, denetim için XmlDataSource varsayılan olarak etkindir. İstenen her sayfada sunucuda bir XML dosyasının açılması ve okunması uygulamanızın performansını düşürebilir. Önbelleğe alma, Web sunucusundaki bellek pahasına sunucunuzdaki işlem yükünü azaltmanıza olanak tanır; Çoğu durumda bu iyi bir takastır. XmlDataSource özelliği olarak ayarlandığında verileri EnableCaching otomatik olarak önbelleğe truealır ve CacheDuration özellik, önbellek geçersiz kılınmadan önce önbelleğin verileri depolaması için gereken saniye sayısına ayarlanır. veri kaynağı denetiminin önbelleğe alma davranışında daha fazla ince ayar yapmak için kullanabilirsiniz CacheExpirationPolicy .

Ek Özellikler

Aşağıdaki tabloda, denetim tarafından XmlDataSource desteklenen ek özellikler listelenmiştir.

Özellik Açıklama
Sıralama Denetim tarafından XmlDataSource desteklenmez.
Filtreleme özelliği uygun XPath bir XPath ifadesi kullanarak XML verilerini filtrelemek için kullanılabilir.
Sayfalama Denetim tarafından XmlDataSource desteklenmez.
Güncelleştirme doğrudan öğesini işleyip XmlDataDocument yöntemini çağırarak Save desteklenir.
Siliniyor doğrudan öğesini işleyip XmlDataDocument yöntemini çağırarak Save desteklenir.
Ekleme doğrudan öğesini işleyip XmlDataDocument yöntemini çağırarak Save desteklenir.
Önbelleğe Alma Özelliği 0 (sonsuz) ve CacheExpirationPolicy özelliği olarak ayarlanmış şekilde varsayılan olarak CacheDuration etkindirAbsolute.

Veri Görünümü Nesnesi

XmlDataSource Denetim hem hiyerarşik verileri görüntüleyen veriye bağlı denetimleri hem de tablo verilerini görüntüleyen denetimleri desteklediğinden, veri kaynağı denetimi temel alınan XML verilerinde birden çok veri kaynağı görünümü nesnesi türünü destekler. Denetim, XmlDataSource tablosal verileri görüntüleyen bir veriye bağlı denetimle kullanıldığında tek bir adlandırılmış XmlDataSourceView nesne alır. yöntemi bu GetViewNames tek adlandırılmış görünümü tanımlar. Hiyerarşik verileri görüntüleyen bir veriye bağlı denetimle kullanıldığında, XmlDataSource denetim yöntemine GetHierarchicalView geçirilen herhangi bir benzersiz hiyerarşik yol için bir XmlHierarchicalDataSourceView alır.

Tanımlayıcı Sözdizimi

<asp:XmlDataSource  
    CacheDuration="string|Infinite"  
    CacheExpirationPolicy="Absolute|Sliding"  
    CacheKeyDependency="string"  
    DataFile="string"  
    EnableCaching="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ID="string"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnTransforming="Transforming event handler"  
    OnUnload="Unload event handler"  
    runat="server"  
    SkinID="string"  
    TransformArgumentList="string"  
    TransformFile="string"  
    Visible="True|False"  
    XPath="string"  
>  
    <Data>string</Data>  
    <Transform>string</Transform>  
</asp:XmlDataSource>  

Oluşturucular

XmlDataSource()

XmlDataSource sınıfının yeni bir örneğini oluşturur.

Özellikler

Adapter

Denetim için tarayıcıya özgü bağdaştırıcıyı alır.

(Devralındığı yer: Control)
AppRelativeTemplateSourceDirectory

Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.

(Devralındığı yer: Control)
BindingContainer

Bu denetimin veri bağlamasını içeren denetimi alır.

(Devralındığı yer: Control)
CacheDuration

Veri kaynağı denetiminin aldığı verileri önbelleğe aldığı süreyi saniye cinsinden alır veya ayarlar.

CacheExpirationPolicy

Veri kaynağı denetiminin kullandığı önbelleğin önbelleğe alma davranışını açıklamak için önbellek süresiyle birleştirilen önbellek süre sonu ilkesini alır veya ayarlar.

CacheKeyContext

Veri kaynağı denetimi için önbellek anahtarının değerini görüntüleme durumundan alır veya ayarlar ya da durumu görüntülemek için önbellek anahtarını ekler.

CacheKeyDependency

Veri kaynağı denetimi tarafından oluşturulan tüm veri önbelleği nesnelerine bağlı kullanıcı tanımlı bir anahtar bağımlılığını alır veya ayarlar. Anahtarın süresi dolduğunda tüm önbellek nesnelerinin süresi açıkça dolar.

ChildControlsCreated

Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ClientID

ASP.NET tarafından oluşturulan sunucu denetim tanımlayıcısını alır.

(Devralındığı yer: HierarchicalDataSourceControl)
ClientIDMode

Bu özellik veri kaynağı denetimleri için kullanılmaz.

(Devralındığı yer: HierarchicalDataSourceControl)
ClientIDSeparator

özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.

(Devralındığı yer: Control)
Context

HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.

(Devralındığı yer: Control)
Controls

Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection denetimi için alt denetimleri temsil eden bir nesnesi alır.

(Devralındığı yer: HierarchicalDataSourceControl)
Data

Veri kaynağı denetiminin bağlandığını XML veri bloğunu alır veya ayarlar.

DataFile

Veri kaynağının bağlandığını xml dosyasının dosya adını belirtir.

DataItemContainer

Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DesignMode

Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
EnableCaching

Denetimin veri önbelleğe alma özelliğinin XmlDataSource etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

EnableTheming

Bu denetimin temaları destekleyip desteklemediğini belirten bir değer alır.

(Devralındığı yer: HierarchicalDataSourceControl)
EnableViewState

Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip getirmek olmadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
Events

Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.

(Devralındığı yer: Control)
HasChildViewState

Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ID

Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar.

(Devralındığı yer: Control)
IdSeparator

Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.

(Devralındığı yer: Control)
IsChildControlStateCleared

Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
IsTrackingViewState

Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır.

(Devralındığı yer: Control)
IsViewStateEnabled

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: Control)
LoadViewStateByID

Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
NamingContainer

Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır.

(Devralındığı yer: Control)
Page

Sunucu denetimini içeren örneğe başvuru Page alır.

(Devralındığı yer: Control)
Parent

Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır.

(Devralındığı yer: Control)
RenderingCompatibility

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

(Devralındığı yer: Control)
Site

Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.

(Devralındığı yer: Control)
SkinID

Denetime uygulanacak HierarchicalDataSourceControl kaplamayı alır veya ayarlar.

(Devralındığı yer: HierarchicalDataSourceControl)
TemplateControl

Bu denetimi içeren şablona başvuru alır veya ayarlar.

(Devralındığı yer: Control)
TemplateSourceDirectory

geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır.

(Devralındığı yer: Control)
Transform

Denetim tarafından yönetilen XML verilerinde gerçekleştirilecek XSLT dönüştürmesini tanımlayan Genişletilebilir Stil Sayfası Dili (XSL) veri bloğunu XmlDataSource alır veya ayarlar.

TransformArgumentList

XML verilerinde dönüştürme gerçekleştirmek için veya TransformFile özellikleri tarafından Transform tanımlanan stil sayfasıyla kullanılan XSLT bağımsız değişkenlerinin listesini sağlar.

TransformFile

Denetim tarafından XmlDataSource yönetilen XML verilerinde gerçekleştirilecek XSLT dönüştürmesini tanımlayan Genişletilebilir Stil Sayfası Dili (XSL) dosyasının (.xsl) dosya adını belirtir.

UniqueID

Sunucu denetimi için benzersiz, hiyerarşik nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini gösteren bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ViewState

Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır.

(Devralındığı yer: Control)
ViewStateIgnoresCase

Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ViewStateMode

Bu denetimin görünüm durumu modunu alır veya ayarlar.

(Devralındığı yer: Control)
Visible

Denetimin görsel olarak görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: HierarchicalDataSourceControl)
XPath

özelliği tarafından veya özelliği tarafından belirtilen DataFile XML dosyası tarafından bulunan XML verilerine Data uygulanacak bir XPath ifadesi belirtir.

Yöntemler

AddedControl(Control, Int32)

Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .

(Devralındığı yer: Control)
AddParsedSubObject(Object)

Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler.

(Devralındığı yer: Control)
ApplyStyleSheetSkin(Page)

Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.

(Devralındığı yer: HierarchicalDataSourceControl)
BeginRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemeye başlar.

(Devralındığı yer: Control)
BuildProfileTree(String, Boolean)

Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace .

(Devralındığı yer: Control)
ClearCachedClientID()

Önbelleğe alınan ClientID değeri olarak nullayarlar.

(Devralındığı yer: Control)
ClearChildControlState()

Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildViewState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearEffectiveClientIDMode()

ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.

(Devralındığı yer: Control)
CreateChildControls()

ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere birleşim tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
CreateControlCollection()

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

(Devralındığı yer: HierarchicalDataSourceControl)
DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

(Devralındığı yer: Control)
DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

(Devralındığı yer: Control)
DataBindChildren()

Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.

(Devralındığı yer: Control)
Dispose()

Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini sonlandırır.

(Devralındığı yer: Control)
EnsureChildControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

(Devralındığı yer: Control)
EnsureID()

Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.

(Devralındığı yer: Control)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindControl(String)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: HierarchicalDataSourceControl)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da pathOffset aramaya yardımcı olur. Yöntemin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını denetime ayarlar.

(Devralındığı yer: HierarchicalDataSourceControl)
GetDesignModeState()

Denetim için tasarım zamanı verilerini alır.

(Devralındığı yer: Control)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetHierarchicalView(String)

Denetimin veri kaynağı görünüm nesnesini XmlDataSource alır. viewPath parametresi bir XPath ifadesi olabilir.

GetRouteUrl(Object)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, Object)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)

Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür.

(Devralındığı yer: Control)
GetXmlDocument()

XML verilerini doğrudan temel alınan veri depolama alanından veya önbellekten belleğe yükler ve bir XmlDataDocument nesne biçiminde döndürür.

HasControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler.

(Devralındığı yer: HierarchicalDataSourceControl)
HasEvents()

Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini gösteren bir değer döndürür.

(Devralındığı yer: Control)
IsLiteralContent()

Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
LoadViewState(Object)

yöntemi tarafından SaveViewState() kaydedilen önceki bir sayfa isteğinden görünüm durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
MapPathSecure(String)

Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır.

(Devralındığı yer: Control)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnBubbleEvent(Object, EventArgs)

Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler.

(Devralındığı yer: Control)
OnDataBinding(EventArgs)

Olayı tetikler DataBinding .

(Devralındığı yer: Control)
OnDataSourceChanged(EventArgs)

Olayı tetikler DataSourceChanged .

(Devralındığı yer: HierarchicalDataSourceControl)
OnInit(EventArgs)

Olayı tetikler Init .

(Devralındığı yer: Control)
OnLoad(EventArgs)

Olayı tetikler Load .

(Devralındığı yer: Control)
OnPreRender(EventArgs)

Olayı tetikler PreRender .

(Devralındığı yer: Control)
OnTransforming(EventArgs)

Denetimin Transforming XML verileri üzerinde XSLT dönüşümü gerçekleştirmeden önce XmlDataSource olayı tetikler.

OnUnload(EventArgs)

Olayı tetikler Unload .

(Devralındığı yer: Control)
OpenFile(String)

Stream Bir dosyayı okumak için kullanılan alır.

(Devralındığı yer: Control)
RaiseBubbleEvent(Object, EventArgs)

Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.

(Devralındığı yer: Control)
RemovedControl(Control)

Alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control .

(Devralındığı yer: Control)
Render(HtmlTextWriter)

Sunucu denetimi içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir.

(Devralındığı yer: Control)
RenderChildren(HtmlTextWriter)

Sunucu denetiminin alt öğelerinin içeriğini sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: HierarchicalDataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter .

(Devralındığı yer: Control)
ResolveAdapter()

Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.

(Devralındığı yer: Control)
ResolveClientUrl(String)

Tarayıcı tarafından kullanılabilecek bir URL alır.

(Devralındığı yer: Control)
ResolveUrl(String)

URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür.

(Devralındığı yer: Control)
Save()

Özellik ayarlandıysa, denetim tarafından XmlDataSource bellekte tutulan XML verilerini diske DataFile kaydeder.

SaveControlState()

Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.

(Devralındığı yer: Control)
SaveViewState()

Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetimi görünüm durumu değişikliklerini kaydeder.

(Devralındığı yer: Control)
SetDesignModeState(IDictionary)

Denetim için tasarım zamanı verilerini ayarlar.

(Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)

Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.

(Devralındığı yer: Control)
SetTraceData(Object, Object)

İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
SetTraceData(Object, Object, Object)

İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Sunucu denetiminin nesnesinde depolanabilmeleri için sunucu StateBag denetiminde görünüm durumu değişikliklerinin izlenmesine neden olur. Bu nesneye özelliği üzerinden ViewState erişilebilir.

(Devralındığı yer: Control)

Ekinlikler

DataBinding

Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.

(Devralındığı yer: Control)
Disposed

ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir.

(Devralındığı yer: Control)
Init

Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır.

(Devralındığı yer: Control)
Load

Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.

(Devralındığı yer: Control)
PreRender

Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.

(Devralındığı yer: Control)
Transforming

Özelliği tarafından tanımlanan veya özelliği tarafından TransformTransformFile tanımlanan stil sayfası XML verilerine uygulanmadan önce gerçekleşir.

Unload

Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

(Devralındığı yer: Control)

Belirtik Arabirim Kullanımları

IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IDataSource.DataSourceChanged

Bu üyenin açıklaması için bkz DataSourceChanged. .

IDataSource.GetView(String)

Veri kaynağı denetimiyle ilişkili adlandırılmış veri kaynağı görünümünü alır.

IDataSource.GetViewNames()

Bu üyenin açıklaması için bkz GetViewNames(). .

IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IHierarchicalDataSource.DataSourceChanged

HierarchicalDataSourceControl veriye bağlı denetimleri etkileyen bir şekilde değiştiğinde gerçekleşir.

(Devralındığı yer: HierarchicalDataSourceControl)
IHierarchicalDataSource.GetHierarchicalView(String)

Belirtilen yol için arabirimin IHierarchicalDataSource görünüm yardımcı nesnesini alır.

(Devralındığı yer: HierarchicalDataSourceControl)
IListSource.ContainsListCollection

Bu üyenin açıklaması için bkz ContainsListCollection. .

IListSource.GetList()

Bu üyenin açıklaması için bkz GetList(). .

IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)

Uzantı Metotları

FindDataSourceControl(Control)

Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.

FindFieldTemplate(Control, String)

Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.

FindMetaTable(Control)

İçeren veri denetimi için metatablo nesnesini döndürür.

GetDefaultValues(IDataSource)

Belirtilen veri kaynağı için varsayılan değerlerin koleksiyonunu alır.

GetMetaTable(IDataSource)

Belirtilen veri kaynağı nesnesindeki bir tablonun meta verilerini alır.

TryGetMetaTable(IDataSource, MetaTable)

Tablo meta verilerinin kullanılabilir olup olmadığını belirler.

Şunlara uygulanır

Ayrıca bkz.