Kojarzenie danych niestandardowy z rozszerzeniami narzędzia programu SharePoint

Artykuł
02/27/2013

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 programu 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:

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 Jak: Dodawanie właściwości do niestandardowy typ elementu projektu programu 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

Instruktaż: Tworzenie elementu projektu działania niestandardowe z szablonu elementu, część 1

Instruktaż: Rozszerzanie Server Explorer do wyświetlania składników Web Part

Koncepcje

Pojęcia związane z programowaniem i funkcje służące do rozszerzenia narzędzi programu SharePoint

Jak: Dodawanie właściwości do projektów programu SharePoint

Jak: Dodawanie właściwości do niestandardowy typ elementu projektu programu SharePoint

Udostępnij za pośrednictwem