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.

WebPartConnection الفئة

Visual Studio 2010

Provides an كائن that enables الثاني WebPart عناصر التحكم إلى نموذج a اتصال. و هذه الفئة لا يمكن أن تكون موروثة.

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

[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public sealed class WebPartConnection

في the عنصر تحكم أجزاء ويب التعيين, a اتصال هو a ارتباط أو اقتران between الثاني WebPart (أو غير ذلك الخادم أو مستخدم) عناصر التحكم that enables them إلى يجعله مشتركًا بيانات. This ability إلى يجعله مشتركًا بيانات allows متصل عناصر التحكم إلى be used في ways that exceed the functionality offered بواسطة the معزول عناصر التحكم. For مثال, if واحد عنصر تحكم provides الرمز البريدي بيانات, و another عنصر تحكم can read that بيانات و provide محلي weather معلومات based تشغيل the الرمز البريدي, then the متصل capability of the الثاني عناصر التحكم provides المزيد القيمة إلى users. لتوسيع هذا المثال، غير ذلك عناصر يمكن تاريخ الإنشاء أيضا عرض المعلومات استناداً إلى رمز بريدي، مثل عنصر تحكم بواسطة الارتباطات بالأخبار المحلية، ويمكن لكافة عناصر التي يمكن أن تعمل باستخدام بيانات الرمز البريدي يجعله مشتركًا البيانات مع عنصر تحكم مفرد يقوم بتوفير رمز بريدي. يمكن للمستخدمين النهائيين من تطبيقات "أجزاء ويب" إنشاء وإدارة الاتصالات بين متوافق مع الجميع هذه عناصر التحكم مباشرة من خلال مستعرض ويب، باستخدام اتصالات قياسية واجهة المستخدم (واجه المستخدم) يوفرها ConnectionsZoneعنصر تحكم، أو باستخدام واجهة مستخدم مخصصة توفيرها من قبل المطور.

$ $ $ $ Th هو WebPartConnectionنظرة عامة حول فئة هو عبارة عامة التفاصيل الأساسية لإنشاء الاتصال. لمزيد من مكونات معينة على و متطلبات المتضمنة في إنشاء الاتصالات، راجع نظرة عامة حول اتصالات أجزاء ويب، أو رؤية الفئات مرجع و تعليمات برمجية الأمثلة الواردة في المناقشة التالية. هناك عدة جوانب أساسية من اتصال أجزاء ويب:

  • عنصري تحكم WebPart . يتكون كل اتصال "أجزاء ويب" من الثاني عناصر التحكم. هو لعنصر تحكم للمشاركة في اتصال مفرد أو أكثر من في نفس الوقت، ولكن consهوts اتصال مفرد بكل من فئتين من عناصر التحكم. يمكنك الحصول على عناصر التحكم مباشرة من WebPartفئة الأساس، أو أنها يمكن أن تكون عناصر الخادم التحكم الأخرى، بما في ذلك عناصر تحكم ASP.NET، عناصر تحكم خادم مخصص، و عناصر تحكم مستخدم. عناصر التحكم التي لا ينحدر من WebPartالفئة، إذا كان وضع في WebPartZoneBaseمنطقة، يتم auإلىmatically الملتفة GenericWebPartكائن وقت التشغيل، مما يتيح لهم إلى يورث WebPartالفئة والدالة كوقت التشغيل WebPartعناصر التحكم.

  • عناصر التحكم الموجودة في WebPartZoneBaseالمناطق. كلا WebPartعناصر التحكم ويجب أن تكون أي نوع آخر من عنصر تحكم الخادم في WebPartZoneBaseالمنطقة حتى تتمكن من المشاركة في الاتصالات "أجزاء ويب" (ومعظم ميزات "أجزاء ويب" غير ذلك).

  • المستهلكين و الموفرين. في كل اتصال "أجزاء ويب" هناك اثنان عناصر التحكم: موفر بيانات مستهلك بيانات. يقدم الموفر بيانات إلى المستهلك من خلال أسلوب رد اتصال محدد الذي تقوم بإرجاع بيانات في نموذج واجهة. (للحصول على مثال عن كيفية إلى إنشاء وحدد أسلوب رد الاتصال، راجع مقطع مثال من هذا إلى صورة.) Th هو استدعاء الأسلوب هو المعروفة بنقطة اتصال موفر. التفاصيل الخاصة بنقطة الاتصال هذه (اسمها "المالوف" معرف ونوع الواجهة الذي يتم إرجاعه) الموجودة في ProviderConnectionPointالكائنات المقترنة مع الموفر عنصر تحكم. يتلقى العميل بيانات من خلال أسلوب محدد يقبلها مثيلاً للواجهة. Th هو أسلوب هو معروف كيؤشر اتصال عميل وتفاصيل يؤشر الاتصال (الاسم والالمعرف ونوع واجهة) الموجودة في ConsumerConnectionPointالكائنات المقترنة بعنصر التحكم مستهلك.

  • متوافق عناصر تحكم أو محول صحيحة. لإجراء اتصال في العمل والعملاء موفر يجب أن تكون متوافقة مع (معنى أن أساليبها يؤشر الاتصال المحدد يمكن استخدام نفس نوع واجهة) أو يوجد يجب أن يكون WebPartTransformerقادر على ترجمة المقدمة من قبل الموفر في النوع الكائن في undersفيod نوع بالمستهلك.

  • AWebPartConnectionكائن. For a اتصال إلى exist, there must be an مثيل of the WebPartConnection فئة that يحتوي على مراجع إلى the موفر و مستهلك عناصر التحكم, along مع the تفاصيل of their اتصال نقاط. If the موفر و مستهلك are incompatible و instead استخدم a WebPartTransformer كائن إلى يعيّن, the اتصال مراجع the transformer.

  • A means of establishing the اتصال. بعد أن تم تصميمها عناصر التحكم مستهلك موفر متوافق بشكل صحيح مع نقطة اتصال الطرق ووضعها في منطقة ما، WebPartConnectionالكائن متوفراً، يتم أساسى الخطوة الأخيرة اللازمة لبدء الاتصال. واحد way this can happen هو for users إلى إنشاء the اتصال through the واجه المستخدم. If you place an <asp:connectionszone> عنصر تشغيل the الصفحة, و the غير ذلك مطلوب مكونات for a اتصال are in place, at run الوقت a مستخدم can تبديل the الصفحة في يعيّن الوضع عرض, انقر a يعيّن فعل تشغيل the الأفعال قائمة of either the موفر أو مستهلك, و a اتصال واجه المستخدم (based تشغيل the ConnectionsZone عنصر تحكم) will appear. Through this واجه المستخدم, the مستخدم can initiate the اتصال. Another way إلى initiate the اتصال هو إلى do it programmatically. في either حالة, whether through the واجه المستخدم أو programmatically, the underlying أسلوب that initiates the اتصال هو the same. The تطبيق calls the ConnectWebParts أسلوب (أو the ConnectWebParts أسلوب if using a transformer) تشغيل the WebPartManager عنصر تحكم, passing إلى it the موفر, the مستهلك, و their respective اتصال يؤشر الكائنات, و the أسلوب إرجاع a WebPartConnection كائن.

The WebPartConnection فئة defines an كائن that encapsulates the essential تفاصيل of a اتصال between الثاني WebPart عناصر التحكم. The فئة consists almost entirely of خصائص related إلى the تفاصيل of a particular اتصال. Several خصائص concern the مستهلك عنصر تحكم في a اتصال. The Consumer خاصية مراجع the مستهلك عنصر تحكم itself, و the ConsumerID خاصية مراجع the مستهلك's المعرف. ConsumerConnectionPoint الكائن الذي يحتوي على التفاصيل الخاصة بيؤشر اتصال للعميل، هو كمرجع للمستهلك ConsumerConnectionPointخاصية. ConsumerConnectionPointID تشير خاصية المعرف ConsumerConnectionPointكائن. يجب أن يكون كافة الخصائص المتعلقة بالعملاء الاتصال هذه لتعيين القيمة إلى عليها إلى إنشاء اتصال.

WebPartConnection الفئة يحتوي أيضا على العديد من الخصائص التي ترتبط إلى الموفر عنصر تحكم في اتصال، وتتوافق هذه مع الخصائص للمستهلك. Provider تشير خاصية الموفر عنصر تحكم نفسها، بينما ProviderIDتشير خاصية المعرف الخاص به. ProviderConnectionPoint مراجع خاصية ProviderConnectionPointالكائن، ProviderConnectionPointIDتشير خاصية المعرف اتصال موفر's يؤشر.

خصائص عدة concern الالولاية اتصال. IsActive خاصية تشير إلى ما إذا كان الاتصال هو نشط؟ة (تبادل حاليا بيانات) أو غير نشط؟ (والمتصلة باستمرار، ولكن لا فاعلية المشاركة بيانات). IsShared الخاصية إلى ما إذا كان الاتصال هو مشتركة (متوفر لكافة مستخدمي صفحة) أو اتصال الخاص بالمستخدم، و IsStaticالخاصية إلى ما إذا كان عنصر التحكم هو ثابت (المعلن في صفحة ترميز ودائمة وهكذا) ديناميكي أو (تم إنشاؤه بطريقة برمجية، مما يعني أنه يمكن أن يتم حذفه).

يلي تعليمات برمجية مثال يوضح كيفية إنشاء اتصال بسيط بين جهازي WebPartعناصر التحكم. مثال يوضح الطرق الثلاثة من تشكيل اتصال: بشكل إلزامي، بوضع علامات للاتصال في ترميز لصفحة ويب؛ برمجياً، بواسطة إنشاء الاتصال في تعليمات برمجية؛ ومن خلال واجهة المستخدم، وضع ConnectionsZoneعنصر تحكم الصفحة، الذي يمكن المستخدمين من تأسيس الاتصال.

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

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

  • مصدر تعليمات برمجية لواجهة و جهازي WebPartيتحكم بالحركة الموفر و مستهلك للاتصال.

  • صفحة ويب استضافة الجميع عناصر التحكم وتشغيلها تعليمات برمجية المثال.

  • شرح كيفية إلى تشغيل الصفحة المثال.

الجزء أول من هذا المثال تعليمات برمجية هو عنصر تحكم مستخدم الذي يمكن مستخدمين من إلى تغيير أوضاع عرض تشغيل صفحة ويب. حفظ رمز المصدر التالي إلى ملف.ascx، يعطي الملف الاسم الذي هو المعينة إلى Srcالسمة الخاصة Registerموجها لترتيب هو مستخدم التحكم، التي هو الموجود في الجزء العلوي من صفحة ويب مضيفة. لعرض تفاصيل حول أوضاع ووصف المصدر تعليمات برمجية في عنصر التحكم هذا، راجع الإرشادات التفصيلية: تغيير أوضاع العرض على صفحة أجزاء ويب.


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


الجزء الثاني من مثال التعليمة البرمجية هو التعليمات البرمجية المصدر للواجهة وعناصر التحكم. الملف المصدر يحتوي على واجهة بسيطة باسم IZipCode. هناك هو أيضا على WebPartباسم الفئة ZipCodeWebPartالتي تطبق الواجهة ويعمل كعنصر تحكم الموفر. به ProvideIZipCodeأسلوب هو رد الاتصال أسلوب الذي ينفذ الخاص بالواجهة فقط عضو. أسلوب بساطة إرجاع مثيل للواجهة. لاحظ أن الأسلوب هو عليها من ConnectionProviderسمة في بيانات التعريف الخاصة بها. هذا هو تعريف الأسلوب كأسلوب رد الاتصال لنقطة الاتصال موفر's الآلية. الغير ذلك WebPartالفئة هو المسمى WeatherWebPart، وأنه يعمل كعميل للاتصال. هذه الفئة على أسلوب يسمى GetZipCodeالذي يحصل على مثيل IZipCodeواجهة من الموفر عنصر تحكم. ملاحظة هذا th هو أسلوب هو وضعت طريقة يؤشر اتصال للمستهلك ذات ConnectionConsumerسمة في بيانات التعريف الخاصة بها.

لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . مثال التعليمات البرمجية هذا يستخدم التحويل البرمجي الديناميكي. للحصول على الإرشادات التفصيلية التي توضح كيفية التحويل البرمجي، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


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 (input.Text != String.Empty)
      {
        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);
    }

  }
}


