Aracılığıyla paylaş


DataSourceControl Sınıf

Tanım

Veri kaynaklarını veriye bağlı denetimlere temsil eden denetimler için temel sınıf görevi görür.

public ref class DataSourceControl abstract : System::Web::UI::Control, System::ComponentModel::IListSource, System::Web::UI::IDataSource
[System.ComponentModel.Bindable(false)]
public abstract class DataSourceControl : System.Web.UI.Control, System.ComponentModel.IListSource, System.Web.UI.IDataSource
[<System.ComponentModel.Bindable(false)>]
type DataSourceControl = class
    inherit Control
    interface IDataSource
    interface IListSource
Public MustInherit Class DataSourceControl
Inherits Control
Implements IDataSource, IListSource
Devralma
DataSourceControl
Türetilmiş
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki kod örneği, bir sınıfın DataSourceControl sınıfını nasıl genişletebileceğini gösterir. CsvDataSource denetimi, .csv dosyasında depolanan virgülle ayrılmış dosya verilerini temsil eder. CsvDataSource sınıfı, temel sınıf uygulamaları işlevsel olmadığından GetView, GetViewNamesve diğer yöntemlerin kendi uygulamalarını sağlar.

using System;
using System.Collections;
using System.Data;
using System.IO;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

// The CsvDataSource is a data source control that retrieves its
// data from a comma-separated value file.
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class CsvDataSource : DataSourceControl
{
    public CsvDataSource() : base() {}

    // The comma-separated value file to retrieve data from.
    public string FileName {
        get {
            return ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile;
        }
        set {
            // Only set if it is different.
            if ( ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile != value) {
                ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile = value;
                RaiseDataSourceChangedEvent(EventArgs.Empty);
            }
        }
    }

    // Do not add the column names as a data row. Infer columns if the CSV file does
    // not include column names.
    public bool IncludesColumnNames {
        get {
            return ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames;
        }
        set {
            // Only set if it is different.
            if ( ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames != value) {
                ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames = value;
                RaiseDataSourceChangedEvent(EventArgs.Empty);
            }
        }
    }

    // Return a strongly typed view for the current data source control.
    private CsvDataSourceView view = null;
    protected override DataSourceView GetView(string viewName) {
        if (null == view) {
            view = new CsvDataSourceView(this, String.Empty);
        }
        return view;
    }
    // The ListSourceHelper class calls GetList, which
    // calls the DataSourceControl.GetViewNames method.
    // Override the original implementation to return
    // a collection of one element, the default view name.
    protected override ICollection GetViewNames() {
        ArrayList al = new ArrayList(1);
        al.Add(CsvDataSourceView.DefaultViewName);
        return al as ICollection;
    }
}

// The CsvDataSourceView class encapsulates the
// capabilities of the CsvDataSource data source control.
public class CsvDataSourceView : DataSourceView
{

    public CsvDataSourceView(IDataSource owner, string name) :base(owner, DefaultViewName) {
    }

    // The data source view is named. However, the CsvDataSource
    // only supports one view, so the name is ignored, and the
    // default name used instead.
    public static string DefaultViewName = "CommaSeparatedView";

    // The location of the .csv file.
    private string sourceFile = String.Empty;
    internal string SourceFile {
        get {
            return sourceFile;
        }
        set {
            // Use MapPath when the SourceFile is set, so that files local to the
            // current directory can be easily used.
            string mappedFileName = HttpContext.Current.Server.MapPath(value);
            sourceFile = mappedFileName;
        }
    }

    // Do not add the column names as a data row. Infer columns if the CSV file does
    // not include column names.
    private bool columns = false;
    internal bool IncludesColumnNames {
        get {
            return columns;
        }
        set {
            columns = value;
        }
    }

