WebPartManager.CloseProviderWarning Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia ostrzeżenie wyświetlane, gdy użytkownik zamknie kontrolkę działającą jako dostawca innych kontrolek w połączeniu.

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

Wartość właściwości

String

Ciąg zawierający komunikat ostrzegawczy. Wartość domyślna to komunikat specyficzny dla kultury dostarczony przez .NET Framework.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą CloseProviderWarning właściwości wyświetlić niestandardowe ostrzeżenie dla użytkowników.

Przykładowy kod ma cztery części:

Kontrolka użytkownika, która umożliwia zmianę trybów wyświetlania na stronie składników Web Part.
Plik kodu źródłowego zawierający dwie kontrolki niestandardowe WebPart i interfejs niestandardowy.
Strona sieci Web zawierająca dwie kontrolki niestandardowe WebPart , które można połączyć i <asp:webpartmanager> element.
Wyjaśnienie działania przykładu w przeglądarce.

Poniższy kod zawiera tylko część strony sieci Web przykładu. Będziesz również potrzebować niestandardowej kontrolki użytkownika i kodu źródłowego dla kontrolek niestandardowych wymienionych powyżej. Uzyskaj te dwa elementy z sekcji Przykład w przeglądzie WebPartManager klasy.

Poniższy kod strony sieci Web przedstawia sposób przypisywania niestandardowego komunikatu ostrzegawczego do CloseProviderWarning właściwości w deklaratywnej adiustacji w elemecie <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 załadowaniu strony sieci Web w przeglądarce kliknij kontrolkę listy rozwijanej Tryb wyświetlania i wybierz pozycję Połącz , aby przełączyć stronę w tryb połączenia. Tryb łączenia używa <asp:connectionszone> elementu , aby umożliwić tworzenie połączeń między kontrolkami. W trybie łączenia kliknij strzałkę w dół na pasku tytułu kontrolki Kod pocztowy , aby aktywować menu czasowników, a następnie kliknij przycisk Połącz. Po pojawieniu się interfejsu użytkownika połączenia kliknij link Utwórz połączenie z użytkownikiem . Zostanie wyświetlona komórka z kontrolką listy rozwijanej. Wybierz pozycję Weather Control (Kontrolka pogody ) z listy rozwijanej, a następnie kliknij przycisk Połącz , aby ukończyć połączenie tych dwóch kontrolek. Kliknij przycisk Zamknij, a następnie użyj listy rozwijanej Tryb wyświetlania , aby zwrócić stronę do normalnego trybu przeglądania. Na koniec kliknij menu czasowników dla kontrolki Kod pocztowy (czyli kontrolka dostawcy w tym przypadku) i wybierz pozycję Zamknij. Zostanie wyświetlony niestandardowy komunikat przypisany do CloseProviderWarning właściwości .

Uwagi

Gdy użytkownik zamknie kontrolkę WebPart , zwykle nie jest wyświetlany żaden komunikat. Aby uzyskać więcej informacji na temat tego, co to znaczy zamknąć kontrolkę, zobacz metodę CloseWebPart .

Jeśli jednak kontrolka jest połączona z inną kontrolką i działa jako dostawca danych do innej kontrolki, podczas próby zamknięcia kontrolki jest wyświetlany domyślny komunikat ostrzegawczy. Komunikat informuje użytkowników, że kontrola dostawcy wkrótce zostanie zamknięta, co oznacza, że kontrolki połączone z tym dostawcą, ponieważ konsumenci nie będą już mieli żadnych danych do korzystania. Właściwość CloseProviderWarning umożliwia deweloperom dostosowanie komunikatu ostrzegawczego wyświetlanego użytkownikowi.

Jeśli deweloper strony przypisze pustą lub null wartość ciągu do tej właściwości, żadne okno komunikatu ostrzegawczego nie będzie wyświetlane, gdy użytkownik zamknie kontrolkę WebPart , która jest dostawcą.

Dotyczy

Zobacz też

kontrolki składników Web Part ASP.NET

Share via