Gewusst wie: Deklarieren einer statischen Verbindung zwischen zwei Webparts-Steuerelementen

Artikel
10/22/2014

Aktualisiert: November 2007

Entwickler können eine statische Webparts-Verbindung zwischen zwei Serversteuerelementen erstellen, indem Sie die Verbindung im seitenpersistenten Format deklarieren. Eine statische Verbindung wird zu einem dauerhaften Objekt auf einer Webseite, genau wie ein deklariertes Steuerelement. Eine statische Verbindung wird allen Benutzern angezeigt, da sie ein freigegebenes Objekt ist, und das Verbindungsobjekt kann nicht gelöscht werden. Benutzer können aber die Verbindung trennen, wenn sie auf der Benutzeroberfläche über entsprechende Optionen verfügen. Statische Verbindungen sind hilfreich, wenn Sie eine Verbindung möchten, die immer für alle Benutzer verfügbar ist, und wenn Benutzer nicht die Möglichkeit haben sollen, die Verbindung von der Seite zu löschen. Ausführliche Informationen zu Verbindungen finden Sie unter WebPartConnection und Übersicht über Webpartverbindungen. Ausführliche Informationen zu statischen Verbindungen finden Sie unter IsStatic. In diesem Thema wird veranschaulicht, wie eine statische Verbindung zwischen zwei WebPart-Steuerelementen erstellt wird.

Hinweis:
Hauptsächlich wird gezeigt, wie eine statische Verbindung im Markup einer Webseite deklariert wird. Zum Deklarieren einer statischen Webparts-Verbindung zwischen zwei Serversteuerelementen müssen die Steuerelemente ordnungsgemäß zum Behandeln von Verbindungen entwickelt werden und sich in einer WebPartZoneBase-Zone befinden. Eine vollständige Beschreibung der Anforderungen für Steuerelemente, die an Verbindungen teilnehmen, finden Sie unter WebPartConnection. Den Beispielcode für die beiden WebPart-Steuerelemente und die Webseite, die als Host für die in diesem Thema gezeigte statische Verbindung fungiert, finden Sie im Beispielabschnitt für die IsStatic-Eigenschaft.

Hauptsächlich wird gezeigt, wie eine statische Verbindung im Markup einer Webseite deklariert wird. Zum Deklarieren einer statischen Webparts-Verbindung zwischen zwei Serversteuerelementen müssen die Steuerelemente ordnungsgemäß zum Behandeln von Verbindungen entwickelt werden und sich in einer WebPartZoneBase-Zone befinden. Eine vollständige Beschreibung der Anforderungen für Steuerelemente, die an Verbindungen teilnehmen, finden Sie unter WebPartConnection. Den Beispielcode für die beiden WebPart-Steuerelemente und die Webseite, die als Host für die in diesem Thema gezeigte statische Verbindung fungiert, finden Sie im Beispielabschnitt für die IsStatic-Eigenschaft.

So deklarieren Sie Serversteuerelemente innerhalb einer Zone

Fügen Sie ein <webpartzone>-Element im Textbereich einer Webseite hinzu, die Ihre Verbindung enthält, und fügen Sie ein untergeordnetes <zonetemplate>-Element hinzu, das die in der Zone hinzugefügten Serversteuerelemente enthält. Der Code sollte der Darstellung im folgenden Beispiel entsprechen:
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
  </ZoneTemplate>
</asp:WebPartZone>
```
Deklarieren Sie zwischen den Tags des <zonetemplate>-Elements die Serversteuerelemente, die als Anbieter- und Consumersteuerelemente in einer Webparts-Verbindung verwendet werden sollen. Diese Steuerelemente müssen bereits so entworfen werden, dass sie an Verbindungen teilnehmen können. Sie können der Zone auch weitere Serversteuerelemente hinzufügen. Wie bereits in diesem Thema bemerkt, werden die in diesem Beispiel deklarierten Steuerelemente von dem in der IsStatic-Eigenschaft vorhandenen Beispielcode abgerufen. Der Code für die gesamte Zone mit den Serversteuerelementen sieht folgendermaßen aus:
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
    <aspSample:ZipCodeWebPart ID="zip1" 
       Title="ZIP Code Provider"  />
    <aspSample:WeatherWebPart ID="weather1"  
       Title="ZIP Code Consumer" />
  </ZoneTemplate>
</asp:WebPartZone> 
```

So deklarieren Sie eine statische Verbindung

Ihre Webseite sollte bereits über ein <asp:webpartmanager>-Element verfügen, das für Seiten erforderlich ist, die Webparts-Steuerelemente verwenden. Fügen Sie ein <staticconnections>-Element als untergeordnetes Element des <asp:webpartmanager>-Elements hinzu, das mindestens eine statische Verbindung enthält. Der Code sollte der Darstellung im folgenden Beispiel entsprechen:
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
  </StaticConnections> 
</asp:WebPartManager> 
```
Deklarieren Sie innerhalb des <staticconnections>-Elements ein <asp:webpartconnection>-Element. Für die Verbindung müssen Sie zusätzlich zu den Attributen id und runat die folgenden erforderlichen Attribute hinzufügen:
- ConsumerID – Gibt die ID des Consumersteuerelements in der Verbindung an.
- ConsumerConnectionPointID – Gibt die ID einer besonderen Rückrufmethode im Consumer an, der zum Herstellen der Verbindung verwendet wird. Dieses Attribut ist nur erforderlich, wenn der Consumer mehr als einen Verbindungspunkt aufweist. Ausführliche Informationen zu Verbindungspunkten finden Sie unter ConnectionPoint.
- ProviderID – Gibt die ID des Anbietersteuerelements in der Verbindung an.
- ProviderConnectionPointID – Gibt die ID einer besonderen Rückrufmethode im Anbieter an, der zum Herstellen der Verbindung verwendet wird. Dieses Attribut ist nur erforderlich, wenn der Anbieter mehr als einen Verbindungspunkt hat.
Der vollständige Code für das <asp:webpartmanager>-Element und die untergeordnete statische Verbindung sollte folgendermaßen aussehen:
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
    <asp:WebPartConnection ID="conn1"
      ConsumerConnectionPointID="ZipCodeConsumer"
      ConsumerID="weather1" 
      ProviderConnectionPointID="ZipCodeProvider" 
      ProviderID="zip1" />
  </StaticConnections>      
</asp:WebPartManager>
```

Siehe auch

Konzepte

Übersicht über Webpartverbindungen

Übersicht über ASP.NET-Webparts

Referenz

WebPartConnection

IsStatic