    // Get data from the underlying data source.
    // Build and return a DataView, regardless of mode.
    protected override IEnumerable ExecuteSelect(DataSourceSelectArguments selectArgs) {
        IEnumerable dataList = null;
        // Open the .csv file.
        if (File.Exists(this.SourceFile)) {
            DataTable data = new DataTable();

            // Open the file to read from.
            using (StreamReader sr = File.OpenText(this.SourceFile)) {
                // Parse the line
                string s = "";
                string[] dataValues;
                DataColumn col;

                // Do the following to add schema.
                dataValues = sr.ReadLine().Split(',');
                // For each token in the comma-delimited string, add a column
                // to the DataTable schema.
                foreach (string token in dataValues) {
                    col = new DataColumn(token,typeof(string));
                    data.Columns.Add(col);
                }

                // Do not add the first row as data if the CSV file includes column names.
                if (! IncludesColumnNames)
                    data.Rows.Add(CopyRowData(dataValues, data.NewRow()));

                // Do the following to add data.
                while ((s = sr.ReadLine()) != null) {
                    dataValues = s.Split(',');
                    data.Rows.Add(CopyRowData(dataValues, data.NewRow()));
                }
            }
            data.AcceptChanges();
            DataView dataView = new DataView(data);
            if (!string.IsNullOrEmpty(selectArgs.SortExpression)) {
                dataView.Sort = selectArgs.SortExpression;
            }
            dataList = dataView;
        }
        else {
            throw new System.Configuration.ConfigurationErrorsException("File not found, " + this.SourceFile);
        }

        if (null == dataList) {
            throw new InvalidOperationException("No data loaded from data source.");
        }

        return dataList;
    }

    private DataRow CopyRowData(string[] source, DataRow target) {
        try {
            for (int i = 0;i < source.Length;i++) {
                target[i] = source[i];
            }
        }
        catch (System.IndexOutOfRangeException) {
            // There are more columns in this row than
            // the original schema allows.  Stop copying
            // and return the DataRow.
            return target;
        }
        return target;
    }
    // The CsvDataSourceView does not currently
    // permit deletion. You can modify or extend
    // this sample to do so.
    public override bool CanDelete {
        get {
            return false;
        }
    }
    protected override int ExecuteDelete(IDictionary keys, IDictionary values)
    {
        throw new NotSupportedException();
    }
    // The CsvDataSourceView does not currently
    // permit insertion of a new record. You can
    // modify or extend this sample to do so.
    public override bool CanInsert {
        get {
            return false;
        }
    }
    protected override int ExecuteInsert(IDictionary values)
    {
        throw new NotSupportedException();
    }
    // The CsvDataSourceView does not currently
    // permit update operations. You can modify or
    // extend this sample to do so.
    public override bool CanUpdate {
        get {
            return false;
        }
    }
    protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
    {
        throw new NotSupportedException();
    }
}
Imports System.Collections
Imports System.Data
Imports System.IO
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB.Controls

' The CsvDataSource is a data source control that retrieves its
' data from a comma-separated value file.
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class CsvDataSource
   Inherits DataSourceControl

   Public Sub New()
   End Sub

   ' The comma-separated value file to retrieve data from.
   Public Property FileName() As String
      Get
         Return CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile
      End Get
      Set
         ' Only set if it is different.
         If CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile <> value Then
            CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile = value
            RaiseDataSourceChangedEvent(EventArgs.Empty)
         End If
      End Set
   End Property

   ' Do not add the column names as a data row. Infer columns if the CSV file does
   ' not include column names.

   Public Property IncludesColumnNames() As Boolean
      Get
         Return CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames
      End Get
      Set
         ' Only set if it is different.
         If CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames <> value Then
            CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames = value
            RaiseDataSourceChangedEvent(EventArgs.Empty)
         End If
      End Set
   End Property


   ' Return a strongly typed view for the current data source control.
   Private view As CsvDataSourceView = Nothing

   Protected Overrides Function GetView(viewName As String) As DataSourceView
      If view Is Nothing Then
         view = New CsvDataSourceView(Me, String.Empty)
      End If
      Return view
   End Function 'GetView

   ' The ListSourceHelper class calls GetList, which
   ' calls the DataSourceControl.GetViewNames method.
   ' Override the original implementation to return
   ' a collection of one element, the default view name.
   Protected Overrides Function GetViewNames() As ICollection
      Dim al As New ArrayList(1)
      al.Add(CsvDataSourceView.DefaultViewName)
      Return CType(al, ICollection)
   End Function 'GetViewNames

End Class


' The CsvDataSourceView class encapsulates the
' capabilities of the CsvDataSource data source control.

