IWebPartRow Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert eine Anbieterschnittstelle für das Verbinden von zwei Serversteuerelementen mit einem einzelnen Datenfeld.
public interface class IWebPartRowpublic interface IWebPartRowtype IWebPartRow = interfacePublic Interface IWebPartRowBeispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine statische Verbindung zwischen zwei Steuerelementen mithilfe der IWebPartRow Schnittstelle erstellt wird. Das Codebeispiel verfügt über drei Teile:
Quellcode für zwei benutzerdefinierte WebPart Steuerelemente, die eine Verbindung mit der IWebPartRow Schnittstelle bilden können, wobei ein Steuerelement als Anbieter und der andere als Verbraucher fungiert.
Eine Webseite, die die Steuerelemente hostet und die statische Verbindung im Persistenzformat deklariert.
Eine Beschreibung, was geschieht, wenn der Beispielcode ausgeführt wird.
Der erste Teil des Codebeispiels ist der Quellcode für die beiden benutzerdefinierten Steuerelemente. Zuerst ist der Code für den Anbieter, der die IWebPartRow Schnittstelle implementiert. Für Die Einfachheit im Beispiel erstellt der Anbieter eine Tabelle mit einigen Daten, anstatt eine Verbindung mit einer Datenbank herzustellen. Die GetConnectionInterface Methode dient als Verbindungspunkt des Anbieters, die Rückrufmethode, die die Schnittstelleninstanz an den Verbraucher zurückgibt. Wie für den Verbraucher ruft er die Schnittstelleninstanz des Anbieters in seiner Methode namens SetConnectionInterfaceab, die mit einem ConnectionConsumer Attribut gekennzeichnet ist. Nach dem Abrufen der Instanz der Schnittstelle ruft der Verbraucher in seiner OnPreRender Methode die Implementierung GetRowData der Methode im Anbieter auf, um die tatsächlichen Daten abzurufen und auf die Seite zu schreiben.
Zum Ausführen des Codebeispiels müssen Sie diesen Quellcode kompilieren. Sie können es explizit kompilieren und die resultierende Assembly in den Bin-Ordner Ihrer Website oder den globalen Assemblycache einfügen. Alternativ können Sie den Quellcode in den App_Code Ordner Ihrer Website einfügen, wo sie zur Laufzeit dynamisch kompiliert wird. In diesem Codebeispiel wird die dynamische Kompilierung verwendet. Eine exemplarische Vorgehensweise zum Kompilieren finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserversteuerelements.
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
Der zweite Teil des Codebeispiels ist die Webseite, die die statische Verbindung deklariert und die Steuerelemente hostet. Am oberen Rand der Seite ist eine Register Richtlinie, die den Namespace des Quellcodes deklariert, der im App_Code-Verzeichnis enthalten ist. Die Verbindung wird mithilfe eines <asp:webpartconnection> Elements deklariert. Die benutzerdefinierten Consumer- und Anbietersteuerelemente werden in einem Element innerhalb eines Elements deklariert, das für sie erforderlich ist, um eine Verbindung herzustellen (sie müssen sich in einer <zonetemplate> <asp:webpartzone> Zone befinden, die von der WebPartZoneBase Klasse erbt).
<%@ 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>
Laden Sie die Seite in einem Browser. Das Verbrauchersteuerelement zeigt die von der angegebenen Zeile bereitgestellten Daten an, die der Anbieter über eine Instanz der IWebPartRow Schnittstelle verfügbar macht.
Hinweise
Diese Schnittstelle ist für die Verwendung mit Webparts Verbindungen konzipiert. In einer Webparts Verbindung stellen zwei Serversteuerelemente, die sich in einer WebPartZoneBase Zone befinden, eine Verbindung her und Teilen von Daten, wobei ein Steuerelement als Verbraucher und das andere Steuerelement fungiert, das als Anbieter fungiert. Der Mechanismus zum Freigeben von Daten in einer Webparts-Verbindung ist eine Schnittstelleninstanz, die der Anbieter dem Verbraucher mittels einer Rückrufmethode dient. Um eine Verbindung herzustellen, muss der Verbraucher und Der Anbieter beide mit demselben Schnittstellentyp für die Freigabe von Daten arbeiten. Wenn der Verbraucher den vom Anbieter gesendeten Schnittstellentyp nicht erkennt, ist es weiterhin möglich, die Steuerelemente mithilfe eines Transformators (eines WebPartTransformer Objekts) zu verbinden, die die vom Anbieter gesendete Schnittstelleninstanz in einen Typ übersetzt, den der Verbraucher erkennt. Ausführliche Informationen zu Verbindungen finden Sie unter WebPartConnection und Webparts Übersicht über Verbindungen.
Die IWebPartRow Schnittstelle ist eine Anbieterschnittstelle, die mit dem Webparts Steuerelementsatz als Standardschnittstelle für das Erstellen von Verbindungen basierend auf einer Datenzeile enthalten ist. Sie können auch benutzerdefinierte Schnittstellen erstellen, die mit Webparts Verbindungen verwendet werden sollen, aber in vielen datengesteuerten Webanwendungen ist es nützlich, Verbindungen basierend auf einem allgemeinen Feld zu erstellen (ausführliche IWebPartField Informationen finden Sie in der Schnittstelle), Tabelle (IWebPartTableweitere Informationen finden Sie in der Schnittstelle) oder Zeile aus der Datenquelle. In einer typischen Verbindung würde ein WebPart Steuerelement, das als Anbieter fungiert, die IWebPartRow Schnittstelle implementieren und eine Instanz der Schnittstelle für Verbraucher in einer speziellen Rückrufmethode bereitstellen. Der Anbieter kann beispielsweise eine Schnittstelle für eine IWebPartRow Zeile implementieren, die einem Benutzer in der Benutzerinformationstabelle entspricht. Ein anderes WebPart Steuerelement, das als Verbraucher fungiert, definiert eine spezielle Methode zum Empfangen der Schnittstelleninstanz und kann dann die Benutzerdaten extrahieren, verwenden Sie es, um zusätzliche Informationen zu den Konten dieses Benutzers nachzuschlagen und alle Informationen anzuzeigen, die sich auf diesen Benutzer auf der Seite beziehen.
Die IWebPartRow Schnittstelle verfügt über zwei verfügbar gemachte Elemente. Die Schema Eigenschaft gibt Schemainformationen zur Datenzeile zurück, die in einem PropertyDescriptorCollection Objekt gekapselt ist. Die GetRowData Methode deklariert eine Methode, die ein Implementierunger (z. B. ein Anbietersteuerelement) verwendet, um die Zeilendaten der Schnittstelleninstanz abzurufen, wenn die Rückrufmethode aufgerufen wird.
Eigenschaften
| Schema |
Ruft die Schemainformationen für eine Datenzeile ab, mit deren Hilfe von zwei WebPart-Steuerelementen Daten gemeinsam verwendet werden können. |
Methoden
| GetRowData(RowCallback) |
Gibt die Daten für die Zeile zurück, die von der Schnittstelle als Basis einer Verbindung zwischen zwei WebPart-Steuerelementen verwendet wird. |