WebPart class
Fornece a classe base para a criação de Microsoft SharePoint Foundation Web Parts.
Inheritance hierarchy
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Panel
System.Web.UI.WebControls.WebParts.Part
System.Web.UI.WebControls.WebParts.WebPart
Microsoft.SharePoint.WebPartPages.WebPart
Namespace: Microsoft.SharePoint.WebPartPages
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
<SupportsAttributeMarkupAttribute(False)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public MustInherit Class WebPart _
Inherits WebPart _
Implements INamingContainer, IAttributeAccessor, IConnectionData
'Uso
Dim instance As WebPart
[SupportsAttributeMarkupAttribute(false)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public abstract class WebPart : WebPart,
INamingContainer, IAttributeAccessor, IConnectionData
Comentários
A infra-estrutura de Web Part SharePoint Foundation é projetada e desenvolvida para se encontram na parte superior da infra-estrutura de Web Part Microsoft ASP.NET. Web Parts que herdam WebPart totalmente suportados no Microsoft SharePoint Foundation (com exceção dos controles de usuário, como Web Parts genérico) e podem ser usados não apenas nos aplicativos ASP.NET, mas também em aplicativos SharePoint Foundation, se SharePoint Foundation está envolvido ou não. A classe deWebPartSharePoint Foundation é parte de uma infraestrutura que foi projetada especificamente para sites do SharePoint e Web Parts que herdam dessa classe pode ser usadas somente em sites do SharePoint.
When creating new Web Parts, you have the option of creating Web Parts that inherit from System.Web.UI.WebControls.WebParts.WebPart (recommended) or Microsoft.SharePoint.WebPartPages.WebPart. The SharePoint FoundationWebPart class exists primarily for the purpose of backward compatibility and to provide a small set of features that are not available in the System.Web.UI.WebControls.WebParts.WebPart class.
O conjunto de recursos fornecidos exclusivamente por Microsoft.SharePoint.WebPartPages.WebPart é da seguinte maneira:
Entre as conexões de página
Conexões entre Web Parts que estão fora de uma zona
Conexões de cliente (Web Part página Component Services)
Cache de infra-estrutura, incluindo a capacidade de cache ao banco de dados
For more information, see Windows SharePoint Services and Web Parts.
Examples
The following code example shows a simple Web Part that contains HtmlButton and HtmlInputText controls that allow the user to change the Web Part's Title property. For a step-by-step walkthrough of creating this Web Part, see Walkthrough: Creating a Basic SharePoint Web Part.
Imports System
Imports System.ComponentModel
Imports System.Runtime.InteropServices
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Xml.Serialization
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.WebPartPages
Imports Microsoft.SharePoint.Utilities
Imports System.Web.UI.HtmlControls
Namespace WebPartLibrary1
' This Web Part changes it's own title and implements a custom property.
<XmlRoot([Namespace] := "WebPartLibrary1")> _
Public Class SimpleWebPart
Inherits WebPart
Private Const defaultText As String = "hello"
Private [text] As String = defaultText
' Declare variables for HtmlControls user interface elements.
Private _mybutton As HtmlButton
Private _mytextbox As HtmlInputText
' Event handler for _mybutton control that sets the
' Title property to the value in _mytextbox control.
Public Sub _mybutton_click(sender As Object, e As EventArgs)
Me.Title = _mytextbox.Value
Try
Me.SaveProperties = True
Catch Else
Caption = "Error... Could not save property."
End Try
End Sub
' Override the ASP.NET Web.UI.Controls.CreateChildControls
' method to create the objects for the Web Part's controls.
Protected Overrides Sub CreateChildControls()
' Create _mytextbox control.
_mytextbox = New HtmlInputText()
_mytextbox.Value = ""
Controls.Add(_mytextbox)
' Create _mybutton control and wire its event handler.
_mybutton = New HtmlButton()
_mybutton.InnerText = "Set Web Part Title"
AddHandler _mybutton.ServerClick, AddressOf _mybutton_click
Controls.Add(_mybutton)
End Sub
<Browsable(True), Category("Miscellaneous"), DefaultValue(defaultText), WebPartStorage(Storage.Personal), FriendlyName("Text"), Description("Text Property")> _
Public Property [Text]() As String
Get
Return [text]
End Get
Set
[text] = value
End Set
End Property
Protected Overrides Sub RenderWebPart(output As HtmlTextWriter)
RenderChildren(output)
' Securely write out HTML
output.Write(("<BR>Text Property: " + SPEncode.HtmlEncode([Text])))
End Sub
End Class
End Namespace
//--------------------------------------------------------------------
// File: SimpleWebPart.cs
//
// Purpose: A sample Web Part that demonstrates how to create a basic
// Web Part.
//--------------------------------------------------------------------
using System;
using System.ComponentModel;
using System.Runtime.InteropServices;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Xml.Serialization;
using Microsoft.SharePoint;
using Microsoft.SharePoint.WebPartPages;
using Microsoft.SharePoint.Utilities;
using System.Web.UI.HtmlControls;
namespace WebPartLibrary1
{
/// <summary>
/// This Web Part changes its title and implements a custom property.
/// </summary>
[XmlRoot(Namespace="WebPartLibrary1")]
public class SimpleWebPart : WebPart
{
private const string defaultText = "hello";
private string text=defaultText;
// Declare variables for HtmlControls user interface elements.
HtmlButton _mybutton;
HtmlInputText _mytextbox;
// Event handler for _mybutton control that sets the
// Title property to the value in _mytextbox control.
public void _mybutton_click (object sender, EventArgs e)
{
this.Title = _mytextbox.Value;
try
{
this.SaveProperties=true;
}
catch
{
Caption = "Error... Could not save property.";
}
}
// Override the ASP.NET Web.UI.Controls.CreateChildControls
// method to create the objects for the Web Part's controls.
protected override void CreateChildControls ()
{
// Create _mytextbox control.
_mytextbox = new HtmlInputText();
_mytextbox.Value="";
Controls.Add(_mytextbox);
// Create _mybutton control and wire its event handler.
_mybutton = new HtmlButton();
_mybutton.InnerText = "Set Web Part Title";
_mybutton.ServerClick += new EventHandler (_mybutton_click);
Controls.Add (_mybutton);
}
[Browsable(true),Category("Miscellaneous"),
DefaultValue(defaultText),
WebPartStorage(Storage.Personal),
FriendlyName("Text"),Description("Text Property")]
public string Text
{
get
{
return text;
}
set
{
text = value;
}
}
protected override void RenderWebPart(HtmlTextWriter output)
{
RenderChildren(output);
// Securely write out HTML
output.Write("<BR>Text Property: " + SPEncode.HtmlEncode(Text));
}
}
}
Thread safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Ver também
Referência
Microsoft.SharePoint.WebPartPages namespace
Inheritance hierarchy
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Panel
System.Web.UI.WebControls.WebParts.Part
System.Web.UI.WebControls.WebParts.WebPart
Microsoft.SharePoint.WebPartPages.WebPart
Microsoft.SharePoint.WebControls.ApplicationAssociationsViewWebPart
Microsoft.SharePoint.WebControls.TopologyViewWebPart
Microsoft.SharePoint.WebPartPages.AccessRequestsHideOldRequestsLink
Microsoft.SharePoint.WebPartPages.AccessRequestsHideOldRequestsOnLoad
Microsoft.SharePoint.WebPartPages.AggregationWebPart
Microsoft.SharePoint.WebPartPages.BaseXsltDataWebPart
Microsoft.SharePoint.WebPartPages.BlogAdminWebPart
Microsoft.SharePoint.WebPartPages.BlogLinksWebPart
Microsoft.SharePoint.WebPartPages.BlogMonthQuickLaunch
Microsoft.SharePoint.WebPartPages.ChartViewWebPart
Microsoft.SharePoint.WebPartPages.ContentEditorWebPart
Microsoft.SharePoint.WebPartPages.ImageWebPart
Microsoft.SharePoint.WebPartPages.ListFormWebPart
Microsoft.SharePoint.WebPartPages.ListViewWebPart
Microsoft.SharePoint.WebPartPages.MembersWebPart
Microsoft.SharePoint.WebPartPages.PageViewerWebPart
Microsoft.SharePoint.WebPartPages.SimpleFormWebPart
Microsoft.SharePoint.WebPartPages.SPTimelineWebPart
Microsoft.SharePoint.WebPartPages.TilesViewWebPart
Microsoft.SharePoint.WebPartPages.TitleBarWebPart
Microsoft.SharePoint.WebPartPages.WikiContentWebpart
Microsoft.SharePoint.WebPartPages.XmlWebPart