WebPartManager.DeleteWebPart(WebPart) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Quita permanentemente una instancia dinámica de un control WebPart de una página Web.
public:
void DeleteWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);public void DeleteWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart);member this.DeleteWebPart : System.Web.UI.WebControls.WebParts.WebPart -> unitPublic Sub DeleteWebPart (webPart As WebPart)Parámetros
- webPart
- WebPart
Control de servidor que se va a eliminar.
Ejemplos
En el ejemplo de código siguiente se muestra cómo utilizar el método DeleteWebPart. La primera vez que se hace clic en el botón Agregar calendario , el código del controlador de eventos crea un Calendar control y lo agrega a una zona como un GenericWebPart objeto . Dado que el control se agrega mediante programación, es un control dinámico y, por tanto, se puede eliminar. Cuando un usuario hace clic en el botón Eliminar calendario , el código garantiza que el control existe y, a continuación, lo elimina llamando al DeleteWebPart método .
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 xmlns="http://www.w3.org/1999/xhtml" >
<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>
<%@ Page Language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 xmlns="http://www.w3.org/1999/xhtml" >
<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>
Comentarios
El DeleteWebPart método quita permanentemente el control representado por el webPart parámetro de una página. A diferencia de un control cerrado, que se agrega al PageCatalogPart control y se puede volver a agregar a la página, una instancia de control eliminada nunca se puede volver a agregar a la página.
Nota
Según lo implementado por el conjunto de controles de elementos web, la capacidad de los usuarios de eliminar un control dinámico WebPart depende del usuario y del ámbito de personalización en el que se agregó el control a una página. Si el control se agrega cuando la página está en el ámbito compartido (por un usuario que tiene permisos), los usuarios individuales no pueden eliminar el control cuando la página está en el ámbito del usuario.
Solo se pueden eliminar controles dinámicos. Los controles dinámicos se agregan a una página mediante programación o los usuarios que agregan controles de un catálogo. Los controles estáticos se agregan a una página mediante declaración en el formato de marcado o persistencia. Dado que las etiquetas declarativas están presentes permanentemente en el marcado, los controles estáticos nunca se pueden eliminar, pero se pueden cerrar y volver a abrir.
