WebPartManager.ConnectWebParts Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls.WebParts

Bütünleştirilmiş Kod:: System.Web.dll

Ö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.

Bir bölgede bulunan iki WebPart denetim (veya bağlantı oluşturabilen diğer sunucu denetimleri) arasında bir WebPartZoneBase bağlantı oluşturur.

Aşırı Yüklemeler

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)	yalnızca denetimlere ve bunların belirtilen ConnectionPoint nesnelerine yapılan başvuruları kullanarak iki WebPart veya GenericWebPart denetim arasında bir bağlantı oluşturur.
ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)	Denetimlere, belirtilen ConnectionPoint nesnelerine ve bir nesneye yapılan başvuruları kullanarak iki WebPart veya GenericWebPart denetim arasında bir WebPartTransformer bağlantı oluşturur.

Açıklamalar

yöntemi, ConnectWebParts bağlanabilen iki WebPart denetim arasında bir bağlantı oluşturur. Bağlantı oluşturmak için bu yöntemi çağırmadan önce, denetimlerin CanConnectWebParts bağlantı oluşturma gereksinimlerini karşıladığından emin olmak için koşullu denetimde yöntemini çağırmak da isteyebilirsiniz.

Not

Denetim olmayan WebPart iki sunucu denetimi arasında bağlantı oluşturmak da mümkündür. Genel olarak, gerekli üyeleri ekleyebilmeniz için iki denetimin özel sunucu denetimleri (örneğin, ASP.NET sunucu denetimlerinden WebControl devralan denetimler) olması gerekir. Denetimlerin ayrıca aşağıda belirtilen gereksinimleri karşılaması gerekir.

İki denetim arasındaki her tür bağlantı senaryosunun bağlanabilmesi için aşağıdaki gereksinimleri karşılaması gerekir:

Her denetim bir WebPartZoneBase bölgede bulunur (aynı bölge olması gerekmez).
Web Bölümleri denetim kümesinde uygulandığı gibi, bir bağlantıdaki sağlayıcı denetimi, sağlayıcıya geri çağırma olarak hizmet veren bir ortak yöntem olarak bir arabirim uygular ve bunu sağlayıcı bağlantı noktası olarak tanımlamak için yönteminde meta ConnectionProvider veri özniteliğine sahiptir. GetProviderConnectionPoints Sağlayıcı bağlantı noktalarını alan yöntem sanal olduğundan, türetilmiş WebPartManager bir denetimin aynı meta veri özniteliğini kullanması gerekmez.
Web Bölümleri denetim kümesinde uygulandığı gibi, bir bağlantıdaki tüketici denetiminin, sağlayıcının geri çağırma yönteminde kullanıma sunulan arabirime başvuru almasına olanak tanıyan özel bir yöntemi vardır ve tüketicinin yönteminde bunu bir tüketici bağlantı noktası olarak tanımlamak için bir ConnectionConsumer meta veri özniteliği vardır. GetConsumerConnectionPoints Tüketici bağlantı noktalarını alan yöntem sanal olduğundan, türetilmiş WebPartManager bir denetimin mutlaka aynı meta veri özniteliğini kullanması gerekmez.
Geri çağırma yöntemlerinin uyumlu olması, tüketicinin sağlayıcının geri çağırma yönteminde sağlanan arabirim türünü kullanabilmesi (tüketici ve sağlayıcının verileri doğrudan paylaşabileceği anlamına gelir) veya geliştiricinin sağlayıcıdan gelen verileri tüketicinin kullanabileceği bir biçime dönüştürmek için bir WebPartTransformer nesne kullanması gerekir.

Önemli

Transformatöre ihtiyacınız olmadığında yöntem aşırı yüklemesini ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) kullanın. Transformatöre ihtiyacınız olduğunda yöntemi aşırı yüklemesini ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) kullanın.

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

yalnızca denetimlere ve bunların belirtilen ConnectionPoint nesnelerine yapılan başvuruları kullanarak iki WebPart veya GenericWebPart denetim arasında bir bağlantı oluşturur.

