Kojarzenie danych niestandardowych z rozszerzeniami narzędzi SharePoint

Do niektórych obiektów w rozszerzeniach narzędzia programu SharePoint, można dodać niestandardowe dane.Jest to przydatne, gdy dane w jednej części sieci rozszerzenia, które chcesz później dostęp z innego kodu programu rozszerzenia.Zamiast stosowania niestandardowych sposobem przechowywania i uzyskać dostęp do danych, można skojarzyć dane z obiektu użytkownika rozszerzenia i następnie pobrać dane z tego samego obiektu później.

Dodawanie niestandardowych danych do obiektów jest także przydatna, gdy chcesz zachować dane, które są istotne dla określonego towaru w Visual Studio.Rozszerzenia narzędzi programu SharePoint są ładowane tylko raz w programie Visual Studio, tak Twój numer wewnętrzny może działać z kilku różnych elementów (takich jak projektów, projektów elementy, lub Server Explorer węzłów) w dowolnym momencie.Jeśli niestandardowe dane, które jest istotne tylko dla określonego towaru, można dodać dane do obiektu, który reprezentuje tego elementu.

Dane nie utrzymują się po dodaniu niestandardowych danych do obiektów w rozszerzeniach narzędzia programu SharePoint.Dane są dostępne tylko w okresie eksploatacji obiektu.Po obiekcie jest odzyskane w procesie wyrzucania elementów bezużytecznych, dane zostaną utracone.

W rozszerzenia systemu projektu programu SharePoint można też zapisywać dane ciągu, który pozostawałby po rozszerzenie jest zwolniony.Aby uzyskać więcej informacji, zobacz Zapisywanie danych w rozszerzeniach systemu projektu SharePoint.

Obiekty, które mogą zawierać niestandardowe dane

Niestandardowe dane można dodać do dowolnego obiektu w modelu obiektów programu SharePoint narzędzi, który implementuje IAnnotatedObject interfejsu.Ten interfejs definiuje tylko jedną właściwość, Annotations, która jest kolekcją obiektów niestandardowych danych.Wdrożenie następujących typów IAnnotatedObject:

• IMappedFolder

• IMenuItem

• ISharePointProject

• ISharePointProjectFeature

• ISharePointProjectFeatureResourceFile

• ISharePointProjectItem

• ISharePointProjectItemFile

• ISharePointProjectItemType

• ISharePointProjectItemTypeDefinition

• ISharePointProjectMember

• ISharePointProjectPackage

• IDeploymentContext

• IExplorerNode

• IExplorerNodeType

• IExplorerNodeTypeDefinition

Dodawanie i pobierania danych niestandardowych

Aby dodać niestandardowe dane do obiektu w rozszerzeniu narzędzia programu SharePoint, należy uzyskać Annotations właściwości obiektu, które chcesz dodać dane do, a następnie użyj IAnnotationDictionary.Add metodę, aby dodać dane do obiektu.

Aby pobrać dane niestandardowe z obiektu, rozszerzenia narzędzi programu SharePoint, należy uzyskać Annotations właściwości obiektu i użyć jednej z następujących metod:

• IAnnotationDictionary.TryGetValue.Ta metoda zwraca true , jeśli istnieje obiekt danych, lub false , jeśli nie istnieje.Ta metoda służy do pobierania wystąpień typów wartości lub odwołania.

• IAnnotationDictionary.GetValue.Ta metoda zwraca dane obiektu, jeśli kończy pracę, lub null , jeśli nie istnieje.Tej metody można użyć tylko do pobierania wystąpień typów odwołań.

Poniższy przykład kodu Określa, czy obiekt danych jest już skojarzone z elementem projektu.Jeśli obiekt danych nie jest już skojarzone z elementem projektu, a następnie kod dodaje obiekt do Annotations właściwość elementu projektu.Aby wyświetlić ten przykład w kontekście przykład większych, zobacz Porady: dodawanie właściwości do niestandardowego typu elementu projektu SharePoint.

Private Sub ProjectItemPropertiesRequested(ByVal Sender As Object,
    ByVal e As SharePointProjectItemPropertiesRequestedEventArgs)
    Dim propertyObject As CustomProperties = Nothing 

    ' If the properties object already exists, get it from the project item's annotations. 
    If False = e.ProjectItem.Annotations.TryGetValue(propertyObject) Then 
        ' Otherwise, create a new properties object and add it to the annotations.
        propertyObject = New CustomProperties(e.ProjectItem)
        e.ProjectItem.Annotations.Add(propertyObject)
    End If
    e.PropertySources.Add(propertyObject)
End Sub

void projectItemTypeDefinition_ProjectItemPropertiesRequested(object sender, 
    SharePointProjectItemPropertiesRequestedEventArgs e)
{
    CustomProperties property;

    // If the properties object already exists, get it from the project item's annotations. 
    if (!e.ProjectItem.Annotations.TryGetValue(out property))
    {
        // Otherwise, create a new properties object and add it to the annotations.
        property = new CustomProperties(e.ProjectItem);
        e.ProjectItem.Annotations.Add(property);
    }

    e.PropertySources.Add(property);
}

Zobacz też

Zadania

Wskazówki: tworzenie niestandardowej akcji elementu projektu z Szablonem elementu, Część 1

Wskazówki: rozszerzanie Eksploratora serwera do potrzeb wyświetlania elementów sieci web

Koncepcje

Koncepcje programowania oraz funkcje dla rozszerzeń narzędzi SharePoint

Porady: dodawanie właściwości do projektów SharePoint

Porady: dodawanie właściwości do niestandardowego typu elementu projektu SharePoint