Sdílet prostřednictvím

WebPartManager.CloseProviderWarning Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá nebo nastaví upozornění, které se zobrazí, když uživatel zavře ovládací prvek, který funguje jako zprostředkovatel jiným ovládacím prvkům v připojení.

public:
 virtual property System::String ^ CloseProviderWarning { System::String ^ get(); void set(System::String ^ value); };
public virtual string CloseProviderWarning { get; set; }
member this.CloseProviderWarning : string with get, set
Public Overridable Property CloseProviderWarning As String

Hodnota vlastnosti

String

Řetězec, který obsahuje zprávu upozornění. Výchozí hodnota je zpráva specifická pro jazykovou verzi zadanou rozhraním .NET Framework.

Příklady

Následující příklad kódu ukazuje použití CloseProviderWarning vlastnosti k zobrazení vlastního upozornění pro uživatele.

Příklad kódu má čtyři části:

  • Uživatelský ovládací prvek, který umožňuje změnit režimy zobrazení na stránce webových částí.

  • Soubor zdrojového kódu, který obsahuje dva vlastní WebPart ovládací prvky a vlastní rozhraní.

  • Webová stránka, která obsahuje dva vlastní WebPart ovládací prvky, které lze připojit, a <asp:webpartmanager> prvek.

  • Vysvětlení fungování příkladu v prohlížeči

Následující kód obsahuje pouze část webové stránky v příkladu. Budete také potřebovat vlastní uživatelský ovládací prvek a zdrojový kód pro vlastní ovládací prvky uvedené výše. Získejte tyto dvě položky z části Příklad přehledu WebPartManager třídy.

Následující kód webové stránky ukazuje, jak přiřadit vlastní zprávu upozornění vlastnosti CloseProviderWarning v deklarativní kód v elementu <asp:webpartmanager> .

<%@ 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">
<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="WebPartManager1" runat="server"  
          CloseProviderWarning="You are closing a provider control." />
    <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>

<%@ 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">
<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="WebPartManager1" runat="server"  
          CloseProviderWarning="You are closing a provider control." />
    <div>
      <uc1:DisplayModeMenuVB 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>

Po načtení webové stránky v prohlížeči klikněte na ovládací prvek rozevíracího seznamu Režim zobrazení a vyberte Připojit a přepněte stránku do režimu připojení. Režim připojení používá <asp:connectionszone> prvek, který umožňuje vytvářet připojení mezi ovládacími prvky. V režimu připojení klikněte na šipku dolů v záhlaví ovládacího prvku PSČ , aby se aktivovala jeho nabídka slovesa a potom klepněte na tlačítko Připojit. Jakmile se zobrazí uživatelské rozhraní připojení, klikněte na odkaz Vytvořit připojení k odkazu Příjemce . Zobrazí se buňka, která obsahuje ovládací prvek rozevíracího seznamu. V rozevíracím seznamu vyberte Ovládací prvek počasí a kliknutím na Připojit dokončete propojení těchto dvou ovládacích prvků. Klepněte na tlačítko Zavřít a potom pomocí rozevíracího seznamu Režim zobrazení vrátit stránku do normálního režimu procházení. Nakonec klikněte na nabídku sloves pro ovládací prvek PSČ (což je v tomto případě ovládací prvek zprostředkovatele) a vyberte Zavřít. Zobrazí se vlastní zpráva, kterou jste přiřadili vlastnosti CloseProviderWarning .

Poznámky

Když uživatel zavře WebPart ovládací prvek, obvykle se nezobrazí žádná zpráva. Další informace o tom, co znamená zavřít ovládací prvek, naleznete v CloseWebPart metodě.

Pokud je však ovládací prvek připojen k jinému ovládacímu prvku a funguje jako zprostředkovatel dat do druhého ovládacího prvku, zobrazí se výchozí zpráva upozornění, když se uživatel pokusí ovládací prvek zavřít. Zpráva uživatelům říká, že se má ovládací prvek poskytovatele zavřít, což znamená, že ovládací prvky připojené k tomuto poskytovateli už nebudou mít žádná data, která by mohli využívat. Tato CloseProviderWarning vlastnost umožňuje vývojářům přizpůsobit zprávu upozornění, která se uživateli zobrazí.

Pokud vývojář stránky přiřadí této vlastnosti prázdnou hodnotu řetězce nebo hodnotu null, nezobrazí se žádné okno s upozorněním, když uživatel zavře WebPart ovládací prvek, který je zprostředkovatelem.

Platí pro

Viz také