public:
 System::Web::UI::WebControls::WebParts::WebPartConnection ^ ConnectWebParts(System::Web::UI::WebControls::WebParts::WebPart ^ provider, System::Web::UI::WebControls::WebParts::ProviderConnectionPoint ^ providerConnectionPoint, System::Web::UI::WebControls::WebParts::WebPart ^ consumer, System::Web::UI::WebControls::WebParts::ConsumerConnectionPoint ^ consumerConnectionPoint);

public System.Web.UI.WebControls.WebParts.WebPartConnection ConnectWebParts (System.Web.UI.WebControls.WebParts.WebPart provider, System.Web.UI.WebControls.WebParts.ProviderConnectionPoint providerConnectionPoint, System.Web.UI.WebControls.WebParts.WebPart consumer, System.Web.UI.WebControls.WebParts.ConsumerConnectionPoint consumerConnectionPoint);

member this.ConnectWebParts : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.ProviderConnectionPoint * System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.ConsumerConnectionPoint -> System.Web.UI.WebControls.WebParts.WebPartConnection

Public Function ConnectWebParts (provider As WebPart, providerConnectionPoint As ProviderConnectionPoint, consumer As WebPart, consumerConnectionPoint As ConsumerConnectionPoint) As WebPartConnection

Parametreler

provider: WebPart

WebPart Verileri başka bir bağlı denetime sağlama rolüne sahip bir denetim.

providerConnectionPoint: ProviderConnectionPoint

Bağlantı için geri çağırma yöntemi olarak hizmet veren bir yöntem. Web Bölümleri denetim kümesinde uygulandığı gibi, içinde meta veri özniteliğiyle işaretlenmiş genel bir ConnectionProvider yöntemdirprovider.

consumer: WebPart

WebPart'den providerveri alma ve ardından verileri işleme veya görüntüleme rolüne sahip bir denetim.

consumerConnectionPoint: ConsumerConnectionPoint

Bağlantının verilerini almak için ile providerConnectionPoint bağlanan bir yöntem. Web Bölümleri denetim kümesinde uygulandığı gibi, içinde meta veri özniteliğiyle işaretlenmiş genel bir ConnectionConsumer yöntemdirconsumer.

Döndürülenler

WebPartConnection

Bir WebPartConnection bağlantı için gerekli sağlayıcı ve tüketici hakkında çeşitli bilgileri içeren.

Özel durumlar

InvalidOperationException

Denetimin WebPartManager dinamik koleksiyon koleksiyonu salt okunurdur.

Örnekler

Aşağıdaki kod örneği, program aracılığıyla bağlantı oluşturmak için bu yöntemin nasıl kullanılacağını gösterir. Örneği çalıştırmak için gereken kodun tamamı için, sınıfa genel bakışın WebPartManager Örnek bölümüne bakın. Bu örnekten, sayfadaki görüntü modlarını değiştirmenize olanak tanıyan kullanıcı denetimi için kaynak koduna ve iki özel WebPart denetimin kaynak koduna ihtiyacınız olacaktır.

İki denetimi barındıran Web sayfasının kodu aşağıdadır. Sayfa, kullanıcı denetimini ve özel denetimleri bildirmek için en üstteki yönergeleri kullanır Register . Daha sonra özel denetimlere bir <asp:webpartzone> öğe içinde bildirim temelli olarak başvurulur. yöntemini işleyen Button1_Click kod, yöntemini kullanarak ConnectWebParts denetimler arasında bir bağlantı oluşturur.

<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc1" 
    TagName="DisplayModeMenuCS"
    Src="~/displaymodemenucs.ascx" %>
<%@ Register TagPrefix="aspSample" 
    Namespace="Samples.AspNet.CS.Controls" 
    Assembly="ConnectionSampleCS"%>

<!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">
      </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" 
    Assembly="ConnectionSampleVB"%>

<!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">
      </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>

Sayfayı bir tarayıcıda yükledikten sonra, bağlantıyı oluşturmak için Web Bölümü Denetimlerini Bağla düğmesine tıklayın. Ardından metin kutusuna bazı veriler girebilir ve denetimlerin bağlı olduğunu ve ilk denetime girilen verilerin ikincisinde güncelleştirildiğini göstermek için 5 basamaklı Posta Kodu Gir düğmesine tıklayabilirsiniz.

Açıklamalar