Public Class CsvDataSourceView
   Inherits DataSourceView

   Public Sub New(owner As IDataSource, name As String)
       MyBase.New(owner, DefaultViewName)
   End Sub

   ' The data source view is named. However, the CsvDataSource
   ' only supports one view, so the name is ignored, and the
   ' default name used instead.
   Public Shared DefaultViewName As String = "CommaSeparatedView"

   ' The location of the .csv file.
   Private aSourceFile As String = [String].Empty

   Friend Property SourceFile() As String
      Get
         Return aSourceFile
      End Get
      Set
         ' Use MapPath when the SourceFile is set, so that files local to the
         ' current directory can be easily used.
         Dim mappedFileName As String
         mappedFileName = HttpContext.Current.Server.MapPath(value)
         aSourceFile = mappedFileName
      End Set
   End Property

   ' Do not add the column names as a data row. Infer columns if the CSV file does
   ' not include column names.
   Private columns As Boolean = False

   Friend Property IncludesColumnNames() As Boolean
      Get
         Return columns
      End Get
      Set
         columns = value
      End Set
   End Property

   ' Get data from the underlying data source.
   ' Build and return a DataView, regardless of mode.
   Protected Overrides Function ExecuteSelect(selectArgs As DataSourceSelectArguments) _
    As System.Collections.IEnumerable
      Dim dataList As IEnumerable = Nothing
      ' Open the .csv file.
      If File.Exists(Me.SourceFile) Then
         Dim data As New DataTable()

         ' Open the file to read from.
         Dim sr As StreamReader = File.OpenText(Me.SourceFile)

         Try
            ' Parse the line
            Dim dataValues() As String
            Dim col As DataColumn

            ' Do the following to add schema.
            dataValues = sr.ReadLine().Split(","c)
            ' For each token in the comma-delimited string, add a column
            ' to the DataTable schema.
            Dim token As String
            For Each token In dataValues
               col = New DataColumn(token, System.Type.GetType("System.String"))
               data.Columns.Add(col)
            Next token

            ' Do not add the first row as data if the CSV file includes column names.
            If Not IncludesColumnNames Then
               data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
            End If

            ' Do the following to add data.
            Dim s As String
            Do
               s = sr.ReadLine()
               If Not s Is Nothing Then
                   dataValues = s.Split(","c)
                   data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
               End If
            Loop Until s Is Nothing

         Finally
            sr.Close()
         End Try

         data.AcceptChanges()
         Dim dataView As New DataView(data)
         If Not selectArgs.SortExpression Is String.Empty Then
             dataView.Sort = selectArgs.SortExpression
         End If
         dataList = dataView
      Else
         Throw New System.Configuration.ConfigurationErrorsException("File not found, " + Me.SourceFile)
      End If

      If dataList is Nothing Then
         Throw New InvalidOperationException("No data loaded from data source.")
      End If

      Return dataList
   End Function 'ExecuteSelect


   Private Function CopyRowData([source]() As String, target As DataRow) As DataRow
      Try
         Dim i As Integer
         For i = 0 To [source].Length - 1
            target(i) = [source](i)
         Next i
      Catch iore As IndexOutOfRangeException
         ' There are more columns in this row than
         ' the original schema allows.  Stop copying
         ' and return the DataRow.
         Return target
      End Try
      Return target
   End Function 'CopyRowData

   ' The CsvDataSourceView does not currently
   ' permit deletion. You can modify or extend
   ' this sample to do so.
   Public Overrides ReadOnly Property CanDelete() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteDelete(keys As IDictionary, values As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteDelete

   ' The CsvDataSourceView does not currently
   ' permit insertion of a new record. You can
   ' modify or extend this sample to do so.
   Public Overrides ReadOnly Property CanInsert() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteInsert

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class
End Namespace

Aşağıdaki kod örneği, web formunda CsvDataSource denetiminin nasıl kullanılacağını gösterir.

<%@ Page Language="C#" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.CS.Controls" %>

<!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:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="CsvDataSource1" />

      <aspSample:CsvDataSource
          id = "CsvDataSource1"
          runat = "server"
          filename = "sample.csv"
          includescolumnnames="True" />

    </form>
  </body>
</html>
<%@ Page Language="VB" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.VB.Controls" %>

<!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:gridview
                id="GridView1"
                runat="server"
                allowsorting="True"
                datasourceid="CsvDataSource1" />

            <aspSample:CsvDataSource
                id = "CsvDataSource1"
                runat = "server"
                filename = "sample.csv"
                includescolumnnames="True" />

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

Açıklamalar

ASP.NET, Web sunucusu denetimlerinin verilere tutarlı bir şekilde bağlanmasına olanak tanıyan bir denetim veri bağlama mimarisini destekler. Verilere bağlanan web sunucusu denetimleri, veriye bağlı denetimler olarak adlandırılır ve bağlamayı kolaylaştıran sınıflara veri kaynağı denetimleri adı verilir. Veri kaynağı denetimleri herhangi bir veri kaynağını temsil edebilir: ilişkisel veritabanı, dosya, akış, iş nesnesi vb. Veri kaynağı denetimleri, temel alınan verilerin kaynağından veya biçiminden bağımsız olarak verileri veriye bağlı denetimlere tutarlı bir şekilde sunar.

Web geliştirme görevlerinin çoğunu gerçekleştirmek için SqlDataSource, AccessDataSourceve XmlDataSourcegibi ASP.NET ile sağlanan veri kaynağı denetimlerini kullanırsınız. Kendi özel veri kaynağı denetiminizi uygulamak istediğinizde temel DataSourceControl sınıfını kullanırsınız.

IDataSource arabirimini uygulayan herhangi bir sınıf bir veri kaynağı denetimi olsa da, ASP.NET veri kaynağı denetimlerinin çoğu soyut DataSourceControl sınıfını genişletir ve bu da IDataSource arabiriminin temel uygulamasını sağlar. DataSourceControl sınıfı, veri kaynağı denetimini bir veriye bağlı denetimin DataSource özelliğine program aracılığıyla atamanızı ve verileri denetime temel bir liste olarak döndürmenizi sağlayan IListSource arabiriminin bir uygulamasını da sağlar.

DataBoundControl sınıfından türetilen herhangi bir ASP.NET denetimi bir veri kaynağı denetimine bağlanabilir. Bir DataBoundControl bir veri kaynağı denetimine bağlı olduğunda, veri bağlama çalışma zamanında otomatik olarak gerçekleştirilir. Veri kaynağı denetimlerini, DataSource veya DataSourceID özelliğini kullanıma sunan ve temel veri bağlamayı destekleyen ancak DataBoundControltüretilmeyen ASP.NET denetimleriyle de kullanabilirsiniz. Bu veriye bağlı denetimleri kullanırken açıkça DataBind yöntemini çağırmanız gerekir. Veri bağlama hakkında daha fazla bilgi için bkz. ASP.NET Veri Erişim İçerik Eşlemesi.

Veri kaynağı denetimini, DataSourceControl nesnesinin ve veri kaynağı görünümleri olarak adlandırılan ilişkili veri listelerinin birleşimi olarak düşünebilirsiniz. Her veri listesi bir DataSourceView nesnesiyle temsil edilir. Temel alınan veri depolama alanı bir veya daha fazla veri listesi içerdiğinden, bir DataSourceControl her zaman bir veya daha fazla adlandırılmış DataSourceView nesnesiyle ilişkilendirilir. IDataSource arabirimi, tüm veri kaynağı denetimlerinin veri kaynağı görünümleriyle etkileşim kurmak için kullandığı yöntemleri tanımlar: GetViewNames yöntemi şu anda veri kaynağı denetimiyle ilişkili olan veri kaynağı görünümlerini listelemek için kullanılır ve GetView yöntemi belirli bir veri kaynağı görünümü örneğini ada göre almak için kullanılır.

Ayrıca, veri kaynağı denetimini çağıranların verilere erişmek için kullandığı iki ayrı arabirim olarak düşünebilirsiniz. DataSourceControl sınıfı, web forms sayfası geliştirirken sayfa geliştiricilerin doğrudan etkileşime geçtiği arabirimdir ve DataSourceView sınıfı veriye bağlı denetimlerin ve veriye bağlı denetim yazarlarının etkileşime geçtiği arabirimdir. DataSourceView nesnesi yalnızca çalışma zamanında kullanılabilir olduğundan, veri kaynağı denetimi veya veri kaynağı görünümü için kalıcı olan tüm durumların doğrudan veri kaynağı denetimi tarafından kullanıma sunulması gerekir.

ASP.NET veri kaynağı denetimlerinin görsel olarak işlenmesi yoktur; bunları bildirimli olarak oluşturabilmeniz ve isteğe bağlı olarak durum yönetimine katılmalarına izin verebilmeniz için denetim olarak uygulanır. Sonuç olarak, veri kaynağı denetimleri EnableTheming veya SkinIDgibi görsel özellikleri desteklemez.

Oluşturucular

DataSourceControl()

DataSourceControl sınıfının yeni bir örneğini başlatır.

Ö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 Page veya UserControl nesnesinin uygulama göreli sanal dizinini alır veya ayarlar.

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

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

(Devralındığı yer: Control)
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.

ClientIDMode

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

ClientIDMode

ClientID özelliğinin değerini oluşturmak için kullanılan algoritmayı alır veya ayarlar.

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

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

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

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

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

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

DataItemContainer

Adlandırma kapsayıcısı IDataItemContaineruygularsa adlandırma kapsayıcısına başvuru alır.

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

Adlandırma kapsayıcısı IDataKeysControluygularsa adlandırma kapsayıcısına 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)
EnableTheming

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

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 taşımadığı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 okunurdur.

(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 programlı tanımlayıcıyı 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 denetimin içindeki denetimlerin denetim durumuna sahip olup olmadığını gösteren 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 gösteren bir değer alır.

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

Denetimin görünüm durumunu dizin yerine ID yükleyip yüklemediğini gösteren bir değer alır.

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

Aynı ID ö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 başvuru alır.

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

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

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

Sayfa denetimi hiyerarşisinde 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

Cilt DataSourceControl kontrol uygulamak için alır.

TemplateControl

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

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

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

(Devralındığı yer: Control)
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

StateBag nesnesinin 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ülenmediğini belirten bir değer alır veya ayarlar.

Yöntemler

AddedControl(Control, Int32)

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

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

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

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

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

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 Trace özelliğine teslim eder.

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

Önbelleğe alınan ClientID değerini nullolarak ayarlar.

(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()

Geçerli denetim örneğinin ve alt denetimlerin ClientIDMode özelliğini Inheritolarak ayarlar.

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

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

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

Alt denetimleri depolamak için bir koleksiyon oluşturur.

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 DataBinding olayı oluşturma 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()

Bir sunucu denetiminin bellekten çıkmadan önce son temizlemeyi gerçekleştirmesini sağlar.

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

İşleme verilerinin tasarım zamanı izlemeyi 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, Int32)

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

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

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

Focus()

Giriş odağını denetime ayarlar.

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)
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()

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

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

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

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

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

GetViewNames()

DataSourceControl denetimiyle ilişkili DataSourceView nesnelerinin listesini temsil eden bir ad koleksiyonu alır.

HasControls()

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

HasEvents()

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

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

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

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

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

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

SaveViewState() yöntemi tarafından kaydedilen önceki 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şlenin fiziksel yolunu alır.

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

Geçerli Objectbasit bir kopyasını oluşturur.

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

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

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

DataBinding olayını başlatır.

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

Init olayını başlatır.

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

Load olayını başlatır.

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

PreRender olayını başlatır.

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

Unload olayını başlatır.

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

Dosyayı okumak için kullanılan bir Stream 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)
RaiseDataSourceChangedEvent(EventArgs)

DataSourceChanged olayını başlatır.

RemovedControl(Control)

Bir alt denetim Control nesnesinin Controls koleksiyonundan kaldırıldıktan sonra çağrılır.

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

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

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

Sunucu denetiminin alt öğelerinin içeriğini, istemcide işlenecek içeriği yazan sağlanan bir HtmlTextWriter nesnesine gönderir.

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

Sağlanan ControlAdapter nesnesini kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriter nesnesine gönderir.

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

Sunucu denetimi içeriğini sağlanan bir HtmlTextWriter nesnesine gönderir ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

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 url'ye dönüştürür.

(Devralındığı yer: Control)
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, 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)
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)
ToString()

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

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

Sunucu denetiminin StateBag nesnesinde depolanabilmeleri için, sunucu denetiminde görünüm durumu değişikliklerinin izlenmesine neden olur. Bu nesneye ViewState özelliği aracılığıyla 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 Page nesnesine yüklendiğinde gerçekleşir.

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

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

(Devralındığı yer: Control)
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

Veri kaynağı denetimi, veriye bağlı denetimleri etkileyecek şekilde değiştiğinde gerçekleşir.

IDataSource.GetView(String)

DataSourceControl denetimiyle ilişkili adlandırılmış DataSourceView nesnesini alır. Bazı veri kaynağı denetimleri yalnızca bir görünümü desteklerken, diğerleri birden fazla görünümü destekler.

IDataSource.GetViewNames()

DataSourceControl denetimiyle ilişkili DataSourceView nesnelerinin listesini temsil eden bir ad koleksiyonu alır.

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)
IListSource.ContainsListCollection

Veri kaynağı denetiminin bir veya daha fazla veri listesiyle ilişkili olup olmadığını gösterir.

IListSource.GetList()

Veri listesi kaynağı olarak kullanılabilecek veri kaynağı denetimlerinin listesini alır.

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 meta tablo 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.