الجزء الثالث تعليمات برمجية هو مثال لصفحة ويب. قريب الأعلى هي Registerتوجيهات للمستخدم عنصر تحكم والمخصصة WebPartعنصر تحكم s. لأنه فرض التحويل البرمجي ديناميكي لعناصر التحكم والمصدر تعليمات برمجية لعناصر التحكم التي يجب أن تكون في App_ تعليمات برمجية فرعي; Registerتشير العلامة في الصفحة فقط بادئة علامة عشوائية ومساحة الاسم لعناصر التحكم. مخصص WebPartعناصر التحكم (الموفر و مستهلك) يتم التصريح بداخل صفحة ويب <asp:webpartzone>العنصر، داخل <zonetemplate>العنصر.

توفر الصفحة ثلاث طرق إلى تكوين اتصال بين عناصر التحكم cusإلىm. أول أسلوب هو مصرحة. في ترميز للصفحة، < StaticConnections>يتم التصريح عن العنصر وداخل الذي هو <asp:WebPartConnections>العناصر، والمستهلكين المختلفة و موفر تفاصيل الاتصال المحدد كسمات. Th هو هو وحيدة الاتجاه إنشاء اتصال، بالتصريح مباشرة في صفحة ويب، وبشكل خاص داخل <asp:WebPartManager>العنصر. نظراً لهذا الاتصال ثابتة، يتم تاريخ الإنشاء اتصال بين عنصري التحكم المخصصة مباشرة أول وقت تحميل الصفحة.

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