Bu aşırı yükleme, bağlantı noktaları nesne kullanmadan WebPartTransformer bağlanabilecekleri kadar uyumlu olduğunda denetimleri bağlamak için kullanılır. Yönteminin bu aşırı yüklemesi çağrıldığında, çağrıyı yöntemin diğer aşırı yüklenmiş sürümüne geçirir ve bir WebPartTransformer nesnesi gerektiren parametresi için geçirirnull.

İki denetimi program aracılığıyla bağlamayı denediğinizde, denetimlerin CanConnectWebParts doğrudan bağlanıp bağlanamayacağını belirlemek için koşullu denetimde yöntemini kullanabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Denetimlere, belirtilen ConnectionPoint nesnelerine ve bir nesneye yapılan başvuruları kullanarak iki WebPart veya GenericWebPart denetim arasında bir WebPartTransformer bağlantı oluşturur.

public:
 virtual System::Web::UI::WebControls::WebParts::WebPartConnection ^ ConnectWebParts(System::Web::UI::WebControls::WebParts::WebPart ^ provider, System::Web::UI::WebControls::WebParts::ProviderConnectionPoint ^ providerConnectionPoint, System::Web::UI::WebControls::WebParts::WebPart ^ consumer, System::Web::UI::WebControls::WebParts::ConsumerConnectionPoint ^ consumerConnectionPoint, System::Web::UI::WebControls::WebParts::WebPartTransformer ^ transformer);

public virtual System.Web.UI.WebControls.WebParts.WebPartConnection ConnectWebParts (System.Web.UI.WebControls.WebParts.WebPart provider, System.Web.UI.WebControls.WebParts.ProviderConnectionPoint providerConnectionPoint, System.Web.UI.WebControls.WebParts.WebPart consumer, System.Web.UI.WebControls.WebParts.ConsumerConnectionPoint consumerConnectionPoint, System.Web.UI.WebControls.WebParts.WebPartTransformer transformer);

abstract member ConnectWebParts : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.ProviderConnectionPoint * System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.ConsumerConnectionPoint * System.Web.UI.WebControls.WebParts.WebPartTransformer -> System.Web.UI.WebControls.WebParts.WebPartConnection
override this.ConnectWebParts : System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.ProviderConnectionPoint * System.Web.UI.WebControls.WebParts.WebPart * System.Web.UI.WebControls.WebParts.ConsumerConnectionPoint * System.Web.UI.WebControls.WebParts.WebPartTransformer -> System.Web.UI.WebControls.WebParts.WebPartConnection

Public Overridable Function ConnectWebParts (provider As WebPart, providerConnectionPoint As ProviderConnectionPoint, consumer As WebPart, consumerConnectionPoint As ConsumerConnectionPoint, transformer As WebPartTransformer) As WebPartConnection

Parametreler

provider: WebPart

WebPart Verileri başka bir bağlı denetime sağlama rolüne sahip olan bir.

providerConnectionPoint: ProviderConnectionPoint

içinde provider meta veri özniteliğiyle ConnectionProvider işaretlenmiş ve bağlantı için bir geri çağırma yöntemi olarak hizmet veren genel bir yöntem.

consumer: WebPart

WebPart veya transformer'den provider veri alma ve ardından verileri işleme veya görüntüleme rolüne sahip olan bir.

consumerConnectionPoint: ConsumerConnectionPoint

içinde consumer meta veri özniteliğiyle işaretlenmiş ve bağlantının verilerini almak için ile providerConnectionPoint bağlanan genel bir ConnectionConsumer yöntem.

transformer: WebPartTransformer

WebPartTransformer verileri provider işleyebilen bir biçime consumer dönüştürerek iki denetim arasında bağlantı sağlayan bir.

Döndürülenler

WebPartConnection

Bağlantı WebPartConnection için gereken sağlayıcı, tüketici ve transformatör hakkındaki bilgileri içeren.

Özel durumlar

InvalidOperationException

bağlantılar içinde PreRenderzaten etkinleştirilmiştir.

Açıklamalar

Bu aşırı yükleme, bağlantı noktaları uyumsuz olduğunda denetimleri bağlamak için kullanılır. Uyumsuzluk, bağlantı noktası olarak farklı provider bir arabirim uygulandığında consumer oluşur. Transformatör, verileri tarafından consumeranlaşılacak bir türe dönüştürür.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

WebPartManager.ConnectWebParts Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar