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 sur une page 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 Example 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 un 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 et sélectionnez Connecter pour basculer la page en mode connexion. Connecter mode 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 Connecter. Une fois que l’interface utilisateur de connexion s’affiche, cliquez sur le lien Créer une connexion à un consommateur. Une cellule apparaît avec un contrôle de liste déroulante. Sélectionnez Contrôle météo dans la liste déroulante, puis cliquez sur 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 qu’il signifie pour 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 à 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, car les 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 boîte 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 ASP.NET composants WebPart

Partager via