This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

WebPartManager.GetProviderConnectionPoints أسلوب

Visual Studio 2010

قم باسترداد المجموعة ProviderConnectionPointالكائنات التي يمكن أن تعمل كنقاط اتصال من ملقم التحكم التي هو كمورد في اتصال "أجزاء ويب".

مساحة الاسم:  System.Web.UI.WebControls.WebParts
التجميع:  System.Web (في System.Web.dll)

public virtual ProviderConnectionPointCollection GetProviderConnectionPoints(
	WebPart webPart
)

المعلمات

webPart
النوع: System.Web.UI.WebControls.WebParts.WebPart
ملقم التحكم التي هو كمورد في اتصال.

القيمة المُرجعة

النوع: System.Web.UI.WebControls.WebParts.ProviderConnectionPointCollection
A ProviderConnectionPointCollection that يحتوي على all اتصال نقاط in the موفر.

استثناء:شرط
ArgumentNullException

webPart هو null.

A ويب Parts اتصال دوماً involves exactly الثاني عناصر التحكم, واحد acting كـ the موفر of بيانات, the غير ذلك acting كـ the مستهلك of بيانات. Each عنصر تحكم must have واحد أو المزيد وظائف that are defined كـ اتصال نقاط. في حالة من عنصر تحكم موفر، نقاط الاتصال الخاصة به هي ProviderConnectionPointالكائنات.

يجب أن يكون موفر دوماً يؤشر اتصال واحد على الأقل إلى من إلى تأسيس اتصال. GetProviderConnectionPoints أسلوب التحقق من عنصر تحكم موفر و استرداد مجموعة من الجميع به اتصال نقاط. استعادة نقاط الاتصال بموفر هو خطوة ضرورية في تشكيل اتصال "أجزاء ويب".

يوضح المثال تعليمات برمجية التالي كيفية إلى تستخدم في GetProviderConnectionPointsالأسلوب.

المثال الأجزاء الأربعة:

  • أ عنصر تحكم المستخدم التي تمكنك من تغيير أوضاع العرض على صفحة "أجزاء ويب".

  • A ويب الصفحة that يحتوي على الثاني مخصص WebPart عناصر التحكم that can be متصل, و an <asp:webpartmanager> عنصر.

  • مصدر تعليمات برمجية الملف الذي يحتوي على عمودين المخصصة WebPartوعناصر التحكم وواجهة مخصصة.

  • An explanation of how the مثال works في a مستعرض.

The أول part of the تعليمات برمجية مثال هو the مستخدم عنصر تحكم for changing عرض modes. يمكنك الحصول على تعليمات برمجية المصدر عنصر تحكم مستخدم من مقطع مثال WebPartManagerفئة النظرة العامة. للحصول على مزيد من المعلومات حول أوضاع عرض وكيف عنصر تحكم مستخدم، راجع الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويب.

ترميز مصرحة صفحة ويب يحتوي على Registerتوجيهات لكل من عنصر تحكم مستخدم وعناصر التحكم المخصصة. هناك هو <asp:webpartmanager>العنصر، <asp:webpartzone>العنصر أن تحتوي على عناصر التحكم المخصصة، <asp:connectionszone>العنصر. لاحظ أنه في Page_Loadالأسلوب، التعليمة البرمجية لعملية فحص لمعرفة ما إذا كان اتصال موجود مسبقاً و، إذا كان لا يعرف أحد موفري بعميل ونقاط الاتصال الخاصة بهم، ويقوم بإضافة اتصال جديد إلى المجموعة ثابت المشار إليها من قبل الاتصالات StaticConnectionsخاصية. لاحظ أن ProviderConnectionPointCollectionالكائن الذي هو استرداد باستخدام GetProviderConnectionPointsأسلوب هو ثم تمرير إلى CanConnectWebPartsطريقة لتحديد ما إذا كان يمكن تاريخ الإنشاء اتصال بين عنصري تحكم.


<%@ 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 Page_Load(object sender, EventArgs e)
  {

    // Define provider, consumer, and connection points.
    WebPart provider = mgr.WebParts["zip1"];
    ProviderConnectionPoint provConnPoint =
      mgr.GetProviderConnectionPoints(provider)["ZipCodeProvider"];
    WebPart consumer = mgr.WebParts["weather1"];
    ConsumerConnectionPoint consConnPoint =
      mgr.GetConsumerConnectionPoints(consumer)["ZipCodeConsumer"];

    // Check whether the connection already exists.
    if (mgr.CanConnectWebParts(provider, provConnPoint,
      consumer, consConnPoint))
    {
      // Create a new static connection.
      WebPartConnection conn = new WebPartConnection();
      conn.ID = "staticConn1";
      conn.ConsumerID = "weather1";
      conn.ConsumerConnectionPointID = "ZipCodeConsumer";
      conn.ProviderID = "zip1";
      conn.ProviderConnectionPointID = "ZipCodeProvider";
      mgr.StaticConnections.Add(conn);
    }
 }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="mgr" runat="server" />   
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" 
        runat="server" />
      <!-- Reference consumer and provider controls 
           in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <!-- Add a ConnectionsZone so users can connect 
           controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" 
        runat="server" />
    </div>
    </form>
</body>
</html>


الجزء الثالث من المثال هو المصدر تعليمات برمجية لعناصر التحكم. يمكنك الحصول على هذه تعليمات برمجية، وإرشادات خاصة بترجمة، من مقطع مثال WebPartManagerفئة النظرة العامة.

بعد أن قمت بتحميلها من صفحة ويب في مستعرض، انقر فوق عنصر تحكم القائمة منسدلة الوضع عرض وحدد اتصال إلى تحويل الصفحة إلى الوضع يعيّن. يعيّن يستخدم الوضع <asp:connectionszone>عنصر إلى تتيح لك إلى إنشاء يعيّنات بين عناصر التحكم. في الوضع يعيّن، انقر فوق السهم إلى الأسفل في شريط عنوان عنصر الرمز البريديلتنشيط قائمته الأفعال وثم انقر فوق يعيّن. بعد ظهور واجهة مستخدم (واجه المستخدم) للاتصال، لاحظ أن اتصال تم إنشاؤه مسبقاً بواسطة تعليمات برمجية مضمنة في Page_Loadالأسلوب. إذا قمت بالعودة إلى هذه الصفحة في جلسة عمل مستعرض لاحقاً، الفعل تأسيس هذا الاتصال ثابتاً ولن تحتاج إلى أن تتم إعادة إنشاء كل مرة يتم تحميل الصفحة.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: