WebPartManager.CloseProviderWarning Vlastnost

Reference

Definice

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

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví upozornění, které se zobrazí, když uživatel zavře ovládací prvek, který funguje jako zprostředkovatel pro jiné ovládací prvky 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 poskytovaná rozhraním .NET Framework.

Příklady

Následující příklad kódu ukazuje, jak použít CloseProviderWarning vlastnost k zobrazení vlastního upozornění uživatelům.

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 prvek <asp:webpartmanager> .
Vysvětlení fungování příkladu v prohlížeči

Následující kód obsahuje pouze část příkladu s webovou stránkou. 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 oddílu 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í k CloseProviderWarning vlastnosti v deklarativní značky 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 výběrem možnosti Připojit přepněte stránku do režimu připojení. Režim připojení používá element , <asp:connectionszone> který umožňuje vytvářet připojení mezi ovládacími prvky. V režimu připojení kliknutím na šipku dolů v záhlaví ovládacího prvku PSČ aktivujte nabídku příkazů a potom klikněte na Připojit. Jakmile se zobrazí uživatelské rozhraní připojení, klikněte na odkaz Vytvořit připojení ke spotřebiteli . Zobrazí se buňka, která obsahuje ovládací prvek rozevíracího seznamu. V rozevíracím seznamu vyberte Weather Control (Ovládací prvek počasí ) a kliknutím na Connect (Připojit) dokončete spojení těchto dvou ovládacích prvků. Klikněte na Zavřít a pak pomocí rozevíracího seznamu Režim zobrazení vraťte 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 vlastnosti CloseProviderWarning přiřadili.

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, najdete 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 pro druhý ovládací prvek, 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 ovládací prvek zprostředkovatele zavírá, což znamená, že ovládací prvky připojené k tomuto poskytovateli jako spotřebitelé už nebudou mít k dispozici žádná data k využití. Vlastnost CloseProviderWarning umožňuje vývojářům přizpůsobit zprávu upozornění, která se zobrazí uživateli.

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

Platí pro

Viz také

ASP.NET ovládací prvky webových částí

Sdílet prostřednictvím