DataSourceControl Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
- 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 |
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 |
FindControl(String) |
Belirtilen |
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. |