WebPartManager.CloseProviderWarning プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebPartManager.CloseProviderWarning プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

接続で他のコントロールに対するプロバイダとして動作しているコントロールをユーザーが終了すると表示される警告を取得または設定します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 CloseProviderWarning As String

Visual Basic (使用法)

Dim instance As WebPartManager
Dim value As String

value = instance.CloseProviderWarning

instance.CloseProviderWarning = value

public virtual string CloseProviderWarning
 { get; set; }

C++

public:
virtual property String^ CloseProviderWarning {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_CloseProviderWarning ()

/** @property */
public void set_CloseProviderWarning (String
 value)

JScript

public function get CloseProviderWarning
 () : String

public function set CloseProviderWarning
 (value : String)

プロパティ値
警告メッセージが含まれた文字列。既定値は、.NET Framework が提供するカルチャ固有のメッセージです。

解説

ユーザーが WebPart コントロールを終了しても、通常、メッセージは表示されません。コントロールを終了する操作の意味の詳細については、CloseWebPart メソッドのトピックを参照してください。

ただし、コントロールが別のコントロールに接続され、別のコントロールに対するデータのプロバイダとして動作している場合は、ユーザーがコントロールを終了しようとすると既定の警告メッセージが表示されます。このメッセージは、プロバイダコントロールを現在終了中のため、このプロバイダにコンシューマとして接続しているコントロールは、使用するデータを取得できなくなることをユーザーに通知します。CloseProviderWarning プロパティを使用すると、開発者はユーザーに表示する警告メッセージをカスタマイズできます。

ページの開発者がこのプロパティに空の値または null 文字列値を割り当てると、プロバイダとして動作する WebPart コントロールをユーザーが終了するときに警告メッセージボックスは表示されません。

使用例

CloseProviderWarning プロパティを使用して、ユーザーにカスタム警告を表示する方法のコード例を次に示します。

コード例は、次の 4 つの部分から成ります。

Web パーツページ上の表示モードを変更できるユーザーコントロール。
2 つのカスタム WebPart コントロールおよび 1 つのカスタムインターフェイスが含まれたソースコードファイル。
接続できる 2 つのカスタム WebPart コントロールおよび 1 つの <asp:webpartmanager> 要素が含まれた Web ページ。
ブラウザにおけるコード例の動作の説明。

次のコードには、コード例の Web ページ部分のみが含まれています。上で説明したカスタムユーザーコントロールとカスタムコントロール用のソースコードも必要になります。WebPartManager クラスの概要の「例」からこれら 2 つのアイテムを取得してください。

<asp:webpartmanager> 要素の宣言マークアップにある CloseProviderWarning プロパティにカスタム警告メッセージを割り当てる方法を、次の Web ページコードに示します。

Visual Basic

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls"
 
  Assembly="ConnectionSampleVB"
 %>

<html  >
<head id="Head1" runat="server">
</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>

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<html  >
<head id="Head1" runat="server">
</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>

ブラウザに Web ページを読み込んだ後、[Display Mode] ドロップダウンリストコントロールをクリックし、[接続] を選択してページを接続モードに切り替えます。接続モードは、<asp:connectionszone> 要素を使用して、コントロールの間に接続を作成できるようにします。接続モードで、[ZIP Code] コントロールのタイトルバーにある下向きの矢印をクリックしてその動詞メニューをアクティブにし、[接続] をクリックします。接続ユーザーインターフェイス (UI) が表示されたら、[コンシューマへの接続の作成] リンクをクリックします。ドロップダウンリストコントロールを持つセルが表示されます。ドロップダウンリストの [Weather Control] を選択し、[接続] をクリックして 2 つのコントロールの接続を確立します。[閉じる] をクリックし、[Display Mode] ドロップダウンリストを使用してページを通常のブラウズモードに戻します。最後に、[ZIP Code] コントロール (この場合はプロバイダコントロールのコントロール) の動詞メニューをクリックし、[閉じる] を選択します。CloseProviderWarning プロパティに割り当てたカスタムメッセージが表示されます。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartManager クラス
WebPartManager メンバ
System.Web.UI.WebControls.WebParts 名前空間
その他の技術情報
ASP.NET Web パーツページ

このページでは「.NET Framework クラスライブラリリファレンス」からWebPartManager.CloseProviderWarning プロパティを検索した結果を表示しています。
Weblioに収録されているすべての辞書からWebPartManager.CloseProviderWarning プロパティを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からWebPartManager.CloseProviderWarning プロパティを検索

>> 「WebPartManager.CloseProviderWarning プロパティ」を含む用語の索引
WebPartManager.CloseProviderWarning プロパティのページへのリンク


	© 2025 Microsoft.All rights reserved.

WebPartManager.CloseProviderWarning プロパティとは？ わかりやすく解説

WebPartManager.CloseProviderWarning プロパティ

急上昇のことば

WebPartManager.CloseProviderWarning プロパティとは？わかりやすく解説