WebPartManager.DeleteWebPart メソッドとは何？わかりやすく解説 Weblio辞書

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

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

WebPartManager.DeleteWebPart メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

WebPart コントロールの動的インスタンスを Web ページから完全に削除します。

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

Visual Basic (宣言)

Public Sub DeleteWebPart ( _
    webPart As WebPart _
)

Visual Basic (使用法)

Dim instance As WebPartManager
Dim webPart As WebPart

instance.DeleteWebPart(webPart)

public void DeleteWebPart (
    WebPart webPart
)

C++

public:
void DeleteWebPart (
    WebPart^ webPart
)

public void DeleteWebPart (
    WebPart webPart
)

JScript

public function DeleteWebPart (
    webPart : WebPart
)

パラメータ

webPart: 削除するサーバーコントロール。

解説

DeleteWebPart メソッドは、webPart パラメータで表されたコントロールをページから完全に削除します。PageCatalogPart コントロールに追加し、後でページに戻すことができるコントロールの終了とは異なり、削除されたコントロールのインスタンスはページに戻すことができません。

メモ
動的な WebPart コントロールは Web パーツコントロールセットによって実装されているため、ユーザーがこれを削除できるかどうかは、ページにそのコントロールを追加したときのユーザーとパーソナル化スコープに応じて異なります。ページが共有スコープにあるときにアクセス許可を持ったユーザーがコントロールを追加した場合、ページがユーザースコープにあるときに個別のユーザーがそのコントロールを削除することはできません。

メモ

動的な WebPart コントロールは Web パーツコントロールセットによって実装されているため、ユーザーがこれを削除できるかどうかは、ページにそのコントロールを追加したときのユーザーとパーソナル化スコープに応じて異なります。ページが共有スコープにあるときにアクセス許可を持ったユーザーがコントロールを追加した場合、ページがユーザースコープにあるときに個別のユーザーがそのコントロールを削除することはできません。

削除できるのはダイナミックコントロールだけです。ダイナミックコントロールは、プログラムでページに追加するか、またはユーザーがカタログから追加します。スタティックコントロールは、マークアップのページ宣言または永続形式でページに追加します。宣言タグはマークアップに永続的に存在するため、スタティックコントロールは削除できませんが、これらを閉じて再び開くことはできます。

使用例

DeleteWebPart メソッドを使用する方法を次のコード例に示します。最初に [Add Calendar] をクリックしたときに、イベントハンドラのコードが Calendar コントロールを作成し、それを GenericWebPart オブジェクトとしてゾーンに追加します。このコントロールはプログラムで追加されるダイナミックコントロールであるため、これを削除できます。ユーザーが [Delete Calendar] をクリックすると、このコードはコントロールが存在することを確認してから、DeleteWebPart メソッドを呼び出してこのコントロールを削除します。

Visual Basic

<%@ Page Language="vb" %>

<script runat="server">

  Protected Sub Button2_Click(ByVal
 sender As Object, _
    ByVal e As System.EventArgs)
    Dim mgr As WebPartManager = WebPartManager1
    Dim cal As New Calendar()
    cal.ID = "cal1"
    Dim calWebPart As GenericWebPart = mgr.CreateWebPart(cal)
    mgr.AddWebPart(calWebPart, WebPartZone1, 1)
  End Sub

  Protected Sub Button1_Click(ByVal
 sender As Object, _
    ByVal e As System.EventArgs)

    If WebPartZone1.WebParts.Count > 1 Then
      Dim cal As WebPart = WebPartZone1.WebParts(1)
      If cal.Controls(0).GetType().Name = "Calendar"
 AndAlso _
        cal IsNot Nothing Then
        WebPartManager1.DeleteWebPart(cal)
      End If
    End If
  End Sub
</script>

<html  >
<head id="Head1" runat="server">
    <title>Adding a Server Control</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1"
 
        runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList  
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server"
 
        Text="Delete Calendar" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server"
 
        Text="Add Calendar" 
        OnClick="Button2_Click" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="C#" %>

<script runat="server">

  protected void Button2_Click(object sender,
 EventArgs e)
  {
    WebPartManager mgr = WebPartManager1;
    Calendar cal = new Calendar();
    cal.ID = "cal1";
    GenericWebPart calWebPart = mgr.CreateWebPart(cal);
    mgr.AddWebPart(calWebPart, WebPartZone1, 1);
  }

  protected void Button1_Click(object sender,
 EventArgs e)
  {
    if (WebPartZone1.WebParts.Count > 1)
    {
      WebPart cal = WebPartZone1.WebParts[1];
      if (cal.Controls[0].GetType().Name == "Calendar"
 
        && cal != null)
        WebPartManager1.DeleteWebPart(cal);
    }

  }
</script>

<html  >
<head runat="server">
    <title>Adding a Server Control</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="WebPartManager1" 
        runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList  
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:Button ID="Button1" runat="server" 
        Text="Delete Calendar" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Add Calendar" 
        OnClick="Button2_Click" />
    </div>
    </form>
</body>
</html>

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

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

>> 「WebPartManager.DeleteWebPart メソッド」を含む用語の索引
WebPartManager.DeleteWebPart メソッドのページへのリンク

WebPartManager.DeleteWebPart メソッドとは？わかりやすく解説

WebPartManager.DeleteWebPart メソッド

「WebPartManager.DeleteWebPart メソッド」の関連用語


	© 2024 Microsoft.All rights reserved.

WebPartManager.DeleteWebPart メソッドとは？ わかりやすく解説

WebPartManager.DeleteWebPart メソッド

急上昇のことば

「WebPartManager.DeleteWebPart メソッド」の関連用語

WebPartManager.DeleteWebPart メソッドとは？わかりやすく解説