WebPartManager.CloseProviderWarning Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit un avertissement qui s'affiche lorsqu'un utilisateur ferme un contrôle qui agit comme un fournisseur pour les autres contrôles d'une connexion.

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

Valeur de propriété

String

Chaîne qui contient le message d'avertissement. La valeur par défaut est un message spécifique à la culture fourni par le .NET Framework.

Exemples

L’exemple de code suivant montre comment utiliser la CloseProviderWarning propriété pour afficher un avertissement personnalisé aux utilisateurs.

L’exemple de code comporte quatre parties :

Contrôle utilisateur qui vous permet de modifier les modes d’affichage d’une page de composants WebPart.
Fichier de code source qui contient deux contrôles personnalisés WebPart et une interface personnalisée.
Page Web qui contient deux contrôles personnalisés WebPart qui peuvent être connectés et un <asp:webpartmanager> élément.
Explication du fonctionnement de l’exemple dans un navigateur.

Le code suivant contient uniquement la partie page Web de l’exemple. Vous aurez également besoin du contrôle utilisateur personnalisé et du code source pour les contrôles personnalisés mentionnés ci-dessus. Obtenez ces deux éléments à partir de la section Exemple de la vue d’ensemble de la WebPartManager classe.

Le code de page Web suivant montre comment affecter un message d’avertissement personnalisé à la propriété dans le CloseProviderWarning balisage déclaratif dans l’élément <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>

Une fois que vous avez chargé la page Web dans un navigateur, cliquez sur le contrôle de liste déroulante Mode d’affichage , puis sélectionnez Se connecter pour basculer la page en mode connexion. Le mode Connexion utilise l’élément <asp:connectionszone> pour vous permettre de créer des connexions entre les contrôles. En mode connexion, cliquez sur la flèche vers le bas dans la barre de titre du contrôle Code postal pour activer son menu verbes, puis cliquez sur Se connecter. Une fois l’interface utilisateur de connexion affichée, cliquez sur le lien Créer une connexion à un consommateur . Une cellule qui a un contrôle de liste déroulante s’affiche. Sélectionnez Contrôle météo dans la liste déroulante, puis cliquez sur Se connecter pour terminer la connexion des deux contrôles. Cliquez sur Fermer, puis utilisez la liste déroulante Mode d’affichage pour retourner la page en mode de navigation normal. Enfin, cliquez sur le menu verbes du contrôle code postal (qui est le contrôle fournisseur dans ce cas) et sélectionnez Fermer. Le message personnalisé que vous avez affecté à la CloseProviderWarning propriété s’affiche.

Remarques

Lorsqu’un utilisateur ferme un WebPart contrôle, aucun message n’est normalement affiché. Pour plus d’informations sur ce que signifie fermer un contrôle, consultez la CloseWebPart méthode .

Toutefois, lorsqu’un contrôle est connecté à un autre contrôle et qu’il agit en tant que fournisseur de données pour l’autre contrôle, un message d’avertissement par défaut s’affiche lorsqu’un utilisateur tente de fermer le contrôle. Le message indique aux utilisateurs qu’un contrôle fournisseur est sur le point de se fermer, ce qui signifie que les contrôles connectés à ce fournisseur en tant que consommateurs n’auront plus de données à consommer. La CloseProviderWarning propriété permet aux développeurs de personnaliser le message d’avertissement affiché à l’utilisateur.

Si un développeur de pages affecte une valeur de chaîne vide ou null à cette propriété, aucune zone de message d’avertissement ne s’affiche lorsqu’un utilisateur ferme un WebPart contrôle qui est un fournisseur.

S’applique à

Voir aussi

contrôles de composants WebPart ASP.NET

Partager via