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.DisconnectWebParts أسلوب

Visual Studio 2010

ينفذ عملية قطع اتصال الخادم عناصر التحكم التي تتصل تشغيل صفحة ويب.

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

public virtual void DisconnectWebParts(
	WebPartConnection connection
)

المعلمات

connection
النوع: System.Web.UI.WebControls.WebParts.WebPartConnection
WebPartConnection الذي يمثل الاتصال بين الملقم عناصر التحكم.

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

connection هو null.

ArgumentException

connectionهو غير موجود في أيStaticConnectionsأوDynamicConnections.

InvalidOperationException

StaticConnections هو للقراءة فقط.

-أو-

connectionتم قطع الاتصال مسبقاً منStaticConnections.

-أو-

DynamicConnections هو للقراءة فقط.

-أو-

connectionتم قطع الاتصال مسبقاً منDynamicConnections.

DisconnectWebParts أسلوب ينفذ عملية إكمال الإنهاء اتصال بين WebPartأو عناصر تحكم الخادم، وعندما قمت بتمرير connectionمعلمة.

Th هو أسلوب هو المستخدمة لعناصر التحكم dهوconnect عندما تقوم بوضع <asp:connectionszone>عنصر في صفحة ويب، بتوفير واجهة مستخدم (واجه المستخدم) لإدارة الاتصالات. عندما صفحة هو في توصيل الالوضع dهوplay ( ConnectDisplayMode)، exهوts اتصال الحالي، يستطيع المستخدمون النقر فوق زر الذي يستدعي DisconnectWebPartsأسلوب لإنهاء يعيّن.

You can also يتصل the DisconnectWebParts أسلوب directly من your تعليمات برمجية, if you want إلى قطع الاتصال عناصر التحكم programmatically و without having إلى إضافة an <asp:connectionszone> عنصر إلى a الصفحة.

ملاحظات للمسئولين عن الإرث

You can يمنع the DisconnectWebParts أسلوب if you want إلى تغيير the الافتراضي implementation for disconnecting WebPart عناصر التحكم. If you do يمنع the أسلوب, و you simply want إلى إضافة some implementation إلى the موجود أسلوب, you can يتصل the الأساس أسلوب prior إلى executing your own تعليمات برمجية.

يوضح المثال تعليمات برمجية التالي كيفية إلى تستخدم في DisconnectWebPartsالأسلوب. استخدام المخصصة اثنين WebPartعناصر التحكم، صفحة ويب تمكنك من إنشاء اتصال بين عناصر التحكم بالنقر فوق زر، بينما يمكنك زر آخر لقطع اتصال عناصر تحكم.

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

  • عنصر تحكم مستخدم لتغيير أوضاع عرض.

  • A الملف المصدر containing مخصص WebPart عناصر التحكم.

  • صفحة ويب إلى استضافة عناصر التحكم.

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

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

The ثانية part هو a ملف containing the المصدر تعليمات برمجية for the الثاني مخصص WebPart عناصر التحكم that will be متصل. لتشغيل مثال التعليمات البرمجية , يجب عليك التحويل برمجياً للتعليمات البرمجية المصدر . يمكنك تحويله برمجياً مباشرة و وضع ناتج التجميع في مجلد سلة موقع ويب الخاص بك أو في مخزن التجميع العمومي المؤقت. بشكل بديل، يمكنك وضع التعليمات البرمجية المصدر في مجلد App_Code للموقع الخاص بك ، حيث سيتم تحويله برمجيا بشكل حيوي وقت التشغيل . This مثال uses ديناميكي compilation, so the Register directive that مراجع these مكونات في the ويب الصفحة هو declared accordingly at the الأعلى of the ويب الصفحة. للإرشادات التفصيلية التي توضح خيارات الترجمة، راجع الإرشادات التفصيلية: تطوير و استخدام عنصر تحكم خادم مخصص.


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", "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", "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);
    }

  }
}


الجزء الثالث تعليمات برمجية هو مثال لصفحة ويب. Notice that قريب the الأعلى, it يحتوي على Register directives إلى register the مستخدم عنصر تحكم و the dynamically compiled تجميع مع the WebPart عناصر التحكم. على الصفحة أسلوبين الأساسي. The Button1_Click أسلوب creates a اتصال between the عناصر التحكم, و the Button2_Click أسلوب disconnects the عناصر التحكم.


<%@ 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 Button2_Click(object sender, EventArgs e)
  {
    if (mgr.Connections.Count >= 1 && mgr.Connections[0] != null)
      mgr.DisconnectWebParts(mgr.Connections[0]);
  }


</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">
      </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" />
      <asp:Button ID="Button2" runat="server" 
        Text="Disconnect WebPart Controls" 
        OnClick="Button2_Click" />
    </div>
    </form>
</body>
</html>


بعد you تحميل the الصفحة, you can انقر the يعيّن زر إلى يعيّن the عناصر التحكم. If you Enter الزر some text في the صندوق نص عنصر تحكم, و then انقر the Enter الزر زر, the text will be displayed في the متصل عنصر تحكم (it would not be displayed if the عناصر التحكم were disconnected). If you انقر the قطع الاتصال زر, the عناصر التحكم will be disconnected. You can verify the اتصال حالة of the عناصر التحكم بواسطة using the الوضع عرض إسقاط-أسفل عنصر تحكم القائمة إلى تبديل the الصفحة في يعيّن الوضع. بعد doing that, انقر the الأفعال قائمة (represented بواسطة an arrow) في the عنوان bar of واحد of the عناصر التحكم, و تحديد the يعيّن العنصر. The اتصال واجه المستخدم هو displayed; it هو متوفر because there هو an <asp:connectionszone> عنصر declared في the الصفحة. You can also يعيّن و قطع الاتصال the عناصر التحكم من this واجه المستخدم.

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