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.StaticConnections الخاصية

Visual Studio 2010

يحصل تشغيل مرجع إلى المجموعة من الجميع WebPartConnectionالكائنات الموجودة تشغيل صفحة ويب التي تم تعريفها كاتصالات ثابتة.

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

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public WebPartConnectionCollection StaticConnections { get; }

قيمة الخاصية

النوع: System.Web.UI.WebControls.WebParts.WebPartConnectionCollection
WebPartConnectionCollection التي يحتوي تشغيل الجميع الاتصالات الثابتة تشغيل الصفحة.

StaticConnections خاصية هو المستخدمة من قبل WebPartManagerالتحكم لتتبع وإدارة الجميع الاتصالات ثابتة تشغيل صفحة. أ ثابت اتصال، وعلى عكس مع اتصال ديناميكي، لا تحتاج إلى إضافتها إلى صفحة في كل مرة يتم تقديم الصفحة.

المجموعة المشار إليه مع هذه خاصية يحتوي تشغيل الجميع الاتصالات الثابتة الموجودة تشغيل الصفحة، ما إذا كانت برمجياً بإنشاء أو تحديد مع <asp:webpartconnection>عنصر في الصفحة ترميز.

The following تعليمات برمجية مثال demonstrates programmatic استخدم of the StaticConnections خاصية.

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

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

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

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

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

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

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


<%@ 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>


بعد أن قمت بتحميلها من صفحة ويب في مستعرض، انقر فوق عنصر تحكم القائمة منسدلة الوضع عرض وحدد اتصال إلى تحويل الصفحة إلى الوضع يعيّن. يعيّن يستخدم الوضع <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
إظهار: