Como: estender um nó do SharePoint no Server Explorer

Você pode estender a nós sob o SharePoint Connections nó na Server Explorer.Isso é útil quando você deseja adicionar novos nós filho, itens de menu de atalho ou propriedades para um nó existente.Para obter mais informações, consulte Estendendo o nó de conexões do SharePoint no Server Explorer.

Para estender um nó do SharePoint no Server Explorer

1. Crie um projeto de biblioteca de classe.

2. Adicione referências para os seguintes conjuntos de módulos (assemblies) :

   • Microsoft.VisualStudio.SharePoint

   • Microsoft.VisualStudio.SharePoint.Explorer.Extensions

   • System.ComponentModel.Composition

3. Crie uma nova classe que implemente a interface IExplorerNodeTypeExtension.

4. Adicione o atributo System.ComponentModel.Composition.ExportAttribute à classe.Este atributo permite que Visual Studio descobrir e carregar seu IExplorerNodeTypeExtension implementação.Passar o IExplorerNodeTypeExtension tipo para o construtor de atributo.

5. Adicione o atributo ExplorerNodeTypeAttribute à classe.Este atributo especifica o identificador de seqüência de caracteres para o tipo de nó que você deseja estender.

   Para especificar os tipos de nó internos fornecidos pelo Visual Studio, passe um dos seguintes valores de enumeração para o construtor de atributo:

   • ExplorerNodeTypes: Usar esses valores para especificar nós de conexão do site (os nós que exibem os URLs do site), de nós ou todos os outros nós pai no site Server Explorer.

   • ExtensionNodeTypes: Use esses valores para especificar um de nós internos que representam um componente individual em um site do SharePoint, como, por exemplo, um nó que representa uma lista, campo ou tipo de conteúdo.

6. Na sua implementação da IExplorerNodeTypeExtension.Initialize método, o uso de membros da nodeType parâmetro para adicionar recursos ao nó.Este parâmetro é um IExplorerNodeType que fornece acesso para os eventos definidos no objeto do IExplorerNodeEvents interface.Por exemplo, você pode manipular os eventos a seguintes:

   • IExplorerNodeEvents.NodeChildrenRequested: Manipule esse evento para adicionar novos nós filho ao nó.Para obter mais informações, consulte Como: adicionar um nó do SharePoint personalizado ao Server Explorer.

   • IExplorerNodeEvents.NodeMenuItemsRequested: Manipule esse evento para adicionar um item de menu de atalho personalizado para o nó.

   • IExplorerNodeEvents.NodePropertiesRequested: Manipule esse evento para adicionar propriedades personalizadas para o nó.As propriedades aparecem na Propriedades janela quando o nó é selecionado.

Exemplo

O exemplo de código a seguir demonstra como criar dois tipos diferentes de extensões do nó:

• Uma extensão que adiciona um item de menu de contexto para nós de site do SharePoint.Quando você clica no item de menu, ele exibe o nome do nó que foi clicado.

• Uma extensão que adiciona uma propriedade personalizada chamada ContosoExampleProperty para cada nó que representa um campo chamado corpo.

Imports System.ComponentModel
Imports System.ComponentModel.Composition
Imports System.Windows.Forms
Imports Microsoft.VisualStudio.SharePoint
Imports Microsoft.VisualStudio.SharePoint.Explorer
Imports Microsoft.VisualStudio.SharePoint.Explorer.Extensions

Namespace Contoso.ServerExplorerExtension
    <Export(GetType(IExplorerNodeTypeExtension))> _
    <ExplorerNodeType(ExplorerNodeTypes.SiteNode)> _
    Friend Class SiteNodeExtensionWithContextMenu
        Implements IExplorerNodeTypeExtension

        Private Sub Initialize(ByVal nodeType As IExplorerNodeType) _
            Implements IExplorerNodeTypeExtension.Initialize
            AddHandler nodeType.NodeMenuItemsRequested, AddressOf NodeMenuItemsRequested
        End Sub

        Private Sub NodeMenuItemsRequested(ByVal Sender As Object, ByVal e As ExplorerNodeMenuItemsRequestedEventArgs)
            Dim menuItem = e.MenuItems.Add("Display Message")
            AddHandler menuItem.Click, AddressOf MenuItemClick
        End Sub

        Private Sub MenuItemClick(ByVal Sender As Object, ByVal e As MenuItemEventArgs)
            Dim node As IExplorerNode = CType(e.Owner, IExplorerNode)
            MessageBox.Show(String.Format("Clicked the menu item for the '{0}' node.", node.Text))
        End Sub
    End Class

    <Export(GetType(IExplorerNodeTypeExtension))> _
    <ExplorerNodeType(ExtensionNodeTypes.FieldNode)> _
    Friend Class FieldNodeExtensionWithProperty
        Implements IExplorerNodeTypeExtension

        Private Sub Initialize(ByVal nodeType As IExplorerNodeType) _
            Implements IExplorerNodeTypeExtension.Initialize
            AddHandler nodeType.NodePropertiesRequested, AddressOf NodePropertiesRequested
        End Sub

        Private Sub NodePropertiesRequested(ByVal Sender As Object, ByVal e As ExplorerNodePropertiesRequestedEventArgs)
            Dim propertyObject As ExampleProperty = Nothing

            ' Only add the property to "Body" fields.
            If e.Node.Text = "Body" Then
                ' If the properties object already exists for this node, get it from the node's annotations.
                If False = e.Node.Annotations.TryGetValue(propertyObject) Then
                    ' Otherwise, create a new properties object and add it to the annotations.
                    propertyObject = New ExampleProperty(e.Node)
                    e.Node.Annotations.Add(propertyObject)
                End If
                e.PropertySources.Add(propertyObject)
            End If
        End Sub
    End Class

    Friend Class ExampleProperty

        Private node As IExplorerNode
        Private Const propertyId As String = "Contoso.CustomActionTestProperty"
        Private Const propertyDefaultValue As String = "This is a test value."

        Friend Sub New(ByVal node As IExplorerNode)
            Me.node = node
        End Sub

        ' Gets or sets a simple string property. 
        <DisplayName("ContosoExampleProperty")> _
        <DescriptionAttribute("This is an example property for field nodes.")> _
        <DefaultValue(propertyDefaultValue)> _
        Public Property TestProperty As String
            Get
                Dim propertyValue As String = Nothing

                ' Get the current property value if it already exists; otherwise, return a default value.
                If False = node.Annotations.TryGetValue(propertyId, propertyValue) Then
                    propertyValue = propertyDefaultValue
                End If
                Return propertyValue
            End Get
            Set(ByVal value As String)
                If value <> propertyDefaultValue Then
                    ' Store the property value in the Annotations property of the node. 
                    ' Data in the Annotations property does not persist when Visual Studio exits.
                    node.Annotations(propertyId) = value
                Else
                    ' Do not save the default value.
                    node.Annotations.Values.Remove(propertyId)
                End If
            End Set
        End Property
    End Class
End Namespace

using System.ComponentModel;
using System.ComponentModel.Composition;
using System.Windows.Forms;
using Microsoft.VisualStudio.SharePoint;
using Microsoft.VisualStudio.SharePoint.Explorer;
using Microsoft.VisualStudio.SharePoint.Explorer.Extensions;

namespace Contoso.ServerExplorerExtension
{
    [Export(typeof(IExplorerNodeTypeExtension))]
    [ExplorerNodeType(ExplorerNodeTypes.SiteNode)]
    internal class SiteNodeExtensionWithContextMenu : IExplorerNodeTypeExtension
    {
        public void Initialize(IExplorerNodeType nodeType)
        {
            nodeType.NodeMenuItemsRequested += nodeType_NodeMenuItemsRequested;
        }

        void nodeType_NodeMenuItemsRequested(object sender, ExplorerNodeMenuItemsRequestedEventArgs e)
        {
            IMenuItem menuItem = e.MenuItems.Add("Display Message");
            menuItem.Click += menuItem_Click;
        }

        void menuItem_Click(object sender, MenuItemEventArgs e)
        {
            IExplorerNode node = (IExplorerNode)e.Owner;
            MessageBox.Show(string.Format("Clicked the menu item for the '{0}' node.", node.Text));
        }
    }

    [Export(typeof(IExplorerNodeTypeExtension))]
    [ExplorerNodeType(ExtensionNodeTypes.FieldNode)]
    internal class FieldNodeExtensionWithProperty : IExplorerNodeTypeExtension
    {
        public void Initialize(IExplorerNodeType nodeType)
        {
            nodeType.NodePropertiesRequested += nodeType_NodePropertiesRequested;
        }

        void nodeType_NodePropertiesRequested(object sender, ExplorerNodePropertiesRequestedEventArgs e)
        {
            // Only add the property to "Body" fields.
            if (e.Node.Text == "Body")
            {
                ExampleProperty propertyObject;

                // If the properties object already exists for this node, get it from the node's annotations.
                if (!e.Node.Annotations.TryGetValue(out propertyObject))
                {
                    // Otherwise, create a new properties object and add it to the annotations.
                    propertyObject = new ExampleProperty(e.Node);
                    e.Node.Annotations.Add(propertyObject);
                }

                e.PropertySources.Add(propertyObject);
            }
        }
    }

    internal class ExampleProperty
    {
        private IExplorerNode node;
        private const string propertyId = "Contoso.ExampleProperty";
        private const string propertyDefaultValue = "This is an example property.";

        internal ExampleProperty(IExplorerNode node)
        {
            this.node = node;
        }

        // Gets or sets a simple string property. 
        [DisplayName("ContosoExampleProperty")]
        [DescriptionAttribute("This is an example property for field nodes.")]
        [DefaultValue(propertyDefaultValue)]
        public string TestProperty
        {
            get
            {
                string propertyValue;

                // Get the current property value if it already exists; otherwise, return a default value.
                if (!node.Annotations.TryGetValue(propertyId, out propertyValue))
                {
                    propertyValue = propertyDefaultValue;
                }
                return propertyValue;
            }
            set
            {
                if (value != propertyDefaultValue)
                {
                    // Store the property value in the Annotations property of the node. 
                    // Data in the Annotations property does not persist when Visual Studio exits.
                    node.Annotations[propertyId] = value;
                }
                else
                {
                    // Do not save the default value.
                    node.Annotations.Remove(propertyId);
                }
            }
        }
    }

}

Essa extensão adiciona uma propriedade de seqüência de caracteres editável para nós.Você também pode criar propriedades personalizadas que exibam dados somente leitura de servidor do SharePoint.Para obter um exemplo que demonstra como fazer isso, consulte Passo a passo: Estendendo o Server Explorer para exibir Web Parts.

Compilando o código

Este exemplo requer referências aos assemblies seguintes:

• Microsoft.VisualStudio.SharePoint

• Microsoft.VisualStudio.SharePoint.Explorer.Extensions

• System.ComponentModel.Composition

• System.Windows.Forms

Implantação da extensão

Para implantar o Server Explorer extensão, criar um Visual Studio (VSIX) da extensão do pacote para o assembly e outros arquivos que você deseja distribuir com a extensão.Para obter mais informações, consulte Implantação de extensões para as ferramentas de SharePoint no Visual Studio.

Consulte também

Tarefas

Passo a passo: Estendendo o Server Explorer para exibir Web Parts

Conceitos

Como: adicionar um nó do SharePoint personalizado ao Server Explorer

A associação de dados personalizados com extensões de ferramentas do SharePoint

Outros recursos

Estendendo o nó de conexões do SharePoint no Server Explorer