IWebPartRow Arabirim
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.
Tek bir veri alanı kullanarak iki sunucu denetimini bağlamak için bir sağlayıcı arabirimi tanımlar.
public interface class IWebPartRowpublic interface IWebPartRowtype IWebPartRow = interfacePublic Interface IWebPartRowÖrnekler
Aşağıdaki kod örneği, arabirimini kullanarak IWebPartRow iki denetim arasında statik bağlantı oluşturmayı gösterir. Kod örneğinin üç bölümü vardır:
Arabirim kullanılarak bağlantı oluşturabilen, bir denetimin IWebPartRow sağlayıcı, diğeri ise tüketici olarak hareket eden iki özel WebPart denetimin kaynak kodu.
Denetimleri barındıran ve statik bağlantıyı kalıcılık biçiminde bildiren bir Web sayfası.
Örnek kod çalıştırıldığında ne olacağının açıklaması.
Kod örneğinin ilk bölümü, iki özel denetimin kaynak kodudur. İlk olarak, arabirimini uygulayan sağlayıcının IWebPartRow kodudur. Örnekte kolaylık olması için sağlayıcı, veritabanına bağlanmak yerine bazı verilerle bir tablo oluşturur.
GetConnectionInterface yöntemi, sağlayıcının bağlantı noktası olarak hizmet verir ve arabirim örneğini tüketiciye döndüren geri çağırma yöntemidir. Tüketiciye gelince, bir öznitelikle ConnectionConsumer işaretlenmiş adlı SetConnectionInterfaceyönteminde sağlayıcıdan arabirim örneğini alır. Tüketici, arabiriminin örneğini aldıktan sonra yönteminde OnPreRender , gerçek verileri almak ve sayfaya yazmak için sağlayıcıda yönteminin uygulamasını GetRowData çağırır.
Kod örneğinin çalışması için bu kaynak kodunu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin App_Code klasörüne koyabilirsiniz; burada çalışma zamanında dinamik olarak derlenir. Bu kod örneği dinamik derleme kullanır. Derlemeyi gösteren bir izlenecek yol için bkz . İzlenecek Yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.
using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Reflection;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
// This sample code creates a Web Parts control that acts as a provider
// of row data.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class RowProviderWebPart : WebPart, IWebPartRow
{
private DataTable _table;
public RowProviderWebPart()
{
_table = new DataTable();
DataColumn col = new DataColumn();
col.DataType = typeof(string);
col.ColumnName = "Name";
_table.Columns.Add(col);
col = new DataColumn();
col.DataType = typeof(string);
col.ColumnName = "Address";
_table.Columns.Add(col);
col = new DataColumn();
col.DataType = typeof(int);
col.ColumnName = "ZIP Code";
_table.Columns.Add(col);
DataRow row = _table.NewRow();
row["Name"] = "John Q. Public";
row["Address"] = "123 Main Street";
row["ZIP Code"] = 98000;
_table.Rows.Add(row);
}
[ConnectionProvider("Row")]
public IWebPartRow GetConnectionInterface()
{
return new RowProviderWebPart();
}
public PropertyDescriptorCollection Schema
{
get
{
return TypeDescriptor.GetProperties(_table.DefaultView[0]);
}
}
public void GetRowData(RowCallback callback)
{
callback(_table.Rows);
}
} // RowProviderWebPart
// This sample code creates a Web Parts control that acts as a consumer
// of row data.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class RowConsumerWebPart : WebPart
{
private IWebPartRow _provider;
private ICollection _tableData;
private void GetRowData(object rowData)
{
_tableData = (ICollection)rowData;
}
protected override void OnPreRender(EventArgs e)
{
if (_provider != null)
{
_provider.GetRowData(new RowCallback(GetRowData));
}
}
protected override void RenderContents(HtmlTextWriter writer)
{
if (_provider != null)
{
PropertyDescriptorCollection props = _provider.Schema;
int count = 0;
if (props != null && props.Count > 0 && _tableData != null)
{
foreach (PropertyDescriptor prop in props)
{
foreach (DataRow o in _tableData)
{
writer.Write(prop.DisplayName + ": " + o[count]);
writer.WriteBreak();
writer.WriteLine();
count = count + 1;
}
}
}
else
{
writer.Write("No data");
}
}
else
{
writer.Write("Not connected");
}
}
[ConnectionConsumer("Row")]
public void SetConnectionInterface(IWebPartRow provider)
{
_provider = provider;
}
} // RowConsumerWebPart
} // Samples.AspNet.CS.Controls
Imports System.Collections
Imports System.ComponentModel
Imports System.Data
Imports System.Reflection
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
' This sample code creates a Web Parts control that acts as a provider
' of row data.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class RowProviderWebPart
Inherits WebPart
Implements IWebPartRow
Private _table As DataTable
Public Sub New()
_table = New DataTable()
Dim col As New DataColumn()
col.DataType = GetType(String)
col.ColumnName = "Name"
_table.Columns.Add(col)
col = New DataColumn()
col.DataType = GetType(String)
col.ColumnName = "Address"
_table.Columns.Add(col)
col = New DataColumn()
col.DataType = GetType(Integer)
col.ColumnName = "ZIP Code"
_table.Columns.Add(col)
Dim row As DataRow = _table.NewRow()
row("Name") = "John Q. Public"
row("Address") = "123 Main Street"
row("ZIP Code") = 98000
_table.Rows.Add(row)
End Sub
<ConnectionProvider("Row")> _
Public Function GetConnectionInterface() As IWebPartRow
Return New RowProviderWebPart()
End Function 'GetConnectionInterface
Public ReadOnly Property Schema() As _
ComponentModel.PropertyDescriptorCollection Implements IWebPartRow.Schema
Get
Return TypeDescriptor.GetProperties(_table.DefaultView(0))
End Get
End Property
Public Sub GetRowData(ByVal callback As RowCallback) _
Implements IWebPartRow.GetRowData
callback(_table.Rows)
End Sub
End Class
' This sample code creates a Web Parts control that acts as a consumer
' of row data.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class RowConsumerWebPart
Inherits WebPart
Private _provider As IWebPartRow
Private _tableData As ICollection
Private Sub GetRowData(ByVal rowData As Object)
_tableData = CType(rowData, ICollection)
End Sub
Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
If Not (_provider Is Nothing) Then
_provider.GetRowData(New RowCallback(AddressOf GetRowData))
End If
End Sub
Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
If Not (_provider Is Nothing) Then
Dim props As PropertyDescriptorCollection = _provider.Schema
Dim count As Integer = 0
If Not (props Is Nothing) AndAlso props.Count > 0 _
AndAlso Not (_tableData Is Nothing) Then
Dim prop As PropertyDescriptor
For Each prop In props
Dim o As DataRow
For Each o In _tableData
writer.Write(prop.DisplayName & ": " & o(count))
writer.WriteBreak()
writer.WriteLine()
count = count + 1
Next o
Next prop
Else
writer.Write("No data")
End If
Else
writer.Write("Not connected")
End If
End Sub
<ConnectionConsumer("Row")> _
Public Sub SetConnectionInterface(ByVal provider As IWebPartRow)
_provider = provider
End Sub
End Class
End Namespace ' Samples.AspNet.VB.Controls
Kod örneğinin ikinci bölümü, statik bağlantıyı bildiren ve denetimleri barındıran Web sayfasıdır. Sayfanın üst kısmında, App_Code dizininde yer alan kaynak kodun ad alanını bildiren bir Register yönerge bulunur. Bağlantı bir <asp:webpartconnection> öğe kullanılarak bildirilir. Özel tüketici ve sağlayıcı denetimleri, bir öğenin içindeki bir <zonetemplate><asp:webpartzone> öğede bildirilir ve bu da bağlanabilmeleri için gereklidir (sınıftan WebPartZoneBase devralan bir bölgede bulunmalıdır).
<%@ page language="C#" %>
<%@ Register tagprefix="IRow"
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>IRow Test Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:webpartmanager ID="WebPartManager1" runat="server">
<staticconnections>
<asp:webpartconnection ID="wp1" ProviderID="provider1"
ConsumerID="consumer1">
</asp:webpartconnection>
</staticconnections>
</asp:webpartmanager>
<asp:webpartzone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<irow:RowProviderWebPart ID="provider1" runat="server"
Title="Row Provider Control" />
<irow:RowConsumerWebPart ID="consumer1" runat="server"
Title="Row Consumer Control" />
</ZoneTemplate>
</asp:webpartzone>
</div>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ Register tagprefix="IRow"
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>IRow Test Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:webpartmanager ID="WebPartManager1" runat="server">
<staticconnections>
<asp:webpartconnection ID="wp1" ProviderID="provider1"
ConsumerID="consumer1">
</asp:webpartconnection>
</staticconnections>
</asp:webpartmanager>
<asp:webpartzone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<irow:RowProviderWebPart ID="provider1" runat="server"
Title="Row Provider Control" />
<irow:RowConsumerWebPart ID="consumer1" runat="server"
Title="Row Consumer Control" />
</ZoneTemplate>
</asp:webpartzone>
</div>
</form>
</body>
</html>
Sayfayı bir tarayıcıda yükleyin. Tüketici denetimi, sağlayıcının arabirimin bir örneği IWebPartRow aracılığıyla kullanılabilir hale getirdiği belirtilen satırdan sağlanan verileri görüntüler.
Açıklamalar
Bu arabirim, Web Bölümleri bağlantılarıyla kullanılacak şekilde tasarlanmıştır. Web Bölümleri bağlantısında, bir WebPartZoneBase bölgede bulunan iki sunucu denetimi bir bağlantı kurar ve verileri paylaşır ve bir denetim tüketici, diğer denetim ise sağlayıcı görevi görür. Web Bölümleri bağlantısında veri paylaşma mekanizması, sağlayıcının bir geri çağırma yöntemi aracılığıyla tüketiciye hizmet ettiği bir arabirim örneğidir. Bağlantı kurmak için hem tüketicinin hem de sağlayıcının veri paylaşımı için aynı arabirim türüyle çalışması gerekir. Tüketici sağlayıcı tarafından gönderilen arabirim türünü tanımıyorsa, sağlayıcı tarafından gönderilen arabirim örneğini tüketicinin tanıdığı bir türe çeviren bir transformatör ( WebPartTransformer nesne) yoluyla denetimleri bağlamak yine de mümkündür. Bağlantılarla ilgili ayrıntılar için bkz WebPartConnection . ve Web Bölümleri Bağlantılarına Genel Bakış.
Arabirim IWebPartRow , veri satırına dayalı bağlantılar oluşturmak için standart bir arabirim olarak ayarlanan Web Bölümleri denetimine dahil edilen bir sağlayıcı arabirimidir. Web Bölümleri bağlantılarıyla kullanmak için özel arabirimler de oluşturabilirsiniz, ancak veri odaklı birçok Web uygulamasında, veri kaynağından ortak bir alana (ayrıntılar için, arabirime bakın), tabloya (ayrıntılar için arabirimine bakın IWebPartFieldIWebPartTable ) veya satıra dayalı bağlantılar oluşturmak yararlı olur. Tipik bir bağlantıda, sağlayıcı olarak davranan bir WebPart denetim arabirimi uygular IWebPartRow ve özel bir geri çağırma yönteminde tüketicilere arabirimin bir örneğini sağlar. Örneğin sağlayıcı, kullanıcı bilgileri tablonuzdaki bir kullanıcıya karşılık gelen bir satır için arabirim uygulayabilir IWebPartRow . Tüketici olarak davranan başka WebPart bir denetim, arabirim örneğini almak için özel bir yöntem tanımlar ve ardından kullanıcı verilerini ayıklayabilir, bu kullanıcının hesapları hakkında ek bilgi aramak ve bu kullanıcıyla ilgili tüm bilgileri sayfada görüntülemek için kullanabilir.
Arabirimin IWebPartRow kullanıma sunulan iki üyesi vardır. özelliği, Schema bir PropertyDescriptorCollection nesnede kapsüllenen veri satırı hakkındaki şema bilgilerini döndürür. GetRowData yöntemi, bir uygulayıcının (sağlayıcı denetimi gibi) geri çağırma yöntemi çağrıldığında arabirim örneğinin satır verilerini almak için kullandığı bir yöntemi bildirir.
Özellikler
| Schema |
İki WebPart denetim arasında veri paylaşmak için kullanılan bir veri satırının şema bilgilerini alır. |
Yöntemler
| GetRowData(RowCallback) |
İki WebPart denetim arasındaki bağlantının temeli olarak arabirim tarafından kullanılan satırın verilerini döndürür. |