ويوضح الصفحة أيضا طريقة ثالثة لإنشاء اتصال، التي هو للقيام بطريقة برمجية. في Button1_Clickالأسلوب، تعليمات برمجية ينشئ ProviderConnectionPointكائن التحكم الموفر، واسترداد تفاصيل يؤشر الاتصال الخاصة به بواسطة استدعاء GetProviderConnectionPointsالأسلوب. أنه بتنفيذ مهمة مشابهة للعميل عنصر تحكم، استدعاء GetConsumerConnectionPointsالأسلوب. وأخيراً، يقوم بإنشاء جديد WebPartConnectionالكائن قبل استدعاء ConnectWebPartsالأسلوب تشغيل WebPartManagerعنصر تحكم.


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


بعد تحميل صفحة ويب في مستعرض، اﻷول اتصال موجود مسبقاً لأنه تم تعريفه داخل <StaticConnections>العنصر. Enter الزر الزر نصاً في من موفر الرمز البريدي عنصر تحكم، وسيتم عرضه في العميل عنصر تحكم. بعد ذلك، قم بفصل عنصري التحكم. استخدام عنصر تحكم القائمة عرض الوضع المنسدلة، قم بتغيير الصفحة لتوصيل الوضع العرض. انقر فوق قائمة الأفعال (ممثلة بواسطة سهم إلى أسفل في شريط عنوان) لكل من WebPartعناصر التحكم، و لاحظ أن يكون لكل خيار يعيّن. هذا هو فعل اتصال، والذي يظهر في قائمة الأفعال فقط عندما تكون الصفحة في الوضع يعيّن. انقر فوق فعل يعيّن تشغيل واحد عناصر التحكم واتصال واجهة المستخدم التي يوفرها ConnectionsZoneيظهر عنصر التحكم. انقر فوق قطع الاتصال زر إنهاء اتصال ثابت بين عناصر التحكم. وضع عرض استخدام عنصر تحكم للعودة صفحة استعراض الوضع. حاول إدخال بعض نص الجديد في الموفر مرة أخرى، ولاحظ أنه يتم قطع اتصال عنصر تحكم s، نص يفشل لتحديث في العميل عنصر تحكم.

بعد ذلك، باستخدام نفس الأسلوب كـ أعلاه لتحويل الصفحة إلى الوضع عرض الاتصال مرة أخرى. انقر فوق يعيّن فعل تشغيل واحد عناصر التحكم. انقر فوق الارتباط إنشاء اتصال ، واستخدام واجهة المستخدم يوفرها ConnectionsZoneعنصر تحكم لإنشاء اتصال بين عنصر تحكم s. هذا هو الثاني أسلوب لإنشاء اتصال. لاحظ أنه بمجرد الاتصال هو تشكيل، السلسلة الأخيرة التي قمت بإدخاله في عنصر التحكم الموفر (الذي فشل تظهر عناصر التحكم التي سبب dهوconnected) فجأة تظهر في العميل، لأنه تمت إعادة إنشاء الاتصال. انقر فوق قطع الاتصال زر لإنهاء الاتصال الحالي الذي قمت بإنشائه الآن. العودة الصفحة إلى وضع الاستعراض. أدخل بعض نص الجديد في الموفر لتوضيح التي نص هو لا بمحدث عناصر التحكم يتم مرة أخرى dهوconnected.

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

System.Object
  System.Web.UI.WebControls.WebParts.WebPartConnection

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل 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
إظهار: