WebPartConnection Klasse

Definition

Stellt ein Objekt bereit, das zwei WebPart-Steuerelementen das Herstellen einer Verbindung ermöglicht.Provides an object that enables two WebPart controls to form a connection. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class WebPartConnection sealed
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class WebPartConnection
type WebPartConnection = class
Public NotInheritable Class WebPartConnection
Vererbung
WebPartConnection
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine einfache Verbindung zwischen zwei WebPart -Steuerelementen erstellt wird.The following code example demonstrates how to create a simple connection between two WebPart controls. Das Beispiel veranschaulicht drei Methoden zum Herstellen einer Verbindung: deklarativ, indem Tags für die Verbindung im Markup der Webseite platziert werden. Programm gesteuert, durch Erstellen der Verbindung im Code; und über die Benutzeroberfläche, indem Sie ConnectionsZone ein-Steuerelement auf der Seite platzieren, mit dem Benutzer eine Verbindung herstellen können.The example demonstrates three ways of forming a connection: declaratively, by placing tags for the connection in the markup of the Web page; programmatically, by creating the connection in code; and through the UI, by placing a ConnectionsZone control on the page, which enables users to establish a connection.

Das Codebeispiel besteht aus vier Teilen:The code example has four parts:

  • Ein Benutzer Steuerelement, mit dem Sie den Webparts Anzeigemodus auf einer Seite ändern können.A user control that enables you to change the Web Parts display mode on a page.

  • Quellcode für eine Schnittstelle und zwei WebPart Steuerelemente, die als Anbieter und der Consumer für eine Verbindung fungieren.Source code for an interface and two WebPart controls acting as the provider and the consumer for a connection.

  • Eine Webseite zum Hosten aller Steuerelemente und zum Ausführen des Code Beispiels.A Web page to host all the controls and run the code example.

  • Eine Erläuterung zum Ausführen der Beispielseite.An explanation of how to run the example page.

Der erste Teil dieses Code Beispiels ist das Benutzer Steuerelement, das es Benutzern ermöglicht, Anzeigemodi auf einer Webseite zu ändern.The first part of this code example is the user control that enables users to change display modes on a Web page. Speichern Sie den folgenden Quellcode in einer ASCX-Datei. Geben Sie dabei den Dateinamen an, der dem Src -Attribut Register der-Direktive für dieses Benutzer Steuerelement zugewiesen ist, das sich in der Nähe des oberen Rands der hostingwebseite befindet.Save the following source code to an .ascx file, giving it the file name that is assigned to the Src attribute of the Register directive for this user control, which is near the top of the hosting Web page. Ausführliche Informationen zu Anzeigemodi und eine Beschreibung des Quellcodes in diesem Steuerelement finden Sie unter Exemplarische Vorgehensweise: Ändern der Anzeigemodi auf einer WebpartsSeiteFor details about display modes and a description of the source code in this control, see Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Der zweite Teil des Code Beispiels ist der Quellcode für die-Schnittstelle und die-Steuerelemente.The second part of the code example is the source code for the interface and controls. Die Quelldatei enthält eine einfache Schnittstelle IZipCodemit dem Namen.The source file contains a simple interface named IZipCode. Es gibt auch eine WebPart Klasse mit ZipCodeWebPart dem Namen, die die-Schnittstelle implementiert und als Anbieter Steuerelement fungiert.There is also a WebPart class named ZipCodeWebPart that implements the interface and acts as the provider control. Die ProvideIZipCode -Methode ist die Rückruf Methode, die das einzige Member der-Schnittstelle implementiert.Its ProvideIZipCode method is the callback method that implements the interface's only member. Die-Methode gibt einfach eine Instanz der-Schnittstelle zurück.The method simply returns an instance of the interface. Beachten Sie, dass die-Methode in ConnectionProvider Ihren Metadaten mit einem-Attribut gekennzeichnet ist.Note that the method is marked with a ConnectionProvider attribute in its metadata. Dies ist der Mechanismus, mit dem die Methode als Rückruf Methode für den Verbindungspunkt des Anbieters identifiziert wird.This is the mechanism for identifying the method as the callback method for the provider's connection point. Die andere WebPart Klasse hat den WeatherWebPartNamen und fungiert als Consumer für die Verbindung.The other WebPart class is named WeatherWebPart, and it acts as the consumer for the connection. Diese Klasse verfügt über eine Methode GetZipCode IZipCode mit dem Namen, die eine Instanz der-Schnittstelle aus dem Anbieter Steuerelement abruft.This class has a method named GetZipCode that gets an instance of the IZipCode interface from the provider control. Beachten Sie, dass diese Methode als Verbindungspunkt Methode des Consumers mit einem ConnectionConsumer -Attribut in den Metadaten gekennzeichnet ist.Note that this method is marked as the consumer's connection point method with a ConnectionConsumer attribute in its metadata.

Damit das Codebeispiel ausgeführt werden kann, müssen Sie diesen Quellcode kompilieren.For the code example to run, you must compile this source code. Sie können Sie explizit kompilieren und die resultierende Assembly in den bin-Ordner der Website oder in den globalen Assemblycache einfügen.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Alternativ dazu können Sie den Quellcode in den Ordner "App_Code" der Website einfügen, wo er zur Laufzeit dynamisch kompiliert wird.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. In diesem Codebeispiel wird die dynamische Kompilierung verwendet.This code example uses dynamic compilation. Eine exemplarische Vorgehensweise, die die Kompilierung veranschaulicht , finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserver-Steuer Elements.For a walkthrough that demonstrates how to compile, see Walkthrough: Developing and Using a Custom Web Server Control.

namespace Samples.AspNet.CS.Controls
{
  using System;
  using System.Web;
  using System.Web.Security;
  using System.Security.Permissions;
  using System.Web.UI;
  using System.Web.UI.WebControls;
  using System.Web.UI.WebControls.WebParts;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code Provider", "ZipCodeProvider")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }

  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }

  }
}
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code Provider", "ZipCodeProvider")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code Consumer", "ZipCodeConsumer")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
                DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

Der dritte Teil des Code Beispiels ist die Webseite.The third part of the code example is the Web page. Oben sind die Register Anweisungen für das Benutzer Steuerelement und die benutzerdefinierten WebPart Steuerelemente.Near the top are the Register directives for the user control and the custom WebPart controls. Da im Beispiel die dynamische Kompilierung der Steuerelemente angenommen wird, sollte sich der Quellcode für die Steuerelemente in einem App_Code-Unterordner befinden. Das Register -Tag auf der Seite verweist nur auf ein beliebiges Tagpräfix und den Namespace der Steuerelemente.Because the example assumes dynamic compilation of the controls, the source code for the controls should be in an App_Code subfolder; the Register tag in the page references only an arbitrary tag prefix and the namespace of the controls. Die Benutzer WebPart definierten Steuerelemente (der Anbieter und der Consumer) werden im-Element <asp:webpartzone> der Webseite innerhalb eines <zonetemplate> -Elements deklariert.The custom WebPart controls (the provider and consumer) are declared within the Web page's <asp:webpartzone> element, inside a <zonetemplate> element.

Die Seite bietet drei Möglichkeiten, eine Verbindung zwischen den benutzerdefinierten Steuerelementen herzustellen.The page provides three ways to form a connection between the custom controls. Die erste Methode ist deklarativ.The first method is declarative. Im Markup für die Seite wird ein <StaticConnections> -Element deklariert, und innerhalb von ist ein <asp:WebPartConnections> -Element, wobei die verschiedenen Consumer-und Anbieter Details der Verbindung als Attribute angegeben werden.In the markup for the page, a <StaticConnections> element is declared, and within that is an <asp:WebPartConnections> element, with the various consumer and provider details of the connection specified as attributes. Dies ist eine Möglichkeit, eine Verbindung zu erstellen, indem Sie direkt auf der Webseite deklariert wird, insbesondere innerhalb <asp:WebPartManager> des-Elements.This is one way to create a connection, by declaring it directly in the Web page, specifically within the <asp:WebPartManager> element. Aufgrund dieser statischen Verbindung wird beim ersten Laden der Seite sofort eine Verbindung zwischen den beiden benutzerdefinierten Steuerelementen erstellt.Because of this static connection, a connection between the two custom controls is created immediately the first time the page loads.

Eine zweite Methode zum bilden einer Verbindung zwischen den-Steuerelementen wird durch <asp:connectionszone> das-Element auf der Seite bereitgestellt.A second method for forming a connection between the controls is provided by the <asp:connectionszone> element in the page. Wenn ein Benutzer zur Laufzeit eine Seite in den Verbindungsanzeige Modus wechselt und auf ein Connect-Verb in einem der benutzerdefinierten Steuerelemente klickt <asp:connectionszone> , rendert das Element automatisch die Benutzeroberfläche zum Erstellen einer Verbindung.If a user switches a page into connect display mode at run time, and clicks a connect verb on one of the custom controls, the <asp:connectionszone> element automatically renders the UI for creating a connection.

Die Seite zeigt auch eine dritte Methode zum Erstellen einer Verbindung, die Sie Programm gesteuert ausführen muss.The page also demonstrates a third way of creating a connection, which is to do it programmatically. In der Button1_Click -Methode erstellt der Code ein ProviderConnectionPoint -Objekt für das Anbieter Steuerelement und ruft seine Verbindungspunkt Details durch Aufrufen der GetProviderConnectionPoints -Methode ab.In the Button1_Click method, the code creates a ProviderConnectionPoint object for the provider control, and retrieves its connection point details by calling the GetProviderConnectionPoints method. Sie führt eine ähnliche Aufgabe für das Consumer-Steuerelement aus und GetConsumerConnectionPoints Ruft die-Methode auf.It carries out a similar task for the consumer control, calling the GetConsumerConnectionPoints method. Schließlich wird das neue WebPartConnection -Objekt durch Aufrufen der ConnectWebParts -Methode für das WebPartManager -Steuerelement erstellt.Finally, it creates the new WebPartConnection object by calling the ConnectWebParts method on the WebPartManager control.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuCS"
    Src="~/displaymodemenucs.ascx" %>
<%@ 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">
<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    ProviderConnectionPoint provPoint = 
      mgr.GetProviderConnectionPoints(zip1)["ZipCodeProvider"];
    ConsumerConnectionPoint connPoint = 
      mgr.GetConsumerConnectionPoints(weather1)["ZipCodeConsumer"];
    WebPartConnection conn1 = mgr.ConnectWebParts(zip1, provPoint,
      weather1, connPoint);
  }

  protected void mgr_DisplayModeChanged(object sender, 
    WebPartDisplayModeEventArgs e)
  {
    if (mgr.DisplayMode == WebPartManager.ConnectDisplayMode)
      Button1.Visible = true;
    else
      Button1.Visible = false;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" 
    OnDisplayModeChanged="mgr_DisplayModeChanged">
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1"
            ProviderConnectionPointID="ZipCodeProvider"
            ProviderID="zip1" />
        </StaticConnections>
      </asp:WebPartManager>
      <uc1:DisplayModeMenuCS ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" 
    Visible="false" />
    </div>
    </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuVB"
    Src="~/displaymodemenuvb.ascx" %>
<%@ 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">
<script runat="server">

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Dim provPoint As ProviderConnectionPoint = _
      mgr.GetProviderConnectionPoints(zip1)("ZipCodeProvider")
    Dim connPoint As ConsumerConnectionPoint = _
      mgr.GetConsumerConnectionPoints(weather1)("ZipCodeConsumer")
    mgr.ConnectWebParts(zip1, provPoint, weather1, connPoint)

  End Sub

  Protected Sub mgr_DisplayModeChanged (ByVal sender as Object, _
    ByVal e as WebPartDisplayModeEventArgs)

    If mgr.DisplayMode Is WebPartManager.ConnectDisplayMode Then
    Button1.Visible = True
    Else
    Button1.Visible = False
    End If

  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server" 
    OnDisplayModeChanged="mgr_DisplayModeChanged">
        <StaticConnections>
          <asp:WebPartConnection ID="conn1"
            ConsumerConnectionPointID="ZipCodeConsumer"
            ConsumerID="weather1"
            ProviderConnectionPointID="ZipCodeProvider"
            ProviderID="zip1" />
        </StaticConnections>
      </asp:WebPartManager>
      <uc1:DisplayModeMenuVB ID="menu1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" runat="server"
            Title="Zip Code Provider" />
          <aspSample:WeatherWebPart ID="weather1" runat="server" 
            Title="Zip Code Consumer" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server">
      </asp:ConnectionsZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Connect WebPart Controls" 
        OnClick="Button1_Click" 
    Visible="false" />
    </div>
    </form>
</body>
</html>

Nachdem Sie die Webseite in einem Browser geladen haben, ist die erste Verbindung bereits vorhanden, da Sie im <StaticConnections> -Element deklariert ist.After you load the Web page in a browser, the first connection already exists because it is declared within the <StaticConnections> element. Geben Sie Text im Steuerelement für die Postleitzahl ein, das im Steuerelement "Consumer" angezeigt wird.Enter some text in the ZIP Code Provider control, and it will be displayed in the consumer control. Trennen Sie als nächstes die beiden-Steuerelemente.Next, disconnect the two controls. Ändern Sie die Seite mithilfe des Dropdown Listen-Steuer Elements Anzeigemodus in Verbindungsanzeige Modus.Using the Display Mode drop-down list control, change the page to connect display mode. Klicken Sie für jedes WebPart Steuerelement auf das Verbenmenü (dargestellt durch einen abwärts Pfeil in der Titelleiste), und beachten Sie, dass jedes Steuerelement über eine Connect -Option verfügt.Click the verbs menu (represented by a downward arrow in the title bar) for each of the WebPart controls, and notice that each has a Connect option. Dies ist ein Connect-Verb, das im Verbenmenü nur angezeigt wird, wenn sich die Seite im Verbindungs Modus befindet.This is a connect verb, which appears in the verbs menu only when the page is in connect mode. Klicken Sie auf das Connect-Verb für eines der- ConnectionsZone Steuerelemente, und die vom-Steuerelement bereitgestellte Verbindungs Benutzeroberfläche wird angezeigt.Click the connect verb on one of the controls, and the connection UI provided by the ConnectionsZone control appears. Klicken Sie auf die Schaltfläche trennen , um die statische Verbindung zwischen den Steuerelementen zu beenden.Click the Disconnect button to end the static connection between the controls. Verwenden Sie das Steuerelement Anzeigemodus , um die Seite in den Durchsuchenmodus zurückzukehrenUse the Display Mode control to return the page to browse mode. Versuchen Sie erneut, einen neuen Text in den Anbieter einzugeben, und beachten Sie, dass der Text im Consumer-Steuerelement nicht aktualisiert werden kann, da die Steuerelemente getrennt werden.Try to enter some new text in the provider again, and note that because the controls are disconnected, the text fails to update in the consumer control.

Verwenden Sie als nächstes dieselbe Methode wie oben, um die Seite erneut in den Verbindungsanzeige Modus zu wechseln.Next, use the same method as above to switch the page into connect display mode again. Klicken Sie auf ein Connect-Verb für eines der-Steuerelemente.Click a connect verb on one of the controls. Klicken Sie auf den Link Verbindung erstellen , und verwenden Sie die Benutzeroberfläche ConnectionsZone , die vom Steuerelement bereitgestellt wird, um eine Verbindung zwischen den Steuerelementen herzustellen.Click the Create a Connection link, and use the UI provided by the ConnectionsZone control to create a connection between the controls. Dies ist die zweite Methode zum Erstellen einer Verbindung.This is the second method for creating a connection. Beachten Sie, dass die letzte Zeichenfolge, die Sie im Anbieter Steuerelement eingegeben haben (die nicht angezeigt werden konnte, weil die Steuerelemente getrennt wurden), plötzlich im Consumer angezeigt wird, da die Verbindung neu erstellt wurde.Note that as soon as the connection is formed, the last string you entered in the provider control (that failed to appear because the controls were disconnected) suddenly appears in the consumer, because the connection has been recreated. Klicken Sie auf die Schaltfläche " trennen ", um die soeben erstellte aktuelle Verbindung zu beenden.Click the Disconnect button to end the current connection that you just created. Die Seite wird in den Durchsuchenmodus zurückgegeben.Return the page to browse mode. Geben Sie im Anbieter einen neuen Text ein, um zu veranschaulichen, dass der Text nicht aktualisiert wurde und dass die Steuerelemente wieder getrennt werden.Enter some new text in the provider to demonstrate that the text is not updated, and that the controls are again disconnected.

Hiermit wird die Seite zum Verbindungsanzeige Modus zurückgegeben.Return the page to connect display mode. Anstatt auf ein Connect-Verb zu klicken, klicken Sie auf die Schaltfläche WebPart-Steuerelemente verbinden , die die dritte Methode zum bilden einer Verbindung veranschaulicht.Instead of clicking a connect verb, click the Connect WebPart Controls button, which illustrates the third method of forming a connection. Bei diesem Ansatz werden die Steuerelemente in einem einfachen Schritt Programm gesteuert verbunden, ohne ConnectionsZone dass das Steuerelement verwendet werden muss.This approach connects the controls programmatically in one simple step without having to use the ConnectionsZone control. Beachten Sie, dass die letzte Zeichenfolge, die Sie im Anbieter eingegeben haben, beim Erstellen der Verbindung plötzlich im Consumer-Steuerelement angezeigt wird.Note that as the connection is created, the last string you entered in the provider suddenly appears in the consumer control.

Hinweise

Im Webparts Steuerelement Satz ist eine Verbindung eine Verknüpfung oder eine Zuordnung zwischen zwei WebPart (oder anderen Server-oder Benutzer Steuerelementen), mit deren Hilfe Sie Daten freigeben können.In the Web Parts control set, a connection is a link or association between two WebPart (or other server or user) controls that enables them to share data. Diese Möglichkeit der Freigabe von Daten ermöglicht die Verwendung verbundener Steuerelemente auf eine Weise, die die von den isolierten Steuerelementen angebotene Funktionalität überschreitet.This ability to share data allows connected controls to be used in ways that exceed the functionality offered by the isolated controls. Wenn z. b. ein Steuerelement Postal Code-Daten bereitstellt und ein anderes Steuerelement diese Daten lesen und lokale Wetterinformationen auf der Postleitzahl bereitstellen kann, bietet die verbundene Funktion der beiden Steuerelemente Benutzern mehr Wert.For example, if one control provides postal code data, and another control can read that data and provide local weather information based on the postal code, then the connected capability of the two controls provides more value to users. Um dieses Beispiel zu erweitern, können andere Steuerelemente erstellt werden, die auch Informationen auf der Grundlage einer Postleitzahl anzeigen, z. b. ein Steuerelement mit Links zu lokalen Nachrichten, und alle diese Steuerelemente, die mit Postleitzahl arbeiten können, können Daten mit dem einzelnen Steuerelement freigeben, das eine Postleitzahl.To extend this example, other controls could be created that also display information based on a postal code, such as a control with links to local news, and all these controls that can work with postal code data could share data with the single control that provides a postal code. Endbenutzer von Webparts Anwendungen können Verbindungen zwischen allen solchen kompatiblen Steuerelementen direkt über einen Webbrowser erstellen und verwalten, indem Sie die Benutzeroberfläche der Standardverbindungen verwenden, die vom ConnectionsZone Steuerelement bereitgestellt wird, oder eine benutzerdefinierte Benutzeroberfläche verwenden, die von einem bereitgestellt wird. Trägers.End users of Web Parts applications can create and manage connections between all such compatible controls directly from a Web browser, using the standard connections user interface (UI) provided by the ConnectionsZone control, or using a custom UI provided by a developer.

Diese WebPartConnection Klassen Übersicht ist eine allgemeine Erklärung der grundlegenden Details zum Erstellen einer Verbindung.This WebPartConnection class overview is a general statement of the basic details for creating a connection. Weitere Informationen zu bestimmten Komponenten und Anforderungen bei der Erstellung von Verbindungen finden Sie unter Übersicht über Webparts Verbindungenoder unter Verweis Klassen und Codebeispiele, die in der folgenden Erörterung erwähnt werden.For more on specific components and requirements involved in creating connections, see Web Parts Connections Overview, or see the reference classes and code examples mentioned in the following discussion. Es gibt mehrere grundlegende Aspekte einer Webparts Verbindung:There are several fundamental aspects of a Web Parts connection:

  • Zwei WebPart -Steuerelemente.Two WebPart controls. Jede Webparts Verbindung besteht aus zwei-Steuerelementen.Every Web Parts connection consists of two controls. Es ist möglich, dass ein Steuerelement gleichzeitig an mehr als einer Verbindung teilnimmt, aber jede einzelne Verbindung besteht aus genau zwei-Steuerelementen.It is possible for a control to participate in more than one connection simultaneously, but every single connection consists of exactly two controls. Die Steuerelemente können direkt von der WebPart Basisklasse abgeleitet werden, oder es kann sich um andere Server Steuerelemente handeln, einschließlich ASP.NET-Steuerelementen, benutzerdefinierte Server Steuerelemente und Benutzer Steuerelemente.The controls can derive directly from the WebPart base class, or they can be other server controls, including ASP.NET controls, custom server controls, and user controls. Steuerelemente, die nicht von der WebPart -Klasse abgeleitet werden,, WebPartZoneBase Wenn Sie in einer Zone platziert werden GenericWebPart , werden zur Laufzeit automatisch mit einem-Objekt umgeschrieben, WebPart sodass Sie von der-Klasse erben WebPart und als Lauf Zeitfunktion verwenden können. Steuerelemente.Controls that do not derive from the WebPart class, if placed in a WebPartZoneBase zone, are automatically wrapped with a GenericWebPart object at run time, which enables them to inherit from the WebPart class and function as run-time WebPart controls.

  • Steuerelemente in WebPartZoneBase Zonen.Controls residing in WebPartZoneBase zones. Beide WebPart Steuerelemente und andere Typen von Server Steuerelementen müssen sich in WebPartZoneBase einer Zone befinden, damit Sie an Webparts Verbindungen (und den meisten anderen Webparts Features) teilnehmen können.Both WebPart controls and any other type of server control must reside in a WebPartZoneBase zone to be able to participate in Web Parts connections (and most other Web Parts features).

  • Consumer und Anbieter.Consumers and providers. In jeder Webparts Verbindung gibt es zwei Steuerelemente: einen Datenanbieter und einen Consumer von Daten.In every Web Parts connection there are two controls: a provider of data and a consumer of data. Der Anbieter stellt Daten über eine angegebene Rückruf Methode, die Daten in Form einer Schnittstelle zurückgibt, an den Consumer.The provider furnishes data to the consumer through a specified callback method that returns data in the form of an interface. (Ein Beispiel für das Erstellen und angeben der Rückruf Methode finden Sie im Beispiel Abschnitt dieses Themas.) Diese Rückruf Methode wird als Anbieter Verbindungspunkt bezeichnet.(For an example of how to create and specify the callback method, see the Example section of this topic.) This callback method is known as a provider connection point. Die Details dieses Verbindungs Punkts (der "freundliche" Name, eine ID und der Typ der zurückgegebenen Schnittstelle) sind in einem ProviderConnectionPoint -Objekt enthalten, das dem Anbieter Steuerelement zugeordnet ist.The details of this connection point (its "friendly" name, an ID, and the type of the returned interface) are contained in a ProviderConnectionPoint object associated with the provider control. Der Consumer empfängt die Daten über eine angegebene Methode, die eine Instanz der Schnittstelle annehmen kann.The consumer receives the data through a specified method that can accept an instance of the interface. Diese Methode wird als Consumerverbindungspunkt bezeichnet, und die Details des Verbindungs Punkts (Name, ID und Typ der Schnittstelle) sind in einem ConsumerConnectionPoint -Objekt enthalten, das dem Consumer-Steuerelement zugeordnet ist.This method is known as a consumer connection point, and the details of the connection point (name, ID, and type of interface) are contained in a ConsumerConnectionPoint object associated with the consumer control.

  • Kompatible Steuerelemente oder ein gültiger Transformator.Compatible controls or a valid transformer. Damit eine Verbindung funktioniert, müssen der Consumer und der Anbieter entweder kompatibel sein (d. h., die angegebenen Verbindungspunkt Methoden können mit demselben Schnittstellentyp funktionieren), oder es muss WebPartTransformer ein-Objekt vorhanden sein, das den vom Anbieter in einen Typ, der vom Consumer verstanden wird.For a connection to work, the consumer and provider must either be compatible (meaning that their specified connection point methods can work with the same type of interface), or there must be a WebPartTransformer object capable of translating the type offered by the provider into a type understood by the consumer.

  • Ein WebPartConnection-Objekt.A WebPartConnection object. Damit eine Verbindung vorhanden ist, muss eine Instanz der WebPartConnection -Klasse vorhanden sein, die Verweise auf den Anbieter und die Consumersteuerelemente sowie die Details ihrer Verbindungspunkte enthält.For a connection to exist, there must be an instance of the WebPartConnection class that contains references to the provider and consumer controls, along with the details of their connection points. Wenn der Anbieter und der Consumer nicht kompatibel sind und stattdessen WebPartTransformer ein-Objekt verwenden, um eine Verbindung herzustellen, verweist die Verbindung auf den Transformator.If the provider and consumer are incompatible and instead use a WebPartTransformer object to connect, the connection references the transformer.

  • Eine Möglichkeit zum Herstellen der Verbindung.A means of establishing the connection. Nachdem kompatible Consumer-und Anbieter Steuerelemente ordnungsgemäß mit Verbindungspunkt Methoden entworfen und in einer Zone platziert wurden und WebPartConnection ein-Objekt verfügbar ist, ist der letzte grundlegende Schritt das Initiieren der Verbindung.After compatible consumer and provider controls have been properly designed with connection point methods and placed in a zone, and a WebPartConnection object is available, the last basic step necessary is to initiate the connection. Dies kann beispielsweise der Fall sein, wenn Benutzer die Verbindung über die Benutzeroberfläche erstellen.One way this can happen is for users to create the connection through the UI. Wenn Sie ein <asp:connectionszone> Element auf der Seite platzieren und die anderen erforderlichen Komponenten für eine Verbindung vorhanden sind, kann ein Benutzer zur Laufzeit die Seite in den Verbindungsanzeige Modus wechseln und auf ein Connect-Verb im Verbenmenü des Anbieters oder Consumers klicken. , und eine Verbindungs Benutzeroberfläche (basierend auf ConnectionsZone dem-Steuerelement) wird angezeigt.If you place an <asp:connectionszone> element on the page, and the other required components for a connection are in place, at run time a user can switch the page into connect display mode, click a connect verb on the verbs menu of either the provider or consumer, and a connection UI (based on the ConnectionsZone control) will appear. Über diese Benutzeroberfläche kann der Benutzer die Verbindung initiieren.Through this UI, the user can initiate the connection. Eine andere Möglichkeit, die Verbindung zu initiieren, besteht darin, Sie Programm gesteuert auszuführen.Another way to initiate the connection is to do it programmatically. In jedem Fall, ob über die Benutzeroberfläche oder Programm gesteuert, ist die zugrunde liegende Methode, die die Verbindung initiiert, identisch.In either case, whether through the UI or programmatically, the underlying method that initiates the connection is the same. Die Anwendung ruft die ConnectWebParts -Methode (oder ConnectWebParts die-Methode, wenn ein Transformator verwendet WebPartManager wird) für das-Steuerelement auf, übergibt sie an den Anbieter, den Consumer und die entsprechenden Verbindungs WebPartConnection Punktobjekte, und die Methode gibt zurück. Objekt.The application calls the ConnectWebParts method (or the ConnectWebParts method if using a transformer) on the WebPartManager control, passing to it the provider, the consumer, and their respective connection point objects, and the method returns a WebPartConnection object.

Die WebPartConnection -Klasse definiert ein-Objekt, das die wesentlichen Details einer Verbindung zwischen zwei WebPart -Steuerelementen kapselt.The WebPartConnection class defines an object that encapsulates the essential details of a connection between two WebPart controls. Die-Klasse besteht fast vollständig aus Eigenschaften, die sich auf die Details einer bestimmten Verbindung beziehen.The class consists almost entirely of properties related to the details of a particular connection. Mehrere Eigenschaften betreffen das Consumer-Steuerelement in einer Verbindung.Several properties concern the consumer control in a connection. Die Consumer -Eigenschaft verweist auf das Consumer-Steuerelement ConsumerID selbst, und die-Eigenschaft verweist auf die ID des Consumers.The Consumer property references the consumer control itself, and the ConsumerID property references the consumer's ID. Das ConsumerConnectionPoint -Objekt, das die Details zum Verbindungspunkt des Consumers enthält, wird von der- ConsumerConnectionPoint Eigenschaft des Consumers verwiesen.The ConsumerConnectionPoint object, which contains the details of the consumer's connection point, is referenced by the consumer's ConsumerConnectionPoint property. Die ConsumerConnectionPointID -Eigenschaft verweist ConsumerConnectionPoint auf die ID des Objekts.The ConsumerConnectionPointID property references the ID of the ConsumerConnectionPoint object. Allen diesen consumerbezogenen Verbindungs Eigenschaften muss ein Wert zugewiesen werden, um eine Verbindung herstellen zu können.All these consumer-related connection properties must have a value assigned to them to create a connection.

Die WebPartConnection -Klasse verfügt auch über mehrere Eigenschaften, die sich auf das Anbieter Steuerelement in einer Verbindung beziehen, und diese entsprechen den Eigenschaften für einen Consumer.The WebPartConnection class also has several properties that relate to the provider control in a connection, and these correspond to the properties for a consumer. Die Provider -Eigenschaft verweist auf das Anbieter Steuerelement selbst ProviderID , während die-Eigenschaft auf Ihre ID verweist.The Provider property references the provider control itself, while the ProviderID property references its ID. Die ProviderConnectionPoint -Eigenschaft verweist ProviderConnectionPoint auf das-Objekt ProviderConnectionPointID , und die-Eigenschaft verweist auf die ID des Verbindungs Punkts des Anbieters.The ProviderConnectionPoint property references the ProviderConnectionPoint object, and the ProviderConnectionPointID property references the ID of the provider's connection point.

Mehrere Eigenschaften betreffen den Status der Verbindung.Several properties concern the state of the connection. Die IsActive -Eigenschaft gibt an, ob die Verbindung aktiv ist (zurzeit Daten austauschen) oder inaktiv ist (weiterhin verbunden, aber nicht aktiv Daten freigeben).The IsActive property indicates whether the connection is active (currently exchanging data) or inactive (still connected but not actively sharing data). Die IsShared -Eigenschaft gibt an, ob die Verbindung eine freigegebene (für alle Benutzer einer Seite Verfügbare) oder eine benutzerspezifische Verbindung ist IsStatic , und die-Eigenschaft gibt an, ob das Steuerelement statisch (im Seiten Markup und somit permanent) ist. dynamisch (Programm gesteuert erstellt, was bedeutet, dass Sie gelöscht werden kann).The IsShared property indicates whether the connection is a shared (available to all users of a page) or a user-specific connection, and the IsStatic property indicates whether the control is static (declared in the page markup and thus permanent) or dynamic (created programmatically, meaning that it can be deleted).

Konstruktoren

WebPartConnection()

Initialisiert eine neue Instanz der WebPartConnection-Klasse.Initializes a new instance of the WebPartConnection class.

Eigenschaften

Consumer

Ruft ein WebPart-Objekt ab, das in einer Verbindung als Consumersteuerelement fungiert.Gets a WebPart object that is acting as the consumer control in a connection.

ConsumerConnectionPoint

Ruft das Objekt ab, das als Verbindungspunkt für ein Steuerelement fungiert, das als Consumer in einer Verbindung fungiert.Gets the object that serves as a connection point for a control that is acting as a consumer in a connection.

ConsumerConnectionPointID

Ruft den Eigenschaftswert für eine Verbindung ab, der auf die ID des Objekts verweist, das als Consumerverbindungspunkt für diese Verbindung fungiert, oder legt diesen fest.Gets or sets the property value on a connection that references the ID of the object serving as the consumer connection point for that connection.

ConsumerID

Ruft den Eigenschaftswert für eine Verbindung ab, der auf die ID des WebPart-Steuerelements verweist, das als Consumer für diese Verbindung fungiert, oder legt diesen fest.Gets or sets the property value on a connection that references the ID of the WebPart control acting as a consumer for that connection.

ID

Ruft die ID eines WebPartConnection-Objekts ab oder legt diese fest.Gets or sets the ID of a WebPartConnection object.

IsActive

Ruft einen Wert ab, der angibt, ob ein WebPartConnection-Objekt derzeit eingerichtet und in der Lage ist, Daten zwischen seinem Anbieter- und seinem Consumersteuerelement auszutauschen.Gets a value that indicates whether a WebPartConnection object is currently established and able to exchange data between its provider and consumer controls.

IsShared

Ruft einen Wert ab, der angibt, ob ein WebPartConnection-Objekt für alle Benutzer oder nur für den aktuellen Benutzer sichtbar ist.Gets a value that indicates whether a WebPartConnection object is visible to all users or only to the current user.

IsStatic

Ruft einen Wert ab, der angibt, ob ein WebPartConnection-Objekt im Markup einer Webseite deklariert ist oder programmgesteuert erstellt wird.Gets a value that indicates whether a WebPartConnection object is declared in the markup of a Web page, or created programmatically.

Provider

Ruft ein WebPart-Steuerelement ab, das in einer Webparts-Verbindung als Anbieter fungiert.Gets a WebPart control that acts as the provider in a Web Parts connection.

ProviderConnectionPoint

Ruft das Objekt ab, das als Verbindungspunkt für ein WebPart-Steuerelement fungiert, das als Anbieter in einer Verbindung fungiert.Gets the object that serves as a connection point for a WebPart control acting as a provider for a connection.

ProviderConnectionPointID

Ruft den Eigenschaftswert für eine Verbindung ab, der auf die ID des Objekts verweist, das als Anbieterverbindungspunkt für diese Verbindung fungiert, oder legt diesen fest.Gets or sets the property value on a connection that references the ID of the object serving as the provider connection point for that connection.

ProviderID

Ruft den Eigenschaftswert für eine Verbindung ab, der auf die ID des WebPart-Steuerelements verweist, das als Anbieter für diese Verbindung fungiert, oder legt diesen fest.Gets or sets the property value on a connection that references the ID of the WebPart control acting as a provider for that connection.

Transformer

Ruft ein WebPartTransformer-Objekt ab, mit dessen Hilfe Daten zwischen zwei andernfalls nicht kompatiblen Verbindungspunkten in einer Webparts-Verbindung transformiert werden.Gets a WebPartTransformer object that is used to transform data between two otherwise incompatible connection points in a Web Parts connection.

Transformers

Ruft eine Auflistung von WebPartTransformer-Objekten ab, die vom Webparts-Steuerelementsatz intern verwendet wird.Gets a collection of WebPartTransformer objects used internally by the Web Parts control set.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Überschreibt die geerbte ToString()-Methode und gibt einen kurzen Typnamen für das Verbindungsobjekt zurück.Overrides the inherited ToString() method and returns a short type name for the connection object.

Gilt für:

Siehe auch